FieldAdvance

FieldAdvance class

Implementerar ADVANCE-fältet.

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

public class FieldAdvance : Field

Konstruktörer

namnBeskrivning
FieldAdvance()Default_Constructor

Egenskaper

namnBeskrivning
DisplayResult { get; }Hämtar texten som representerar det visade fältresultatet.
DownOffset { get; set; }Hämtar eller ställer in antalet punkter med vilka texten som följer efter fältet ska flyttas nedåt.
End { get; }Hämtar noden som representerar fältänden.
Format { get; }Får enFieldFormat objekt som ger maskinskriven åtkomst till fältets formatering.
HorizontalPosition { get; set; }Hämtar eller ställer in antalet punkter med vilka texten som följer efter fältet ska flyttas horisontellt från den vänstra kanten av kolumnen, ramen eller textrutan.
IsDirty { get; set; }Hämtar eller ställer in 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 ställer in om fältet är låst (ska inte räkna om resultatet).
LeftOffset { get; set; }Hämtar eller ställer in antalet punkter med vilka texten som följer efter fältet ska flyttas åt vänster.
LocaleId { get; set; }Hämtar eller ställer in LCID för fältet.
Result { get; set; }Hämtar eller ställer in text som är mellan fältavgränsaren och fältslutet.
RightOffset { get; set; }Hämtar eller ställer in antalet punkter med vilka texten som följer efter fältet ska flyttas åt höger.
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.
UpOffset { get; set; }Hämtar eller ställer in antalet punkter som texten som följer efter fältet ska flyttas upp med.
VerticalPosition { get; set; }Hämtar eller ställer in antalet punkter med vilka texten som följer efter fältet ska flyttas vertikalt från sidans övre kant.

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 underordnade fält ingår.
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 child av dess överordnade nod, returnerar dess överordnade stycke. Om fältet redan är borttaget, returnerasnull .
Unlink()Utför fältavlänkningen.
Update()Utför fältuppdateringen. Kastar om fältet redan uppdateras.
Update(bool)Utför en fältuppdatering. Kastar om fältet redan uppdateras.

Anmärkningar

Flyttar startpunkten där texten som lexikalt följer fältet visas till höger eller vänster, uppåt eller nedåt, eller till en specifik horisontell eller vertikal position.

Exempel

Visar hur man infogar ett ADVANCE-fält och redigerar dess egenskaper.

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

builder.Write("This text is in its normal place.");

// Nedan finns två sätt att använda ADVANCE-fältet för att justera positionen för text som följer det.
// Effekterna av ett ADVANCE-fält fortsätter att tillämpas tills stycket slutar,
// eller ett annat ADVANCE-fält uppdaterar offset-/koordinatvärdena.
// 1 - Ange en riktningsförskjutning:
FieldAdvance field = (FieldAdvance)builder.InsertField(FieldType.FieldAdvance, true);
field.RightOffset = "5";
field.UpOffset = "5";

Assert.AreEqual(" ADVANCE  \\r 5 \\u 5", field.GetFieldCode());

builder.Write("This text will be moved up and to the right.");

field = (FieldAdvance)builder.InsertField(FieldType.FieldAdvance, true);
field.DownOffset = "5";
field.LeftOffset = "100";

Assert.AreEqual(" ADVANCE  \\d 5 \\l 100", field.GetFieldCode());

builder.Writeln("This text is moved down and to the left, overlapping the previous text.");

// 2 - Flytta text till en position som anges av koordinater:
field = (FieldAdvance)builder.InsertField(FieldType.FieldAdvance, true);
field.HorizontalPosition = "-100";
field.VerticalPosition = "200";

Assert.AreEqual(" ADVANCE  \\x -100 \\y 200", field.GetFieldCode());

builder.Write("This text is in a custom position.");

doc.Save(ArtifactsDir + "Field.ADVANCE.docx");

Se även