## FieldChar class Base class for nodes that represent field characters in a document. To learn more, visit the [Working with Fields](https://docs.aspose.com/words/cpp/working-with-fields/) documentation article. ```cpp class FieldChar : public Aspose::Words::SpecialChar ``` ## Methods | Method | Description | | --- | --- | | [Accept](../../aspose.words/specialchar/accept/)(System::SharedPtr\) override | Accepts a visitor. | | [Clone](../../aspose.words/node/clone/)(bool) | Creates a duplicate of the node. | | [get_CustomNodeId](../../aspose.words/node/get_customnodeid/)() const | Specifies custom node identifier. | | virtual [get_Document](../../aspose.words/node/get_document/)() const | Gets the document to which this node belongs. | | [get_FieldType](./get_fieldtype/)() const | Returns the type of the field. | | [get_Font](../../aspose.words/inline/get_font/)() | Provides access to the font formatting of this object. | | virtual [get_IsComposite](../../aspose.words/node/get_iscomposite/)() | Returns **true** if this node can contain other nodes. | | [get_IsDeleteRevision](../../aspose.words/inline/get_isdeleterevision/)() | Returns true if this object was deleted in Microsoft Word while change tracking was enabled. | | [get_IsDirty](./get_isdirty/)() const | Gets or sets whether the current result of the field is no longer correct (stale) due to other modifications made to the document. | | [get_IsFormatRevision](../../aspose.words/inline/get_isformatrevision/)() | Returns true if formatting of the object was changed in Microsoft Word while change tracking was enabled. | | [get_IsInsertRevision](../../aspose.words/inline/get_isinsertrevision/)() | Returns true if this object was inserted in Microsoft Word while change tracking was enabled. | | [get_IsLocked](./get_islocked/)() const | Gets or sets whether the parent field is locked (should not recalculate its result). | | [get_IsMoveFromRevision](../../aspose.words/inline/get_ismovefromrevision/)() | Returns **true** if this object was moved (deleted) in Microsoft Word while change tracking was enabled. | | [get_IsMoveToRevision](../../aspose.words/inline/get_ismovetorevision/)() | Returns **true** if this object was moved (inserted) in Microsoft Word while change tracking was enabled. | | [get_NextNode](../../aspose.words/node/get_nextnode/)() const | | | [get_NextSibling](../../aspose.words/node/get_nextsibling/)() | Gets the node immediately following this node. | | [get_NodeType](../../aspose.words/specialchar/get_nodetype/)() const override | Returns [SpecialChar](../../aspose.words/nodetype/). | | [get_ParentNode](../../aspose.words/node/get_parentnode/)() | Gets the immediate parent of this node. | | [get_ParentParagraph](../../aspose.words/inline/get_parentparagraph/)() | Retrieves the parent [Paragraph](../../aspose.words/paragraph/) of this node. | | [get_PreviousSibling](../../aspose.words/node/get_previoussibling/)() | Gets the node immediately preceding this node. | | [get_PrevNode](../../aspose.words/node/get_prevnode/)() const | | | [get_Range](../../aspose.words/node/get_range/)() | Returns a [Range](../../aspose.words/range/) object that represents the portion of a document that is contained in this node. | | [GetAncestor](../../aspose.words/node/getancestor/)(Aspose::Words::NodeType) | Gets the first ancestor of the specified [NodeType](../../aspose.words/nodetype/). | | [GetAncestorOf](../../aspose.words/node/getancestorof/)() | | | [GetField](./getfield/)() | Returns a field for the field char. | | [GetText](../../aspose.words/specialchar/gettext/)() override | Gets the special character that this node represents. | | [GetType](./gettype/)() const override | | | [Is](./is/)(const System::TypeInfo\&) const override | | | [IsAncestorNode](../../aspose.words/node/isancestornode/)(const System::SharedPtr\\&) | | | [NextPreOrder](../../aspose.words/node/nextpreorder/)(const System::SharedPtr\\&) | Gets next node according to the pre-order tree traversal algorithm. | | static [NodeTypeToString](../../aspose.words/node/nodetypetostring/)(Aspose::Words::NodeType) | A utility method that converts a node type enum value into a user friendly string. | | [PreviousPreOrder](../../aspose.words/node/previouspreorder/)(const System::SharedPtr\\&) | Gets the previous node according to the pre-order tree traversal algorithm. | | [Remove](../../aspose.words/node/remove/)() | Removes itself from the parent. | | [set_CustomNodeId](../../aspose.words/node/set_customnodeid/)(int32_t) | Setter for [Aspose::Words::Node::get_CustomNodeId](../../aspose.words/node/get_customnodeid/). | | [set_IsDirty](./set_isdirty/)(bool) | Setter for [Aspose::Words::Fields::FieldChar::get_IsDirty](./get_isdirty/). | | [set_IsLocked](./set_islocked/)(bool) | Setter for [Aspose::Words::Fields::FieldChar::get_IsLocked](./get_islocked/). | | [set_NextNode](../../aspose.words/node/set_nextnode/)(const System::SharedPtr\\&) | | | [set_PrevNode](../../aspose.words/node/set_prevnode/)(const System::SharedPtr\\&) | | | [SetParent](../../aspose.words/node/setparent/)(const System::SharedPtr\\&) | | | [ToString](../../aspose.words/node/tostring/)(Aspose::Words::SaveFormat) | Exports the content of the node into a string in the specified format. | | [ToString](../../aspose.words/node/tostring/)(const System::SharedPtr\\&) | Exports the content of the node into a string using the specified save options. | | static [Type](./type/)() | | ## Remarks A complete field in a Microsoft Word document is a complex structure consisting of a field start character, field code, field separator character, field result and field end character. Some fields only have field start, field code and field end. To easily insert a new field into a document, use the [InsertField()](../) method. ## Examples Shows how to work with a [FieldStart](../fieldstart/) node. ```cpp auto doc = System::MakeObject(); auto builder = System::MakeObject(doc); auto field = System::ExplicitCast(builder->InsertField(FieldType::FieldDate, true)); field->get_Format()->set_DateTimeFormat(u"dddd, MMMM dd, yyyy"); field->Update(); System::SharedPtr fieldStart = field->get_Start(); ASSERT_EQ(FieldType::FieldDate, fieldStart->get_FieldType()); ASPOSE_ASSERT_EQ(false, fieldStart->get_IsDirty()); ASPOSE_ASSERT_EQ(false, fieldStart->get_IsLocked()); // Retrieve the facade object which represents the field in the document. field = System::ExplicitCast(fieldStart->GetField()); ASPOSE_ASSERT_EQ(false, field->get_IsLocked()); ASSERT_EQ((u" DATE \\@ \"dddd, MMMM dd, yyyy\""), field->GetFieldCode()); // Update the field to show the current date. field->Update(); ``` ## See Also * Class [SpecialChar](../../aspose.words/specialchar/) * Namespace [Aspose::Words::Fields](../) * Library [Aspose.Words for C++](../../)