Класс Aspose::Words::Fields::FieldDate

FieldDate class

Реализует поле DATE. Чтобы узнать больше, посетите статью документации Working with Fields.

class FieldDate : public Aspose::Words::Fields::Field,
                  public Aspose::Words::Fields::IFieldCodeTokenInfoProvider,
                  public Aspose::Words::Fields::IFieldWithCalendar

Методы

МетодОписание
get_DisplayResult()Получает текст, представляющий отображаемый результат поля.
get_End() constПолучает узел, представляющий конец поля.
get_FieldEnd() constПолучает узел, представляющий конец поля.
get_FieldStart() constПолучает узел, представляющий начало поля.
get_Format()Получает объект FieldFormat, который предоставляет типизированный доступ к форматированию поля.
get_IsDirty()Получает или задает, является ли текущий результат поля более некорректным (устаревшим) из‑за других изменений, внесённых в документ.
get_IsLocked()Получает или задает, заблокировано ли поле (не должно пересчитывать свой результат).
get_LocaleId()Получает или задает LCID поля.
get_Result()Получает или задает текст, находящийся между разделителем поля и его концом.
get_Separator()Получает узел, представляющий разделитель поля. Может быть null.
get_Start() constПолучает узел, представляющий начало поля.
virtual get_Type() constПолучает тип поля Microsoft Word.
get_UseLastFormat()Получает или задает, использовать ли формат, последний использованный хост-приложением при вставке нового поля DATE.
get_UseLunarCalendar() overrideПолучает или задает, использовать ли календарь Hijri Lunar или календарь Hebrew Lunar.
get_UseSakaEraCalendar() overrideПолучает или задает, использовать ли календарь Saka Era.
get_UseUmAlQuraCalendar() overrideПолучает или задает, использовать ли календарь Um-al-Qura.
GetFieldCode()Возвращает текст между началом поля и разделителем поля (или концом поля, если разделитель отсутствует). Включены как код поля, так и результат дочерних полей.
GetFieldCode(bool)Возвращает текст между началом поля и разделителем поля (или концом поля, если разделитель отсутствует).
GetType() const override
Is(const System::TypeInfo&) const override
virtual Remove()Удаляет поле из документа. Возвращает узел сразу после поля. Если конец поля является последним дочерним элементом его родительского узла, возвращает родительский абзац. Если поле уже удалено, возвращает null.
set_IsDirty(bool)Сеттер для Aspose::Words::Fields::Field::get_IsDirty.
set_IsLocked(bool)Сеттер для Aspose::Words::Fields::Field::get_IsLocked.
set_LocaleId(int32_t)Сеттер для Aspose::Words::Fields::Field::get_LocaleId.
set_Result(const System::String&)Сеттер для Aspose::Words::Fields::Field::get_Result.
set_UseLastFormat(bool)Сеттер для Aspose::Words::Fields::FieldDate::get_UseLastFormat.
set_UseLunarCalendar(bool)Сеттер для Aspose::Words::Fields::FieldDate::get_UseLunarCalendar.
set_UseSakaEraCalendar(bool)Сеттер для Aspose::Words::Fields::FieldDate::get_UseSakaEraCalendar.
set_UseUmAlQuraCalendar(bool)Сеттер для Aspose::Words::Fields::FieldDate::get_UseUmAlQuraCalendar.
static Type()
Unlink()Выполняет отсоединение поля.
Update()Выполняет обновление поля. Вызывает исключение, если поле уже обновляется.
Update(bool)Выполняет обновление поля. Выбрасывает исключение, если поле уже обновляется.

Примеры

Показывает, как использовать поля DATE для отображения дат в соответствии с различными типами календарей.

auto doc = System::MakeObject<Aspose::Words::Document>();
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);

// Если мы хотим, чтобы текст в документе всегда отображал правильную дату, мы можем использовать поле DATE.
// Ниже представлены три типа культурных календарей, которые поле DATE может использовать для отображения даты.
// 1 -  Исламский лунный календарь:
auto field = System::ExplicitCast<Aspose::Words::Fields::FieldDate>(builder->InsertField(Aspose::Words::Fields::FieldType::FieldDate, true));
field->set_UseLunarCalendar(true);
ASSERT_EQ(u" DATE  \\h", field->GetFieldCode());
builder->Writeln();

// 2 -  Календарь Umm al-Qura:
field = System::ExplicitCast<Aspose::Words::Fields::FieldDate>(builder->InsertField(Aspose::Words::Fields::FieldType::FieldDate, true));
field->set_UseUmAlQuraCalendar(true);
ASSERT_EQ(u" DATE  \\u", field->GetFieldCode());
builder->Writeln();

// 3 -  Индийский национальный календарь:
field = System::ExplicitCast<Aspose::Words::Fields::FieldDate>(builder->InsertField(Aspose::Words::Fields::FieldType::FieldDate, true));
field->set_UseSakaEraCalendar(true);
ASSERT_EQ(u" DATE  \\s", field->GetFieldCode());
builder->Writeln();

// Вставьте поле DATE и задайте его тип календаря, последний использованный хост-приложением.
// В Microsoft Word тип будет тем, который был использован последним в диалоговом окне Вставка -> Текст -> Дата и время.
field = System::ExplicitCast<Aspose::Words::Fields::FieldDate>(builder->InsertField(Aspose::Words::Fields::FieldType::FieldDate, true));
field->set_UseLastFormat(true);
ASSERT_EQ(u" DATE  \\l", field->GetFieldCode());
builder->Writeln();

doc->UpdateFields();
doc->Save(get_ArtifactsDir() + u"Field.DATE.docx");

См. также

Aspose::Words::Fields::FieldDatabaseDataTable класс класс Aspose::Words::Fields::FieldDde