CompatibilityOptions

CompatibilityOptions class

Contient des options de compatibilité (c’est-à-dire les préférences utilisateur saisies sur leCompatibilité onglet duOptions dialogue dans Microsoft Word).

Pour en savoir plus, visitez leDétecter le format de fichier et vérifier la compatibilité des formats article de documentation.

public class CompatibilityOptions

Propriétés

NomLa description
AdjustLineHeightInTable { get; set; }Ajouter un pas de ligne de grille de document aux lignes dans les cellules du tableau.
AlignTablesRowByRow { get; set; }Aligner les lignes du tableau indépendamment.
AllowSpaceOfSameStyleInTable { get; set; }Autoriser l’espacement contextuel des paragraphes dans les tableaux.
ApplyBreakingRules { get; set; }Utilisez les règles de saut de ligne éthiopiennes et amhariques héritées.
AutofitToFirstFixedWidthCell { get; set; }Autoriser les colonnes du tableau à dépasser les largeurs préférées des cellules constitutives.
AutoSpaceLikeWord95 { get; set; }Émuler l’espacement des caractères pleine largeur de Word 95.
BalanceSingleByteDoubleByteWidth { get; set; }Équilibrer les caractères à un octet et à deux octets.
CachedColBalance { get; set; }Utiliser les informations de paragraphe mises en cache pour l’équilibrage des colonnes.
ConvMailMergeEsc { get; set; }Traitez le délimiteur de guillemets à barre oblique inverse comme deux guillemets.
DisableOpenTypeFontFormattingFeatures { get; set; }Spécifie de désactiver les fonctionnalités de formatage de police OpenType.
DisplayHangulFixedWidth { get; set; }Utilisez toujours une largeur fixe pour les caractères Hangul.
DoNotAutofitConstrainedTables { get; set; }Ne pas ajuster automatiquement les tableaux pour qu’ils s’adaptent à côté des objets enveloppés.
DoNotBreakConstrainedForcedTable { get; set; }Ne séparez pas les lignes du tableau autour des tableaux flottants.
DoNotBreakWrappedTables { get; set; }Ne laissez pas les tableaux flottants se répartir sur plusieurs pages.
DoNotExpandShiftReturn { get; set; }Ne justifiez pas les lignes se terminant par un saut de ligne souple.
DoNotLeaveBackslashAlone { get; set; }Convertir la barre oblique inverse en signe yen lors de la saisie.
DoNotSnapToGridInCell { get; set; }Ne pas aligner sur la grille du document dans les cellules de tableau contenant des objets.
DoNotSuppressIndentation { get; set; }N’ignorez pas les objets flottants lors du calcul du retrait des paragraphes.
DoNotSuppressParagraphBorders { get; set; }Ne supprimez pas les bordures de paragraphe à côté des cadres.
DoNotUseEastAsianBreakRules { get; set; }Ne compressez pas les caractères compressibles lors de l’utilisation de la grille de document.
DoNotUseHTMLParagraphAutoSpacing { get; set; }Utilisez un espacement de paragraphe fixe pour le paramètre automatique HTML.
DoNotUseIndentAsNumberingTabStop { get; set; }Ignorer le retrait suspendu lors de la création d’un taquet de tabulation après la numérotation.
DoNotVertAlignCellWithSp { get; set; }N’alignez pas verticalement les cellules contenant des objets flottants.
DoNotVertAlignInTxbx { get; set; }Ignorer l’alignement vertical dans les zones de texte.
DoNotWrapTextWithPunct { get; set; }Ne pas autoriser la ponctuation suspendue avec la grille de caractères.
FootnoteLayoutLikeWW8 { get; set; }Émuler le placement des notes de bas de page de Word 6.x/95/97.
ForgetLastTabAlignment { get; set; }Ignorer la largeur du dernier taquet de tabulation lors de l’alignement du paragraphe s’il n’est pas aligné à gauche.
GrowAutofit { get; set; }Autoriser l’ajustement automatique des tableaux aux marges de la page.
LayoutRawTableWidth { get; set; }Ignorer l’espace avant le tableau pour décider si le tableau doit envelopper un objet flottant.
LayoutTableRowsApart { get; set; }Autoriser les lignes du tableau à envelopper les objets en ligne indépendamment.
LineWrapLikeWord6 { get; set; }Émuler le retour à la ligne de Word 6.0 pour le texte d’Asie de l’Est.
MWSmallCaps { get; set; }Émuler Word 5.x pour le formatage des petites majuscules sur Macintosh.
NoColumnBalance { get; set; }Ne pas équilibrer les colonnes de texte dans une section.
NoExtraLineSpacing { get; set; }Ne centrez pas le contenu sur les lignes avec une hauteur de ligne exacte.
NoLeading { get; set; }N’ajoutez pas d’interligne entre les lignes de texte.
NoSpaceRaiseLower { get; set; }N’augmentez pas la hauteur de ligne pour le texte surélevé/abaissé.
NoTabHangInd { get; set; }Ne créez pas de taquet de tabulation personnalisé pour le retrait suspendu.
OverrideTableStyleFontSizeAndJustification { get; set; }Spécifie comment la hiérarchie des styles du document est évaluée.
PrintBodyTextBeforeHeader { get; set; }Imprimer le corps du texte avant le contenu de l’en-tête/pied de page.
PrintColBlack { get; set; }Imprimez les couleurs en noir et blanc sans tramage.
SelectFldWithFirstOrLastChar { get; set; }Sélectionner le champ lorsque le premier ou le dernier caractère est sélectionné.
ShapeLayoutLikeWW8 { get; set; }Émuler l’habillage de texte Word 97 autour d’objets flottants.
ShowBreaksInFrames { get; set; }Afficher les sauts de page/colonne présents dans les cadres.
SpaceForUL { get; set; }Ajouter un espace supplémentaire sous la ligne de base pour le texte est-asiatique souligné.
SpacingInWholePoints { get; set; }Développer/condenser le texte uniquement par points entiers.
SplitPgBreakAndParaMark { get; set; }Toujours déplacer la marque de paragraphe vers la page après un saut de page.
SubFontBySize { get; set; }Augmenter la priorité de la taille de la police lors de la substitution de police.
SuppressBottomSpacing { get; set; }Ignorer la hauteur de ligne exacte pour la dernière ligne de la page.
SuppressSpacingAtTopOfPage { get; set; }Ignorer la hauteur de ligne minimale pour la première ligne de la page.
SuppressSpBfAfterPgBrk { get; set; }N’utilisez pas d’espace avant la première ligne après un saut de page.
SuppressTopSpacing { get; set; }Ignorer la hauteur de ligne minimale et exacte pour la première ligne de la page.
SuppressTopSpacingWP { get; set; }Émuler l’espacement des lignes de WordPerfect 5.x.
SwapBordersFacingPgs { get; set; }Échanger les bordures de paragraphe sur les pages impaires.
SwapInsideAndOutsideForMirrorIndentsAndRelativePositioning { get; set; }Spécifie d’échanger l’intérieur et l’extérieur pour les retraits miroir et le positionnement relatif.
TransparentMetafiles { get; set; }Spécifie de ne pas effacer la zone derrière les images du métafichier.
TruncateFontHeightsLikeWP6 { get; set; }Émuler le calcul de la hauteur de police de WordPerfect 6.x.
UICompat97To2003 { get; set; }Vrai pour désactiver la fonctionnalité de l’interface utilisateur qui n’est pas compatible avec Word97-2003. La valeur par défaut estFAUX .
UlTrailSpace { get; set; }Soulignez tous les espaces de fin.
UnderlineTabInNumList { get; set; }Souligner le caractère suivant la numérotation.
UseAltKinsokuLineBreakRules { get; set; }Utiliser un ensemble alternatif de règles de saut de ligne d’Asie de l’Est.
UseAnsiKerningPairs { get; set; }Utiliser les paires de crénage ANSI des polices.
UseFELayout { get; set; }Ne pas contourner le code de disposition des scripts d’Asie de l’Est/complexes.
UseNormalStyleForList { get; set; }N’appliquez pas automatiquement le style de paragraphe de liste au texte à puces/numéroté.
UsePrinterMetrics { get; set; }Utiliser les métriques de l’imprimante pour afficher les documents.
UseSingleBorderforContiguousCells { get; set; }Utilisez des règles simplifiées pour les conflits de bordures de tableau.
UseWord2002TableStyleRules { get; set; }Émuler les règles de style de tableau de Word 2002.
UseWord2010TableStyleRules { get; set; }Spécifie l’utilisation des règles de style de tableau Word2010.
UseWord97LineBreakRules { get; set; }Émuler le saut de ligne est-asiatique de Word 97.
WPJustification { get; set; }Émuler la justification de paragraphe de WordPerfect 6.x.
WPSpaceWidth { get; set; }Spécifie s’il faut définir la largeur d’un espace comme cela est fait dans WordPerfect 5.x.
WrapTrailSpaces { get; set; }Retour à la ligne avec espaces de fin.

