VisitFieldStart
Inhalt
[
Ausblenden
]DocumentVisitor.VisitFieldStart method
Wird aufgerufen, wenn ein Feld im Dokument beginnt.
public virtual VisitorAction VisitFieldStart(FieldStart fieldStart)
Parameter | Typ | Beschreibung |
---|---|---|
fieldStart | FieldStart | Das Objekt, das besucht wird. |
Rückgabewert
AVisitorAction
Wert, der angibt, wie die Enumeration fortgesetzt werden soll.
Bemerkungen
Ein Feld in einem Word-Dokument besteht aus einem Feldcode und einem Feldwert.
Ein Feld, das eine Seitenzahl anzeigt, kann beispielsweise wie folgt dargestellt werden:
[FieldStart]PAGE[FieldSeparator]98[FieldEnd]
Das Feldtrennzeichen trennt den Feldcode vom Feldwert im Dokument. Beachten Sie, dass einige -Felder nur einen Feldcode und kein Feldtrennzeichen und keinen Feldwert haben.
Felder können verschachtelt werden.
Beispiele
Zeigt, wie die Knotenstruktur jedes Felds in einem Dokument gedruckt wird.
public void FieldToText()
{
Document doc = new Document(MyDir + "DocumentVisitor-compatible features.docx");
FieldStructurePrinter visitor = new FieldStructurePrinter();
// Wenn wir einen zusammengesetzten Knoten erhalten, der einen Dokumentbesucher akzeptiert, besucht der Besucher den akzeptierenden Knoten.
// und durchläuft dann alle untergeordneten Knoten des Knotens in einer Tiefe-zuerst-Methode.
// Der Besucher kann jeden besuchten Knoten lesen und ändern.
doc.Accept(visitor);
Console.WriteLine(visitor.GetText());
}
/// <summary>
/// Durchläuft den nicht-binären Baum der untergeordneten Knoten eines Knotens.
/// Erstellt eine Karte in Form einer Zeichenfolge aller gefundenen Feldknoten und ihrer untergeordneten Knoten.
/// </summary>
public class FieldStructurePrinter : DocumentVisitor
{
public FieldStructurePrinter()
{
mBuilder = new StringBuilder();
mVisitorIsInsideField = false;
}
public string GetText()
{
return mBuilder.ToString();
}
/// <summary>
/// Wird aufgerufen, wenn im Dokument ein Run-Knoten gefunden wird.
/// </summary>
public override VisitorAction VisitRun(Run run)
{
if (mVisitorIsInsideField) IndentAndAppendLine("[Run] \"" + run.GetText() + "\"");
return VisitorAction.Continue;
}
/// <summary>
/// Wird aufgerufen, wenn im Dokument ein FieldStart-Knoten gefunden wird.
/// </summary>
public override VisitorAction VisitFieldStart(FieldStart fieldStart)
{
IndentAndAppendLine("[Field start] FieldType: " + fieldStart.FieldType);
mDocTraversalDepth++;
mVisitorIsInsideField = true;
return VisitorAction.Continue;
}
/// <summary>
/// Wird aufgerufen, wenn im Dokument ein FieldEnd-Knoten gefunden wird.
/// </summary>
public override VisitorAction VisitFieldEnd(FieldEnd fieldEnd)
{
mDocTraversalDepth--;
IndentAndAppendLine("[Field end]");
mVisitorIsInsideField = false;
return VisitorAction.Continue;
}
/// <summary>
/// Wird aufgerufen, wenn im Dokument ein FieldSeparator-Knoten gefunden wird.
/// </summary>
public override VisitorAction VisitFieldSeparator(FieldSeparator fieldSeparator)
{
IndentAndAppendLine("[FieldSeparator]");
return VisitorAction.Continue;
}
/// <summary>
/// Hängen Sie eine Zeile an den StringBuilder an und rücken Sie sie ein, je nachdem, wie tief der Besucher ist
/// in den Baum der untergeordneten Knoten des Feldes.
/// </summary>
/// <param name="text"></param>
private void IndentAndAppendLine(string text)
{
for (int i = 0; i < mDocTraversalDepth; i++)
{
mBuilder.Append("| ");
}
mBuilder.AppendLine(text);
}
private bool mVisitorIsInsideField;
private int mDocTraversalDepth;
private readonly StringBuilder mBuilder;
}
Siehe auch
- enum VisitorAction
- class FieldStart
- class DocumentVisitor
- namensraum Aspose.Words
- Montage Aspose.Words