FieldSymbol

FieldSymbol class

Implementerar ett SYMBOL-fält.

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

public class FieldSymbol : Field

Konstruktörer

namnBeskrivning
FieldSymbol()Default_Constructor

Egenskaper

namnBeskrivning
CharacterCode { get; set; }Hämtar eller ställer in karaktärens kodpunktvärde i decimalt eller hexadecimalt.
DisplayResult { get; }Hämtar texten som representerar det visade fältresultatet.
DontAffectsLineSpacing { get; set; }Hämtar eller anger om tecknet som hämtas av fältet påverkar radavståndet i stycket.
End { get; }Hämtar noden som representerar fältets slut.
FontName { get; set; }Hämtar eller anger namnet på teckensnittet för det tecken som hämtas av fältet.
FontSize { get; set; }Hämtar eller ställer in storleken i punkter på teckensnittet för det tecken som hämtas av fältet.
Format { get; }Får enFieldFormatobjekt som ger typad åtkomst till fältets formatering.
IsAnsi { get; set; }Hämtar eller anger om teckenkoden ska tolkas som värdet för ett ANSI-tecken.
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).
IsShiftJis { get; set; }Hämtar eller anger om teckenkoden ska tolkas som värdet för ett SHIFT-JIS-tecken.
IsUnicode { get; set; }Hämtar eller anger om teckenkoden ska tolkas som värdet för ett Unicode-tecken.
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 tecknet vars kodpunktvärde är angett i decimal- eller hexadecimalt värde.

Exempel

Visar hur man använder SYMBOL-fältet.

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

// Nedan följer tre sätt att använda ett SYMBOL-fält för att visa ett enskilt tecken.
// 1 - Lägg till ett SYMBOL-fält som visar symbolen © (Copyright), specificerad av en ANSI-teckenkod:
FieldSymbol field = (FieldSymbol)builder.InsertField(FieldType.FieldSymbol, true);

// ANSI-teckenkoden "U+00A9", eller "169" i heltalsform, är reserverad för copyright-symbolen.
field.CharacterCode = 0x00a9.ToString();
field.IsAnsi = true;

Assert.AreEqual(" SYMBOL  169 \\a", field.GetFieldCode());

builder.Writeln(" Line 1");

// 2 - Lägg till ett SYMBOL-fält som visar symbolen ∞ (oändlighet) och ändra dess utseende:
field = (FieldSymbol)builder.InsertField(FieldType.FieldSymbol, true);

// I Unicode upptar oändlighetstecknet koden "221E".
field.CharacterCode = 0x221E.ToString();
field.IsUnicode = true;

// Ändra teckensnittet på vår symbol efter att ha använt Windows teckenmappning
// för att säkerställa att teckensnittet kan representera den symbolen.
field.FontName = "Calibri";
field.FontSize = "24";

// Vi kan ställa in den här flaggan för höga symboler för att se till att de inte trycker ner resten av texten på sin rad.
field.DontAffectsLineSpacing = true;

Assert.AreEqual(" SYMBOL  8734 \\u \\f Calibri \\s 24 \\h", field.GetFieldCode());

builder.Writeln("Line 2");

// 3 - Lägg till ett SYMBOL-fält som visar tecknet あ,
// med ett teckensnitt som stöder Shift-JIS (Windows-932) teckentabell:
field = (FieldSymbol)builder.InsertField(FieldType.FieldSymbol, true);
field.FontName = "MS Gothic";
field.CharacterCode = 0x82A0.ToString();
field.IsShiftJis = true;

Assert.AreEqual(" SYMBOL  33440 \\f \"MS Gothic\" \\j", field.GetFieldCode());

builder.Write("Line 3");

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

Se även