Méthodes

NomLa description
OptimizeFor(MsWordVersion)Permet d’optimiser le contenu du document ainsi que le comportement par défaut d’Aspose.Words pour une version particulière de MS Word.

Exemples

Montre comment aligner verticalement le contenu textuel d’une zone de texte.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Shape shape = builder.InsertShape(ShapeType.TextBox, 200, 200);

// Définissez la propriété « VerticalAnchor » sur « TextBoxAnchor.Top » pour
// alignez le texte dans cette zone de texte avec le côté supérieur de la forme.
// Définissez la propriété « VerticalAnchor » sur « TextBoxAnchor.Middle » pour
// alignez le texte de cette zone de texte au centre de la forme.
// Définissez la propriété « VerticalAnchor » sur « TextBoxAnchor.Bottom » pour
// alignez le texte de cette zone de texte sur le bas de la forme.
shape.TextBox.VerticalAnchor = verticalAnchor;

builder.MoveTo(shape.FirstParagraph);
builder.Write("Hello world!");

// L'alignement vertical du texte à l'intérieur des zones de texte est disponible à partir de Microsoft Word 2007.
doc.CompatibilityOptions.OptimizeFor(MsWordVersion.Word2007);
doc.Save(ArtifactsDir + "Shape.VerticalAnchor.docx");

