FieldSeparator
Содержание
[
Скрывать
]FieldSeparator class
Представляет разделитель полей Word, который отделяет код поля от результата поля.
Чтобы узнать больше, посетитеРабота с полями статья документации.
public class FieldSeparator : FieldChar
Характеристики
Имя | Описание |
---|---|
CustomNodeId { get; set; } | Указывает пользовательский идентификатор узла. |
virtual Document { get; } | Получает документ, которому принадлежит этот узел. |
FieldType { get; } | Возвращает тип поля. |
Font { get; } | Предоставляет доступ к форматированию шрифта этого объекта. |
virtual IsComposite { get; } | Возвращаетистинный если этот узел может содержать другие узлы. |
IsDeleteRevision { get; } | Возвращает true, если этот объект был удален в Microsoft Word при включенном отслеживании изменений. |
IsDirty { get; set; } | Получает или устанавливает, является ли текущий результат поля более неправильным (устаревшим) из-за других изменений , внесенных в документ. |
IsFormatRevision { get; } | Возвращает true, если форматирование объекта было изменено в Microsoft Word при включенном отслеживании изменений. |
IsInsertRevision { get; } | Возвращает true, если этот объект был вставлен в Microsoft Word при включенном отслеживании изменений. |
IsLocked { get; set; } | Получает или задает, заблокировано ли родительское поле (не следует пересчитывать его результат). |
IsMoveFromRevision { get; } | Возвращаетистинный если этот объект был перемещен (удален) в Microsoft Word при включенном отслеживании изменений. |
IsMoveToRevision { get; } | Возвращаетистинный если этот объект был перемещен (вставлен) в Microsoft Word при включенном отслеживании изменений. |
NextSibling { get; } | Получает узел, следующий сразу за этим узлом. |
override NodeType { get; } | ВозвращаетFieldSeparator . |
ParentNode { get; } | Получает непосредственного родителя этого узла. |
ParentParagraph { get; } | Получает родительский элементParagraph этого узла. |
PreviousSibling { get; } | Получает узел, непосредственно предшествующий этому узлу. |
Range { get; } | ВозвращаетRange объект, представляющий часть документа, содержащуюся в этом узле. |
Методы
Имя | Описание |
---|---|
override Accept(DocumentVisitor) | Принимает посетителя. |
Clone(bool) | Создает дубликат узла. |
GetAncestor(NodeType) | Получает первого предка указанногоNodeType . |
GetAncestor(Type) | Получает первого предка указанного типа объекта. |
GetField() | Возвращает поле для поля char. |
override GetText() | Получает специальный символ, который представляет этот узел. |
NextPreOrder(Node) | Получает следующий узел в соответствии с алгоритмом обхода дерева предварительного заказа. |
PreviousPreOrder(Node) | Получает предыдущий узел в соответствии с алгоритмом обхода дерева предварительного заказа. |
Remove() | Удаляет себя от родителя. |
ToString(SaveFormat) | Экспортирует содержимое узла в строку указанного формата. |
ToString(SaveOptions) | Экспортирует содержимое узла в строку, используя указанные параметры сохранения. |
Примечания
FieldSeparator
является узлом встроенного уровня и представлен FieldSeparatorChar
управляющий символ в документе.
FieldSeparator
может быть только ребенкомParagraph
.
Полное поле в документе Microsoft Word представляет собой сложную структуру, состоящую из начального символа поля, кода поля, символа разделителя полей, поля result и конечного символа поля. Некоторые поля имеют только начало поля, код поля и конец поля.
Чтобы легко вставить новое поле в документ, используйте командуInsertField
метод.
Примеры
Показывает, как работать с коллекцией полей.
public void FieldCollection()
{
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertField(" DATE \\@ \"dddd, d MMMM yyyy\" ");
builder.InsertField(" TIME ");
builder.InsertField(" REVNUM ");
builder.InsertField(" AUTHOR \"John Doe\" ");
builder.InsertField(" SUBJECT \"My Subject\" ");
builder.InsertField(" QUOTE \"Hello world!\" ");
doc.UpdateFields();
FieldCollection fields = doc.Range.Fields;
Assert.AreEqual(6, fields.Count);
// Перебираем коллекцию полей, выводим содержимое и печатаем
// каждого поля с использованием пользовательской реализации посетителя.
FieldVisitor fieldVisitor = new FieldVisitor();
using (IEnumerator<Field> fieldEnumerator = fields.GetEnumerator())
{
while (fieldEnumerator.MoveNext())
{
if (fieldEnumerator.Current != null)
{
fieldEnumerator.Current.Start.Accept(fieldVisitor);
fieldEnumerator.Current.Separator?.Accept(fieldVisitor);
fieldEnumerator.Current.End.Accept(fieldVisitor);
}
else
{
Console.WriteLine("There are no fields in the document.");
}
}
}
Console.WriteLine(fieldVisitor.GetText());
}
/// <summary>
/// Реализация посетителя документа, который печатает информацию о поле.
/// </summary>
public class FieldVisitor : DocumentVisitor
{
public FieldVisitor()
{
mBuilder = new StringBuilder();
}
/// <summary>
/// Получает открытый текст документа, накопленный посетителем.
/// </summary>
public string GetText()
{
return mBuilder.ToString();
}
/// <summary>
/// Вызывается, когда в документе встречается узел FieldStart.
/// </summary>
public override VisitorAction VisitFieldStart(FieldStart fieldStart)
{
mBuilder.AppendLine("Found field: " + fieldStart.FieldType);
mBuilder.AppendLine("\tField code: " + fieldStart.GetField().GetFieldCode());
mBuilder.AppendLine("\tDisplayed as: " + fieldStart.GetField().Result);
return VisitorAction.Continue;
}
/// <summary>
/// Вызывается, когда в документе встречается узел FieldSeparator.
/// </summary>
public override VisitorAction VisitFieldSeparator(FieldSeparator fieldSeparator)
{
mBuilder.AppendLine("\tFound separator: " + fieldSeparator.GetText());
return VisitorAction.Continue;
}
/// <summary>
/// Вызывается, когда в документе встречается узел FieldEnd.
/// </summary>
public override VisitorAction VisitFieldEnd(FieldEnd fieldEnd)
{
mBuilder.AppendLine("End of field: " + fieldEnd.FieldType);
return VisitorAction.Continue;
}
private readonly StringBuilder mBuilder;
}
Смотрите также
- class FieldChar
- пространство имен Aspose.Words.Fields
- сборка Aspose.Words