CompatibilityOptions

CompatibilityOptions class

Enthält Kompatibilitätsoptionen (d. h. die Benutzereinstellungen, die auf demKompatibilität Registerkarte desOptionen Dialogfeld in Microsoft Word).

Um mehr zu erfahren, besuchen Sie dieDateiformat erkennen und Formatkompatibilität prüfen Dokumentationsartikel.

public class CompatibilityOptions

Eigenschaften

NameBeschreibung
AdjustLineHeightInTable { get; set; }Zeilenabstand des Dokumentrasters zu Zeilen in Tabellenzellen hinzufügen.
AlignTablesRowByRow { get; set; }Tabellenzeilen unabhängig ausrichten.
AllowSpaceOfSameStyleInTable { get; set; }Kontextabhängige Abstände zwischen Absätzen in Tabellen zulassen.
ApplyBreakingRules { get; set; }Verwenden Sie die alten äthiopischen und amharischen Zeilenumbruchregeln.
AutofitToFirstFixedWidthCell { get; set; }Tabellenspalten dürfen die bevorzugte Breite der Zellen überschreiten.
AutoSpaceLikeWord95 { get; set; }Emulieren Sie den Zeichenabstand in voller Breite von Word 95.
BalanceSingleByteDoubleByteWidth { get; set; }Gleichen Sie Einzelbyte- und Doppelbyte-Zeichen aus.
CachedColBalance { get; set; }Zwischengespeicherte Absatzinformationen zum Spaltenausgleich verwenden.
ConvMailMergeEsc { get; set; }Backslash-Anführungszeichen als zwei Anführungszeichen behandeln.
DisableOpenTypeFontFormattingFeatures { get; set; }Gibt an, dass die OpenType-Schriftformatierungsfunktionen deaktiviert werden sollen.
DisplayHangulFixedWidth { get; set; }Verwenden Sie für Hangul-Zeichen immer eine feste Breite.
DoNotAutofitConstrainedTables { get; set; }Tabellen nicht automatisch an umschlossene Objekte anpassen.
DoNotBreakConstrainedForcedTable { get; set; }Tabellenzeilen um schwebende Tabellen nicht unterbrechen.
DoNotBreakWrappedTables { get; set; }Lassen Sie nicht zu, dass schwebende Tabellen über mehrere Seiten hinweg umbrechen.
DoNotExpandShiftReturn { get; set; }Zeilen, die mit einem weichen Zeilenumbruch enden, nicht im Blocksatz ausrichten.
DoNotLeaveBackslashAlone { get; set; }Backslash bei Eingabe in Yen-Zeichen umwandeln.
DoNotSnapToGridInCell { get; set; }In Tabellenzellen mit Objekten nicht am Dokumentraster ausrichten.
DoNotSuppressIndentation { get; set; }Ignorieren Sie schwebende Objekte bei der Berechnung der Absatzeinrückung nicht.
DoNotSuppressParagraphBorders { get; set; }Absatzränder neben Rahmen nicht unterdrücken.
DoNotUseEastAsianBreakRules { get; set; }Komprimierbare Zeichen bei Verwendung des Dokumentrasters nicht komprimieren.
DoNotUseHTMLParagraphAutoSpacing { get; set; }Verwenden Sie einen festen Absatzabstand für die automatische HTML-Einstellung.
DoNotUseIndentAsNumberingTabStop { get; set; }Hängenden Einzug beim Erstellen eines Tabstopps nach der Nummerierung ignorieren.
DoNotVertAlignCellWithSp { get; set; }Zellen mit schwebenden Objekten nicht vertikal ausrichten.
DoNotVertAlignInTxbx { get; set; }Vertikale Ausrichtung in Textfeldern ignorieren.
DoNotWrapTextWithPunct { get; set; }Hängende Satzzeichen im Zeichenraster nicht zulassen.
FootnoteLayoutLikeWW8 { get; set; }Fußnotenplatzierung in Word 6.x/95/97 emulieren.
ForgetLastTabAlignment { get; set; }Breite des letzten Tabulatorstopps beim Ausrichten eines Absatzes ignorieren, wenn dieser nicht linksbündig ist.
GrowAutofit { get; set; }Automatisches Anpassen von Tabellen an die Seitenränder zulassen.
LayoutRawTableWidth { get; set; }Leerzeichen vor der Tabelle ignorieren, wenn entschieden wird, ob die Tabelle ein schwebendes Objekt umschließen soll.
LayoutTableRowsApart { get; set; }Tabellenzeilen können Inline-Objekte unabhängig umbrechen.
LineWrapLikeWord6 { get; set; }Emulieren Sie den Zeilenumbruch von Word 6.0 für ostasiatischen Text.
MWSmallCaps { get; set; }Emulieren Sie Word 5.x für die Macintosh-Formatierung in Kapitälchen.
NoColumnBalance { get; set; }Textspalten innerhalb eines Abschnitts nicht ausgleichen.
NoExtraLineSpacing { get; set; }Inhalt nicht auf Zeilen mit exakter Zeilenhöhe zentrieren.
NoLeading { get; set; }Fügen Sie keinen Zeilenabstand zwischen den Textzeilen hinzu.
NoSpaceRaiseLower { get; set; }Erhöhen Sie die Zeilenhöhe für erhabenen/abgesenkten Text nicht.
NoTabHangInd { get; set; }Erstellen Sie keinen benutzerdefinierten Tabstopp für hängenden Einzug.
OverrideTableStyleFontSizeAndJustification { get; set; }Gibt an, wie die Stilhierarchie des Dokuments ausgewertet wird.
PrintBodyTextBeforeHeader { get; set; }Haupttext vor Kopf-/Fußzeileninhalt drucken.
PrintColBlack { get; set; }Drucken Sie Farben als Schwarzweiß ohne Dithering.
SelectFldWithFirstOrLastChar { get; set; }Feld auswählen, wenn erstes oder letztes Zeichen ausgewählt ist.
ShapeLayoutLikeWW8 { get; set; }Emulieren Sie den Textumbruch von Word 97 um schwebende Objekte.
ShowBreaksInFrames { get; set; }In Frames vorhandene Seiten-/Spaltenumbrüche anzeigen.
SpaceForUL { get; set; }Fügen Sie für unterstrichenen ostasiatischen Text zusätzlichen Platz unterhalb der Grundlinie hinzu.
SpacingInWholePoints { get; set; }Text nur um ganze Punkte erweitern/verdichten.
SplitPgBreakAndParaMark { get; set; }Absatzmarke immer auf die Seite nach einem Seitenumbruch verschieben.
SubFontBySize { get; set; }Erhöhen Sie die Priorität der Schriftgröße beim Ersetzen von Schriftarten.
SuppressBottomSpacing { get; set; }Genaue Zeilenhöhe für die letzte Zeile auf der Seite ignorieren.
SuppressSpacingAtTopOfPage { get; set; }Minimale Zeilenhöhe für die erste Zeile auf der Seite ignorieren.
SuppressSpBfAfterPgBrk { get; set; }Verwenden Sie vor der ersten Zeile nach einem Seitenumbruch kein Leerzeichen.
SuppressTopSpacing { get; set; }Minimale und genaue Zeilenhöhe für die erste Zeile auf der Seite ignorieren.
SuppressTopSpacingWP { get; set; }Emuliert den Zeilenabstand von WordPerfect 5.x.
SwapBordersFacingPgs { get; set; }Absatzränder auf Seiten mit ungeraden Seitenzahlen vertauschen.
SwapInsideAndOutsideForMirrorIndentsAndRelativePositioning { get; set; }Gibt an, dass Innen- und Außenflächen vertauscht werden sollen, um gespiegelte Einrückungen und eine relative Positionierung zu erzielen.
TransparentMetafiles { get; set; }Gibt an, dass der Bereich hinter Metadateibildern nicht gelöscht werden soll.
TruncateFontHeightsLikeWP6 { get; set; }Emulieren Sie die Schrifthöhenberechnung von WordPerfect 6.x.
UICompat97To2003 { get; set; }True, um die UI-Funktionalität zu deaktivieren, die nicht mit Word97-2003 kompatibel ist. Der Standardwert istFALSCH .
UlTrailSpace { get; set; }Alle nachstehenden Leerzeichen unterstreichen.
UnderlineTabInNumList { get; set; }Unterstreichen Sie das folgende Zeichen nach der Nummerierung.
UseAltKinsokuLineBreakRules { get; set; }Verwenden Sie einen alternativen Satz ostasiatischer Zeilenumbruchregeln.
UseAnsiKerningPairs { get; set; }ANSI-Kerning-Paare aus Schriftarten verwenden.
UseFELayout { get; set; }Umgehen Sie keinen ostasiatischen/komplexen Schriftlayoutcode.
UseNormalStyleForList { get; set; }Listenabsatzformat nicht automatisch auf Aufzählungs-/Nummerierungstext anwenden.
UsePrinterMetrics { get; set; }Verwenden Sie Druckermetriken zum Anzeigen von Dokumenten.
UseSingleBorderforContiguousCells { get; set; }Verwenden Sie vereinfachte Regeln für Tabellenrandkonflikte.
UseWord2002TableStyleRules { get; set; }Emulieren Sie die Tabellenformatregeln von Word 2002.
UseWord2010TableStyleRules { get; set; }Gibt an, dass die Tabellenformatregeln von Word2010 verwendet werden sollen.
UseWord97LineBreakRules { get; set; }Emulieren Sie den ostasiatischen Zeilenumbruch von Word 97.
WPJustification { get; set; }Absatzausrichtung von WordPerfect 6.x emulieren.
WPSpaceWidth { get; set; }Gibt an, ob die Breite eines Zwischenraums wie in WordPerfect 5.x festgelegt werden soll.
WrapTrailSpaces { get; set; }Zeilenumbruch, nachfolgende Leerzeichen.