Montre comment définir une spécification de conformité OOXML à laquelle un document enregistré doit adhérer.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Si nous configurons les options de compatibilité pour être conformes à Microsoft Word 2003,
// l'insertion d'une image définira sa forme à l'aide de VML.
doc.CompatibilityOptions.OptimizeFor(MsWordVersion.Word2003);
builder.InsertImage(ImageDir + "Transparent background logo.png");

Assert.AreEqual(ShapeMarkupLanguage.Vml, ((Shape)doc.GetChild(NodeType.Shape, 0, true)).MarkupLanguage);

// La norme OOXML « ISO/IEC 29500:2008 » ne prend pas en charge les formes VML.
// Si nous définissons la propriété « Compliance » de l'objet SaveOptions sur « OoxmlCompliance.Iso29500_2008_Strict »,
 // tout document que nous sauvegardons en passant cet objet devra suivre cette norme.
OoxmlSaveOptions saveOptions = new OoxmlSaveOptions
{
    Compliance = OoxmlCompliance.Iso29500_2008_Strict,
    SaveFormat = SaveFormat.Docx
};

doc.Save(ArtifactsDir + "OoxmlSaveOptions.Iso29500Strict.docx", saveOptions);

// Notre document enregistré définit la forme à l'aide de DML pour adhérer à la norme OOXML « ISO/IEC 29500:2008 ».
doc = new Document(ArtifactsDir + "OoxmlSaveOptions.Iso29500Strict.docx");

