FieldSectionPages

FieldSectionPages class

Implementerar fältet SECTIONPAGES.

För att lära dig mer, besökArbeta med fält dokumentationsartikel.

public class FieldSectionPages : Field

Konstruktörer

namnBeskrivning
FieldSectionPages()Default_Constructor

Egenskaper

namnBeskrivning
DisplayResult { get; }Hämtar texten som representerar det visade fältresultatet.
End { get; }Hämtar noden som representerar fältets slut.
Format { get; }Får enFieldFormatobjekt som ger typad åtkomst till fältets formatering.
IsDirty { get; set; }Hämtar eller anger om det aktuella resultatet av fältet inte längre är korrekt (inaktuellt) på grund av andra ändringar som gjorts i dokumentet.
IsLocked { get; set; }Hämtar eller anger om fältet är låst (resultatet ska inte beräknas om).
LocaleId { get; set; }Hämtar eller ställer in fältets LCID.
Result { get; set; }Hämtar eller anger text som är mellan fältavgränsaren och fältslutet.
Separator { get; }Hämtar noden som representerar fältseparatorn. Kan varanull .
Start { get; }Hämtar noden som representerar början av fältet.
virtual Type { get; }Hämtar fälttypen Microsoft Word.

Metoder

namnBeskrivning
GetFieldCode()Returnerar text mellan fältstart och fältavgränsare (eller fältslut om det inte finns någon avgränsare). Både fältkod och fältresultat för underfält inkluderas.
GetFieldCode(bool)Returnerar text mellan fältstart och fältavgränsare (eller fältslut om det inte finns någon avgränsare).
Remove()Tar bort fältet från dokumentet. Returnerar en nod direkt efter fältet. Om fältets slut är den sista undernoden till dess överordnade nod, returneras dess överordnade stycke. Om fältet redan är borttaget returnerasnull .
Unlink()Utför fältavkopplingen.
Update()Utför fältuppdateringen. Körs om fältet redan uppdateras.
Update(bool)Utför en fältuppdatering. Körs om fältet redan uppdateras.

Anmärkningar

Hämtar numret på den aktuella sidan inom det aktuella avsnittet.

Exempel

Visar hur man använder fälten SECTION och SECTIONPAGES för att numrera sidor efter avsnitt.

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

builder.MoveToHeaderFooter(HeaderFooterType.HeaderPrimary);
builder.ParagraphFormat.Alignment = ParagraphAlignment.Right;

// Ett SEKTIONSfält visar numret på det avsnitt det finns i.
builder.Write("Section ");
FieldSection fieldSection = (FieldSection)builder.InsertField(FieldType.FieldSection, true);

Assert.AreEqual(" SECTION ", fieldSection.GetFieldCode());

// Ett PAGE-fält visar numret på den sida det finns på.
builder.Write("\nPage ");
FieldPage fieldPage = (FieldPage)builder.InsertField(FieldType.FieldPage, true);

Assert.AreEqual(" PAGE ", fieldPage.GetFieldCode());

// Ett SECTIONPAGES-fält visar antalet sidor som avsnittet det finns i sträcker sig över.
builder.Write(" of ");
FieldSectionPages fieldSectionPages = (FieldSectionPages)builder.InsertField(FieldType.FieldSectionPages, true);

Assert.AreEqual(" SECTIONPAGES ", fieldSectionPages.GetFieldCode());

// Flytta ut ur sidhuvudet tillbaka till huvuddokumentet och infoga två sidor.
// Alla dessa sidor kommer att finnas i den första sektionen. Våra fält, som visas en gång i varje rubrik,
// numrerar antalet aktuella/totala sidor i detta avsnitt.
builder.MoveToDocumentEnd();
builder.InsertBreak(BreakType.PageBreak);
builder.InsertBreak(BreakType.PageBreak);

// Vi kan infoga ett nytt avsnitt med dokumentbyggaren så här.
// Detta kommer att påverka värdena som visas i fälten SECTION och SECTIONPAGES i alla kommande rubriker.
builder.InsertBreak(BreakType.SectionBreakNewPage);

// Fältet PAGE kommer att fortsätta räkna sidor i hela dokumentet.
// Vi kan manuellt återställa antalet vid varje avsnitt för att hålla reda på sidorna avsnitt för avsnitt.
builder.CurrentSection.PageSetup.RestartPageNumbering = true;
builder.InsertBreak(BreakType.PageBreak);

doc.UpdateFields();
doc.Save(ArtifactsDir + "Field.SECTION.SECTIONPAGES.docx");

Se även

FieldSection Class FieldSeparator Class