Methoden

NameBeschreibung
OptimizeFor(MsWordVersion)Ermöglicht die Optimierung des Dokumentinhalts sowie des Standardverhaltens von Aspose.Words für bestimmte Versionen von MS Word.

Beispiele

Zeigt, wie der Textinhalt eines Textfelds vertikal ausgerichtet wird.

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

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

// Setzen Sie die Eigenschaft "VerticalAnchor" auf "TextBoxAnchor.Top" auf
// Richten Sie den Text in diesem Textfeld an der Oberseite der Form aus.
// Setzen Sie die Eigenschaft "VerticalAnchor" auf "TextBoxAnchor.Middle" auf
// Richten Sie den Text in diesem Textfeld an der Mitte der Form aus.
// Setzen Sie die Eigenschaft "VerticalAnchor" auf "TextBoxAnchor.Bottom" auf
// Richten Sie den Text in diesem Textfeld am unteren Rand der Form aus.
shape.TextBox.VerticalAnchor = verticalAnchor;

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

// Die vertikale Ausrichtung von Text in Textfeldern ist ab Microsoft Word 2007 verfügbar.
doc.CompatibilityOptions.OptimizeFor(MsWordVersion.Word2007);
doc.Save(ArtifactsDir + "Shape.VerticalAnchor.docx");