Assert.AreEqual(ShapeMarkupLanguage.Dml, ((Shape)doc.GetChild(NodeType.Shape, 0, true)).MarkupLanguage);

Montre comment optimiser le document pour différentes versions de Microsoft Word.

public void OptimizeFor()
{
    Document doc = new Document();

    // Cet objet contient une longue liste d'indicateurs uniques à chaque document
    // qui nous permettent de faciliter la compatibilité descendante avec les anciennes versions de Microsoft Word.
    CompatibilityOptions options = doc.CompatibilityOptions;

    // Imprimez les paramètres par défaut pour un document vierge.
    Console.WriteLine("\nDefault optimization settings:");
    PrintCompatibilityOptions(options);

    // Nous pouvons accéder à ces paramètres dans Microsoft Word via "Fichier" -> "Options" -> "Avancé" -> "Options de compatibilité pour...".
    doc.Save(ArtifactsDir + "CompatibilityOptions.OptimizeFor.DefaultSettings.docx");

    // Nous pouvons utiliser la méthode OptimizeFor pour assurer une compatibilité optimale avec une version spécifique de Microsoft Word.
    doc.CompatibilityOptions.OptimizeFor(MsWordVersion.Word2010);
    Console.WriteLine("\nOptimized for Word 2010:");
    PrintCompatibilityOptions(options);

    doc.CompatibilityOptions.OptimizeFor(MsWordVersion.Word2000);
    Console.WriteLine("\nOptimized for Word 2000:");
    PrintCompatibilityOptions(options);
}

