PageRangeBookmarkName

FieldXE.PageRangeBookmarkName property

Ruft den Namen des Lesezeichens ab, das einen Seitenbereich markiert, der als Seitenzahl des Eintrags eingefügt wird, oder legt diesen fest.

public string PageRangeBookmarkName { get; set; }

Beispiele

Zeigt, wie die übergreifenden Seiten eines Lesezeichens als Seitenbereich für einen INDEX-Feldeintrag angegeben werden.

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);

// Für INDEX-Einträge, die Seitenbereiche anzeigen, können wir eine Trennzeichenfolge angeben
// die zwischen der Nummer der ersten Seite und der Nummer der letzten Seite erscheint.
index.PageNumberSeparator = ", on page(s) ";
index.PageRangeSeparator = " to ";

Assert.AreEqual(" INDEX  \\e \", on page(s) \" \\g \" to \"", index.GetFieldCode());

builder.InsertBreak(BreakType.PageBreak);
FieldXE indexEntry = (FieldXE)builder.InsertField(FieldType.FieldIndexEntry, true);
indexEntry.Text = "My entry";

// Wenn ein XE-Feld ein Lesezeichen mithilfe der PageRangeBookmarkName-Eigenschaft benennt,
// sein INDEX-Eintrag zeigt den Seitenbereich an, den das Lesezeichen umfasst
// anstelle der Nummer der Seite, die das XE-Feld enthält.
indexEntry.PageRangeBookmarkName = "MyBookmark";

Assert.AreEqual(" XE  \"My entry\" \\r MyBookmark", indexEntry.GetFieldCode());
Assert.AreEqual("MyBookmark", indexEntry.PageRangeBookmarkName);

// Ein Lesezeichen einfügen, das auf Seite 3 beginnt und auf Seite 5 endet.
// Der INDEX-Eintrag für das XE-Feld, das auf dieses Lesezeichen verweist, zeigt diesen Seitenbereich an.
// In unserer Tabelle zeigt der INDEX-Eintrag „Mein Eintrag, auf Seite(n) 3 bis 5“ an.
builder.InsertBreak(BreakType.PageBreak);
builder.StartBookmark("MyBookmark");
builder.Write("Start of MyBookmark");
builder.InsertBreak(BreakType.PageBreak);
builder.InsertBreak(BreakType.PageBreak);
builder.Write("End of MyBookmark");
builder.EndBookmark("MyBookmark");

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

Siehe auch

FieldXE.PageNumberReplacement FieldXE.Text