FieldAdvance
Содержание
[
Скрывать
]FieldAdvance class
Реализует поле ADVANCE.
Чтобы узнать больше, посетитеРабота с полями документальная статья.
public class FieldAdvance : Field
Конструкторы
| Имя | Описание |
|---|---|
| FieldAdvance() | Конструктор по умолчанию. |
Характеристики
| Имя | Описание |
|---|---|
| DisplayResult { get; } | Получает текст, представляющий отображаемый результат поля. |
| DownOffset { get; set; } | Возвращает или задает количество точек, на которое следует переместить вниз текст, следующий за полем. |
| End { get; } | Получает узел, представляющий конец поля. |
| Format { get; } | ПолучаетFieldFormatобъект, который обеспечивает типизированный доступ к форматированию поля. |
| HorizontalPosition { get; set; } | Возвращает или задает количество точек, на которое текст, следующий за полем, должен быть перемещен по горизонтали от левого края столбца, рамки или текстового поля. |
| IsDirty { get; set; } | Возвращает или задает, является ли текущий результат поля более неверным (устаревшим) из-за других изменений, внесенных в документ. |
| IsLocked { get; set; } | Возвращает или задает, заблокировано ли поле (не следует пересчитывать его результат). |
| LeftOffset { get; set; } | Возвращает или задает количество точек, на которое текст, следующий за полем, должен быть перемещен влево. |
| LocaleId { get; set; } | Получает или задает LCID поля. |
| Result { get; set; } | Возвращает или задает текст, который находится между разделителем полей и концом поля. |
| RightOffset { get; set; } | Возвращает или задает количество точек, на которое текст, следующий за полем, должен быть перемещен вправо. |
| Separator { get; } | Получает узел, представляющий разделитель полей. Может бытьнулевой . |
| Start { get; } | Получает узел, представляющий начало поля. |
| virtual Type { get; } | Получает тип поля Microsoft Word. |
| UpOffset { get; set; } | Возвращает или задает количество точек, на которое следует переместить вверх текст, следующий за полем. |
| VerticalPosition { get; set; } | Возвращает или задает количество точек, на которое текст, следующий за полем, должен быть перемещен вертикально от верхнего края страницы. |
Методы
| Имя | Описание |
|---|---|
| GetFieldCode() | Возвращает текст между началом поля и разделителем полей (или концом поля, если разделитель отсутствует). Включаются как код поля, так и результат поля дочерних полей. |
| GetFieldCode(bool) | Возвращает текст между началом поля и разделителем полей (или концом поля, если разделитель отсутствует). |
| Remove() | Удаляет поле из документа. Возвращает узел сразу после поля. Если конец поля — последний child его родительского узла, возвращает его родительский абзац. Если поле уже удалено, возвращаетнулевой . |
| Unlink() | Выполняет отмену связи поля. |
| Update() | Выполняет обновление поля. Выдает исключение, если поле уже обновляется. |
| Update(bool) | Выполняет обновление поля. Выдает исключение, если поле уже обновляется. |
Примечания
Перемещает начальную точку, в которой отображается текст, лексически следующий за полем, вправо или влево, вверх или вниз или в определенное горизонтальное или вертикальное положение.
Примеры
Показывает, как вставить поле ADVANCE и редактировать его свойства.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Write("This text is in its normal place.");
// Ниже приведены два способа использования поля ADVANCE для настройки положения текста, следующего за ним.
// Эффекты поля ADVANCE продолжают применяться до тех пор, пока не закончится абзац,
// или другое поле ADVANCE обновляет значения смещения/координат.
// 1 - Укажите смещение направления:
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 - Переместить текст в позицию, указанную координатами:
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");
Смотрите также
- class Field
- пространство имен Aspose.Words.Fields
- сборка Aspose.Words