/// <summary>
/// Regroupe tous les indicateurs dans l'objet d'options de compatibilité d'un document par état, puis imprime chaque groupe.
/// </summary>
private static void PrintCompatibilityOptions(CompatibilityOptions options)
{
    IList<string> enabledOptions = new List<string>();
    IList<string> disabledOptions = new List<string>();
    AddOptionName(options.AdjustLineHeightInTable, "AdjustLineHeightInTable", enabledOptions, disabledOptions);
    AddOptionName(options.AlignTablesRowByRow, "AlignTablesRowByRow", enabledOptions, disabledOptions);
    AddOptionName(options.AllowSpaceOfSameStyleInTable, "AllowSpaceOfSameStyleInTable", enabledOptions, disabledOptions);
    AddOptionName(options.ApplyBreakingRules, "ApplyBreakingRules", enabledOptions, disabledOptions);
    AddOptionName(options.AutoSpaceLikeWord95, "AutoSpaceLikeWord95", enabledOptions, disabledOptions);
    AddOptionName(options.AutofitToFirstFixedWidthCell, "AutofitToFirstFixedWidthCell", enabledOptions, disabledOptions);
    AddOptionName(options.BalanceSingleByteDoubleByteWidth, "BalanceSingleByteDoubleByteWidth", enabledOptions, disabledOptions);
    AddOptionName(options.CachedColBalance, "CachedColBalance", enabledOptions, disabledOptions);
    AddOptionName(options.ConvMailMergeEsc, "ConvMailMergeEsc", enabledOptions, disabledOptions);
    AddOptionName(options.DisableOpenTypeFontFormattingFeatures, "DisableOpenTypeFontFormattingFeatures", enabledOptions, disabledOptions);
    AddOptionName(options.DisplayHangulFixedWidth, "DisplayHangulFixedWidth", enabledOptions, disabledOptions);
    AddOptionName(options.DoNotAutofitConstrainedTables, "DoNotAutofitConstrainedTables", enabledOptions, disabledOptions);
    AddOptionName(options.DoNotBreakConstrainedForcedTable, "DoNotBreakConstrainedForcedTable", enabledOptions, disabledOptions);
    AddOptionName(options.DoNotBreakWrappedTables, "DoNotBreakWrappedTables", enabledOptions, disabledOptions);
    AddOptionName(options.DoNotExpandShiftReturn, "DoNotExpandShiftReturn", enabledOptions, disabledOptions);
    AddOptionName(options.DoNotLeaveBackslashAlone, "DoNotLeaveBackslashAlone", enabledOptions, disabledOptions);
    AddOptionName(options.DoNotSnapToGridInCell, "DoNotSnapToGridInCell", enabledOptions, disabledOptions);
    AddOptionName(options.DoNotSuppressIndentation, "DoNotSnapToGridInCell", enabledOptions, disabledOptions);
    AddOptionName(options.DoNotSuppressParagraphBorders, "DoNotSuppressParagraphBorders", enabledOptions, disabledOptions);
    AddOptionName(options.DoNotUseEastAsianBreakRules, "DoNotUseEastAsianBreakRules", enabledOptions, disabledOptions);
    AddOptionName(options.DoNotUseHTMLParagraphAutoSpacing, "DoNotUseHTMLParagraphAutoSpacing", enabledOptions, disabledOptions);
    AddOptionName(options.DoNotUseIndentAsNumberingTabStop, "DoNotUseIndentAsNumberingTabStop", enabledOptions, disabledOptions);
    AddOptionName(options.DoNotVertAlignCellWithSp, "DoNotVertAlignCellWithSp", enabledOptions, disabledOptions);
    AddOptionName(options.DoNotVertAlignInTxbx, "DoNotVertAlignInTxbx", enabledOptions, disabledOptions);
    AddOptionName(options.DoNotWrapTextWithPunct, "DoNotWrapTextWithPunct", enabledOptions, disabledOptions);
    AddOptionName(options.FootnoteLayoutLikeWW8, "FootnoteLayoutLikeWW8", enabledOptions, disabledOptions);
    AddOptionName(options.ForgetLastTabAlignment, "ForgetLastTabAlignment", enabledOptions, disabledOptions);
    AddOptionName(options.GrowAutofit, "GrowAutofit", enabledOptions, disabledOptions);
    AddOptionName(options.LayoutRawTableWidth, "LayoutRawTableWidth", enabledOptions, disabledOptions);
    AddOptionName(options.LayoutTableRowsApart, "LayoutTableRowsApart", enabledOptions, disabledOptions);
    AddOptionName(options.LineWrapLikeWord6, "LineWrapLikeWord6", enabledOptions, disabledOptions);
    AddOptionName(options.MWSmallCaps, "MWSmallCaps", enabledOptions, disabledOptions);
    AddOptionName(options.NoColumnBalance, "NoColumnBalance", enabledOptions, disabledOptions);
    AddOptionName(options.NoExtraLineSpacing, "NoExtraLineSpacing", enabledOptions, disabledOptions);
    AddOptionName(options.NoLeading, "NoLeading", enabledOptions, disabledOptions);
    AddOptionName(options.NoSpaceRaiseLower, "NoSpaceRaiseLower", enabledOptions, disabledOptions);
    AddOptionName(options.NoTabHangInd, "NoTabHangInd", enabledOptions, disabledOptions);
    AddOptionName(options.OverrideTableStyleFontSizeAndJustification, "OverrideTableStyleFontSizeAndJustification", enabledOptions, disabledOptions);
    AddOptionName(options.PrintBodyTextBeforeHeader, "PrintBodyTextBeforeHeader", enabledOptions, disabledOptions);
    AddOptionName(options.PrintColBlack, "PrintColBlack", enabledOptions, disabledOptions);
    AddOptionName(options.SelectFldWithFirstOrLastChar, "SelectFldWithFirstOrLastChar", enabledOptions, disabledOptions);
    AddOptionName(options.ShapeLayoutLikeWW8, "ShapeLayoutLikeWW8", enabledOptions, disabledOptions);
    AddOptionName(options.ShowBreaksInFrames, "ShowBreaksInFrames", enabledOptions, disabledOptions);
    AddOptionName(options.SpaceForUL, "SpaceForUL", enabledOptions, disabledOptions);
    AddOptionName(options.SpacingInWholePoints, "SpacingInWholePoints", enabledOptions, disabledOptions);
    AddOptionName(options.SplitPgBreakAndParaMark, "SplitPgBreakAndParaMark", enabledOptions, disabledOptions);
    AddOptionName(options.SubFontBySize, "SubFontBySize", enabledOptions, disabledOptions);
    AddOptionName(options.SuppressBottomSpacing, "SuppressBottomSpacing", enabledOptions, disabledOptions);
    AddOptionName(options.SuppressSpBfAfterPgBrk, "SuppressSpBfAfterPgBrk", enabledOptions, disabledOptions);
    AddOptionName(options.SuppressSpacingAtTopOfPage, "SuppressSpacingAtTopOfPage", enabledOptions, disabledOptions);
    AddOptionName(options.SuppressTopSpacing, "SuppressTopSpacing", enabledOptions, disabledOptions);
    AddOptionName(options.SuppressTopSpacingWP, "SuppressTopSpacingWP", enabledOptions, disabledOptions);
    AddOptionName(options.SwapBordersFacingPgs, "SwapBordersFacingPgs", enabledOptions, disabledOptions);
    AddOptionName(options.SwapInsideAndOutsideForMirrorIndentsAndRelativePositioning, "SwapInsideAndOutsideForMirrorIndentsAndRelativePositioning", enabledOptions, disabledOptions);
    AddOptionName(options.TransparentMetafiles, "TransparentMetafiles", enabledOptions, disabledOptions);
    AddOptionName(options.TruncateFontHeightsLikeWP6, "TruncateFontHeightsLikeWP6", enabledOptions, disabledOptions);
    AddOptionName(options.UICompat97To2003, "UICompat97To2003", enabledOptions, disabledOptions);
    AddOptionName(options.UlTrailSpace, "UlTrailSpace", enabledOptions, disabledOptions);
    AddOptionName(options.UnderlineTabInNumList, "UnderlineTabInNumList", enabledOptions, disabledOptions);
    AddOptionName(options.UseAltKinsokuLineBreakRules, "UseAltKinsokuLineBreakRules", enabledOptions, disabledOptions);
    AddOptionName(options.UseAnsiKerningPairs, "UseAnsiKerningPairs", enabledOptions, disabledOptions);
    AddOptionName(options.UseFELayout, "UseFELayout", enabledOptions, disabledOptions);
    AddOptionName(options.UseNormalStyleForList, "UseNormalStyleForList", enabledOptions, disabledOptions);
    AddOptionName(options.UsePrinterMetrics, "UsePrinterMetrics", enabledOptions, disabledOptions);
    AddOptionName(options.UseSingleBorderforContiguousCells, "UseSingleBorderforContiguousCells", enabledOptions, disabledOptions);
    AddOptionName(options.UseWord2002TableStyleRules, "UseWord2002TableStyleRules", enabledOptions, disabledOptions);
    AddOptionName(options.UseWord2010TableStyleRules, "UseWord2010TableStyleRules", enabledOptions, disabledOptions);
    AddOptionName(options.UseWord97LineBreakRules, "UseWord97LineBreakRules", enabledOptions, disabledOptions);
    AddOptionName(options.WPJustification, "WPJustification", enabledOptions, disabledOptions);
    AddOptionName(options.WPSpaceWidth, "WPSpaceWidth", enabledOptions, disabledOptions);
    AddOptionName(options.WrapTrailSpaces, "WrapTrailSpaces", enabledOptions, disabledOptions);
    Console.WriteLine("\tEnabled options:");
    foreach (string optionName in enabledOptions)
        Console.WriteLine($"\t\t{optionName}");
    Console.WriteLine("\tDisabled options:");
    foreach (string optionName in disabledOptions)
        Console.WriteLine($"\t\t{optionName}");
}

private static void AddOptionName(Boolean option, String optionName, IList<string> enabledOptions, IList<string> disabledOptions)
{
    if (option)
        enabledOptions.Add(optionName);
    else
        disabledOptions.Add(optionName);
}

Voir également

Compatibility Enum HyphenationOptions Class