Zeigt, wie eine OOXML-Konformitätsspezifikation festgelegt wird, an die sich ein gespeichertes Dokument halten muss.

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

// Wenn wir die Kompatibilitätsoptionen so konfigurieren, dass sie mit Microsoft Word 2003 kompatibel sind,
// Durch das Einfügen eines Bildes wird seine Form mithilfe von VML definiert.
doc.CompatibilityOptions.OptimizeFor(MsWordVersion.Word2003);
builder.InsertImage(ImageDir + "Transparent background logo.png");

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

// Der OOXML-Standard „ISO/IEC 29500:2008“ unterstützt keine VML-Formen.
// Wenn wir die Eigenschaft "Compliance" des SaveOptions-Objekts auf "OoxmlCompliance.Iso29500_2008_Strict" setzen,
    // Jedes Dokument, das wir beim Übergeben dieses Objekts speichern, muss diesem Standard entsprechen.
OoxmlSaveOptions saveOptions = new OoxmlSaveOptions
{
    Compliance = OoxmlCompliance.Iso29500_2008_Strict,
    SaveFormat = SaveFormat.Docx
};

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

// Unser gespeichertes Dokument definiert die Form mithilfe von DML, um dem OOXML-Standard „ISO/IEC 29500:2008“ zu entsprechen.
doc = new Document(ArtifactsDir + "OoxmlSaveOptions.Iso29500Strict.docx");

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

Zeigt, wie das Dokument für verschiedene Versionen von Microsoft Word optimiert wird.

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

    // Dieses Objekt enthält eine umfangreiche Liste von Flags, die für jedes Dokument eindeutig sind
    // die es uns ermöglichen, die Abwärtskompatibilität mit älteren Versionen von Microsoft Word zu erleichtern.
    CompatibilityOptions options = doc.CompatibilityOptions;

    // Drucken Sie die Standardeinstellungen für ein leeres Dokument.
    Console.WriteLine("\nDefault optimization settings:");
    PrintCompatibilityOptions(options);

    // Auf diese Einstellungen können wir in Microsoft Word über „Datei“ -> „Optionen“ -> „Erweitert“ -> „Kompatibilitätsoptionen für…“ zugreifen.
    doc.Save(ArtifactsDir + "CompatibilityOptions.OptimizeFor.DefaultSettings.docx");

    // Wir können die OptimizeFor-Methode verwenden, um optimale Kompatibilität mit einer bestimmten Microsoft Word-Version sicherzustellen.
    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>
/// Gruppiert alle Flags im Kompatibilitätsoptionsobjekt eines Dokuments nach Status und druckt dann jede Gruppe.
/// </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);
}

Siehe auch

Compatibility Enum HyphenationOptions Class