RunSubentriesOnSameLine

FieldIndex.RunSubentriesOnSameLine property

Ruft ab oder legt fest, ob Untereinträge in derselben Zeile wie der Haupteintrag ausgeführt werden.

public bool RunSubentriesOnSameLine { get; set; }

Beispiele

Zeigt, wie mit Untereinträgen in einem INDEX-Feld gearbeitet wird.

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

// Erstellen Sie ein INDEX-Feld, das einen Eintrag für jedes im Dokument gefundene XE-Feld anzeigt.
// Jeder Eintrag zeigt den Text-Eigenschaftswert des XE-Felds auf der linken Seite an.
// und die Nummer der Seite, die rechts das XE-Feld enthält.
// Der INDEX-Eintrag sammelt alle XE-Felder mit übereinstimmenden Werten in der Eigenschaft „Text“.
// in einen Eintrag, anstatt für jedes XE-Feld einen Eintrag vorzunehmen.
FieldIndex index = (FieldIndex)builder.InsertField(FieldType.FieldIndex, true);
index.PageNumberSeparator = ", see page ";
index.Heading = "A";

// XE-Felder mit einer Text-Eigenschaft, deren Wert zur Überschrift des INDEX-Eintrags wird.
// Wenn dieser Wert zwei durch einen Doppelpunkt getrennte Zeichenfolgensegmente enthält (der INDEX-Eintrag behandelt :) Trennzeichen,
// Das erste Segment ist die Überschrift und das zweite Segment wird zur Unterüberschrift.
// Das INDEX-Feld gruppiert Einträge zunächst alphabetisch, dann, wenn es mehrere XE-Felder mit demselben gibt
// Überschriften, das INDEX-Feld wird sie weiter nach den Werten dieser Überschriften unterteilen.
// Je nachdem, wie oft, kann es mehrere Untergruppierungsebenen geben
// Die Texteigenschaften von XE-Feldern werden wie folgt segmentiert.
// Standardmäßig erstellt eine INDEX-Feldeintragsgruppe eine neue Zeile für jede Unterüberschrift innerhalb dieser Gruppe.
// Wir können das RunSubentriesOnSameLine-Flag auf true setzen, um die Überschrift beizubehalten.
// und jede Unterüberschrift für die Gruppe stattdessen in einer Zeile, wodurch das INDEX-Feld kompakter wird.
index.RunSubentriesOnSameLine = runSubentriesOnTheSameLine;

if (runSubentriesOnTheSameLine)
    Assert.AreEqual(" INDEX  \\e \", see page \" \\h A \\r", index.GetFieldCode());
else
    Assert.AreEqual(" INDEX  \\e \", see page \" \\h A", index.GetFieldCode());

// Zwei XE-Felder einfügen, jedes auf einer neuen Seite und mit derselben Überschrift namens „Überschrift 1“,
// die das INDEX-Feld zum Gruppieren verwendet.
// Wenn RunSubentriesOnSameLine false ist, erstellt die INDEX-Tabelle drei Zeilen:
// eine Zeile für die Gruppierungsüberschrift „Überschrift 1“ und eine weitere Zeile für jede Unterüberschrift.
// Wenn RunSubentriesOnSameLine wahr ist, erstellt die INDEX-Tabelle eine einzeilige Tabelle
// Eintrag, der die Überschrift und jede Unterüberschrift umfasst.
builder.InsertBreak(BreakType.PageBreak);
FieldXE indexEntry = (FieldXE)builder.InsertField(FieldType.FieldIndexEntry, true);
indexEntry.Text = "Heading 1:Subheading 1";

Assert.AreEqual(" XE  \"Heading 1:Subheading 1\"", indexEntry.GetFieldCode());

builder.InsertBreak(BreakType.PageBreak);
indexEntry = (FieldXE)builder.InsertField(FieldType.FieldIndexEntry, true);
indexEntry.Text = "Heading 1:Subheading 2";

doc.UpdatePageLayout();
doc.UpdateFields();
doc.Save(ArtifactsDir + $"Field.INDEX.XE.Subheading.docx");

Siehe auch

FieldIndex.PageRangeSeparator FieldIndex.SequenceName