Aspose::Words::Fields::FormField Class Reference

Represents a single form field. More...

#include "Aspose.Words.Cpp/Model/Fields/FormFields/FormField.h"

Inherits Aspose::Words::SpecialChar.

Public Member Functions

virtual Aspose::Words::NodeType get_NodeType () const
 Returns NodeType.FormField. More...
 
System::String get_Name ()
 Gets or sets the form field name. More...
 
void set_Name (System::String value)
 Setter for Aspose::Words::Fields::FormField::get_Name. More...
 
Aspose::Words::Fields::FieldType get_Type ()
 Returns the form field type. More...
 
System::String get_Result ()
 Gets or sets a string that represents the result of this form field. More...
 
void set_Result (System::String value)
 Setter for Aspose::Words::Fields::FormField::get_Result. More...
 
System::String get_StatusText ()
 Returns or sets the text that's displayed in the status bar when a form field has the focus. More...
 
void set_StatusText (System::String value)
 Setter for Aspose::Words::Fields::FormField::get_StatusText. More...
 
bool get_OwnStatus ()
 Specifies the source of the text that's displayed in the status bar when a form field has the focus. More...
 
void set_OwnStatus (bool value)
 Setter for Aspose::Words::Fields::FormField::get_OwnStatus. More...
 
System::String get_HelpText ()
 Returns or sets the text that's displayed in a message box when the form field has the focus and the user presses F1. More...
 
void set_HelpText (System::String value)
 Setter for Aspose::Words::Fields::FormField::get_HelpText. More...
 
bool get_OwnHelp ()
 Specifies the source of the text that's displayed in a message box when a form field has the focus and the user presses F1. More...
 
void set_OwnHelp (bool value)
 Setter for Aspose::Words::Fields::FormField::get_OwnHelp. More...
 
bool get_CalculateOnExit ()
 True if references to the specified form field are automatically updated whenever the field is exited. More...
 
void set_CalculateOnExit (bool value)
 Setter for Aspose::Words::Fields::FormField::get_CalculateOnExit. More...
 
System::String get_EntryMacro ()
 Returns or sets an entry macro name for the form field. More...
 
void set_EntryMacro (System::String value)
 Setter for Aspose::Words::Fields::FormField::get_EntryMacro. More...
 
System::String get_ExitMacro ()
 Returns or sets an exit macro name for the form field. More...
 
void set_ExitMacro (System::String value)
 Setter for Aspose::Words::Fields::FormField::get_ExitMacro. More...
 
bool get_Enabled ()
 True if a form field is enabled. More...
 
void set_Enabled (bool value)
 Setter for Aspose::Words::Fields::FormField::get_Enabled. More...
 
System::String get_TextInputFormat ()
 Returns or sets the text formatting for a text form field. More...
 
void set_TextInputFormat (System::String value)
 Setter for Aspose::Words::Fields::FormField::get_TextInputFormat. More...
 
Aspose::Words::Fields::TextFormFieldType get_TextInputType ()
 Gets or sets the type of a text form field. More...
 
void set_TextInputType (Aspose::Words::Fields::TextFormFieldType value)
 Setter for Aspose::Words::Fields::FormField::get_TextInputType. More...
 
System::String get_TextInputDefault ()
 Gets or sets the default string or a calculation expression of a text form field. More...
 
void set_TextInputDefault (System::String value)
 Setter for Aspose::Words::Fields::FormField::get_TextInputDefault. More...
 
int32_t get_MaxLength ()
 Maximum length for the text field. Zero when the length is not limited. More...
 
void set_MaxLength (int32_t value)
 Setter for Aspose::Words::Fields::FormField::get_MaxLength. More...
 
System::SharedPtr< Aspose::Words::Fields::DropDownItemCollectionget_DropDownItems ()
 Provides access to the items of a dropdown form field. More...
 
int32_t get_DropDownSelectedIndex ()
 Gets or sets the index specifying the currently selected item in a dropdown form field. More...
 
void set_DropDownSelectedIndex (int32_t value)
 Setter for Aspose::Words::Fields::FormField::get_DropDownSelectedIndex. More...
 
bool get_Checked ()
 Gets or sets the checked status of the check box form field. Default value for this property is false. More...
 
void set_Checked (bool value)
 Setter for Aspose::Words::Fields::FormField::get_Checked. More...
 
bool get_Default ()
 Gets or sets the default value of the check box form field. Default value for this property is false. More...
 
void set_Default (bool value)
 Setter for Aspose::Words::Fields::FormField::get_Default. More...
 
bool get_IsCheckBoxExactSize ()
 Gets or sets the boolean value that indicates whether the size of the textbox is automatic or specified explicitly. More...
 
void set_IsCheckBoxExactSize (bool value)
 Setter for Aspose::Words::Fields::FormField::get_IsCheckBoxExactSize. More...
 
double get_CheckBoxSize ()
 Gets or sets the size of the checkbox in points. Has effect only when Aspose::Words::Fields::FormField::get_IsCheckBoxExactSize is true. More...
 
void set_CheckBoxSize (double value)
 Setter for Aspose::Words::Fields::FormField::get_CheckBoxSize. More...
 
virtual bool Accept (System::SharedPtr< Aspose::Words::DocumentVisitor > visitor)
 Accepts a visitor. More...
 
void RemoveField ()
 Removes the complete form field, not just the form field special character. More...
 
void SetTextInputValue (System::SharedPtr< System::Object > newValue)
 Applies the text format specified in Aspose::Words::Fields::FormField::get_TextInputFormat and stores the value in Aspose::Words::Fields::FormField::get_Result. More...
 
- Public Member Functions inherited from Aspose::Words::SpecialChar
virtual System::String GetText ()
 Gets the special character that this node represents. More...
 
- Public Member Functions inherited from Aspose::Words::Inline
System::SharedPtr< Aspose::Words::Paragraphget_ParentParagraph ()
 Retrieves the parent Aspose::Words::Paragraph of this node. More...
 
System::SharedPtr< Aspose::Words::Fontget_Font ()
 Provides access to the font formatting of this object. More...
 
bool get_IsInsertRevision ()
 Returns true if this object was inserted in Microsoft Word while change tracking was enabled. More...
 
bool get_IsDeleteRevision ()
 Returns true if this object was deleted in Microsoft Word while change tracking was enabled. More...
 
bool get_IsMoveFromRevision ()
 Returns true if this object was moved (deleted) in Microsoft Word while change tracking was enabled. More...
 
bool get_IsMoveToRevision ()
 Returns true if this object was moved (inserted) in Microsoft Word while change tracking was enabled. More...
 
bool get_IsFormatRevision ()
 Returns true if formatting of the object was changed in Microsoft Word while change tracking was enabled. More...
 
System::SharedPtr< Aspose::Words::RunPr > get_RunPr_IInline ()
 
void set_RunPr_IInline (System::SharedPtr< Aspose::Words::RunPr > value)
 
System::SharedPtr< Aspose::Words::Paragraphget_ParentParagraph_IInline ()
 
System::SharedPtr< Aspose::Words::DocumentBaseget_Document_IInline ()
 
System::SharedPtr< Aspose::Words::Revisions::EditRevision > get_InsertRevision ()
 
void set_InsertRevision (System::SharedPtr< Aspose::Words::Revisions::EditRevision > value)
 
System::SharedPtr< Aspose::Words::Revisions::EditRevision > get_DeleteRevision ()
 
void set_DeleteRevision (System::SharedPtr< Aspose::Words::Revisions::EditRevision > value)
 
System::SharedPtr< Aspose::Words::Revisions::MoveRevision > get_MoveFromRevision ()
 
void set_MoveFromRevision (System::SharedPtr< Aspose::Words::Revisions::MoveRevision > value)
 
System::SharedPtr< Aspose::Words::Revisions::MoveRevision > get_MoveToRevision ()
 
void set_MoveToRevision (System::SharedPtr< Aspose::Words::Revisions::MoveRevision > value)
 
System::SharedPtr< Aspose::Words::RunPr > GetExpandedRunPr_IInline (Aspose::Words::RunPrExpandFlags flags)
 
System::SharedPtr< System::ObjectGetDirectRunAttr (int32_t fontAttr)
 
System::SharedPtr< System::ObjectFetchInheritedRunAttr (int32_t fontAttr)
 
void SetRunAttr (int32_t fontAttr, System::SharedPtr< System::Object > value)
 
void RemoveRunAttr (int32_t key)
 
void ClearRunAttrs ()
 
- Public Member Functions inherited from Aspose::Words::Node
System::SharedPtr< Aspose::Words::CompositeNodeget_ParentNode ()
 Gets the immediate parent of this node. More...
 
System::SharedPtr< Aspose::Words::DocumentBaseget_Document ()
 Gets the document to which this node belongs. More...
 
System::SharedPtr< Aspose::Words::Nodeget_PreviousSibling ()
 Gets the node immediately preceding this node. More...
 
System::SharedPtr< Aspose::Words::Nodeget_NextSibling ()
 Gets the node immediately following this node. More...
 
virtual bool get_IsComposite ()
 Returns true if this node can contain other nodes. More...
 
System::SharedPtr< Aspose::Words::Rangeget_Range ()
 Returns a Range object that represents the portion of a document that is contained in this node. More...
 
System::SharedPtr< Aspose::Words::NodeClone (bool isCloneChildren)
 
template<typename T >
GetAncestorOf ()
 
System::SharedPtr< Aspose::Words::CompositeNodeGetAncestor (Aspose::Words::NodeType ancestorType)
 Gets the first ancestor of the specified Aspose::Words::NodeType. More...
 
void Remove ()
 Removes itself from the parent. More...
 
System::SharedPtr< Aspose::Words::NodeNextPreOrder (System::SharedPtr< Aspose::Words::Node > rootNode)
 Gets next node according to the pre-order tree traversal algorithm. More...
 
System::SharedPtr< Aspose::Words::NodePreviousPreOrder (System::SharedPtr< Aspose::Words::Node > rootNode)
 Gets the previous node according to the pre-order tree traversal algorithm. More...
 
System::String ToString (Aspose::Words::SaveFormat saveFormat)
 Exports the content of the node into a string in the specified format. More...
 
System::String ToString (System::SharedPtr< Aspose::Words::Saving::SaveOptions > saveOptions)
 Exports the content of the node into a string using the specified save options. More...
 
- Public Member Functions inherited from System::Object
 Object ()
 Creates object. Initializes all internal data structures. More...
 
virtual ~Object ()
 Destroys object. Frees all internal data structures. More...
 
 Object (Object const &x)
 Copy constructor. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...
 
Objectoperator= (Object const &x)
 Assignment operator. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...
 
ObjectSharedRefAdded ()
 Increments shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
int SharedRefRemovedSafe ()
 Decrements and returns shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
int RemovedSharedRefs (int count)
 Decreases shared reference count by specified value. More...
 
Detail::SmartPtrCounter * WeakRefAdded ()
 Increments weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
void WeakRefRemoved ()
 Decrements weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
Detail::SmartPtrCounter * GetCounter ()
 Gets reference counter data structure associated with the object. More...
 
int SharedCount () const
 Gets current value of shared refernce counter. More...
 
void Lock ()
 Implements C# lock() statement locking. Call directly or use LockContext sentry object. More...
 
void Unlock ()
 Implements C# lock() statement unlocking. Call directly or use LockContext sentry object. More...
 
virtual bool Equals (ptr obj)
 Compares objects using C# Object.Equals semantics. More...
 
virtual int GetHashCode () const
 Analog of C# Object.GetHashCode() method. Enables hashing of custom objects. More...
 
virtual String ToString () ASPOSE_CONST
 Analog of C# Object.ToString() method. Enables converting custom objects to string. More...
 
virtual ptr MemberwiseClone () const
 Analog of C# Object.MemberwiseClone() method. Enables cloning custom types. More...
 
virtual const TypeInfoGetType () const
 Gets actual type of object. Analog of C# System.Object.GetType() call. More...
 
virtual bool Is (const TypeInfo &targetType) const
 Check if object represents an instance of type described by targetType. Analog of C# 'is' operator. More...
 
virtual void SetTemplateWeakPtr (unsigned int argument)
 Set n'th template argument a weak pointer (rather than shared). Allows switching pointers in containers to weak mode. More...
 

Additional Inherited Members

- Public Types inherited from System::Object
typedef SmartPtr< Objectptr
 Alias for smart pointer type. More...
 
typedef System::Details::SharedMembersType shared_members_type
 structure to keep list of shared pointers contained in object. More...
 
- Static Public Member Functions inherited from Aspose::Words::Node
static System::String NodeTypeToString (Aspose::Words::NodeType nodeType)
 A utility method that converts a node type enum value into a user friendly string. More...
 
- Static Public Member Functions inherited from System::Object
static bool ReferenceEquals (ptr const &objA, ptr const &objB)
 Compares objects by reference. More...
 
template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type ReferenceEquals (T const &objA, T const &objB)
 Compares objects by reference. More...
 
template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type ReferenceEquals (T const &objA, std::nullptr_t)
 Reference-compares value type object with nullptr. More...
 
template<typename T1 , typename T2 >
static std::enable_if< IsSmartPtr< T1 >::value &&IsSmartPtr< T2 >::value, bool >::type Equals (T1 const &objA, T2 const &objB)
 Compares reference type objects in C# style. More...
 
template<typename T1 , typename T2 >
static std::enable_if<!IsSmartPtr< T1 >::value &&!IsSmartPtr< T2 >::value, bool >::type Equals (T1 const &objA, T2 const &objB)
 Compares value type objects in C# style. More...
 
static const TypeInfoType ()
 Impleemnts C# typeof(System.Object) construct. More...
 
template<>
bool Equals (float const &objA, float const &objB)
 
template<>
bool Equals (double const &objA, double const &objB)
 
template<>
bool ReferenceEquals (String const &str, std::nullptr_t)
 
template<>
bool ReferenceEquals (String const &str1, String const &str2)
 

Detailed Description

Represents a single form field.

Microsoft Word provides the following form fields: checkbox, text input and dropdown (combobox).

FormField is an inline-node and can only be a child of Paragraph.

FormField is represented in a document by a special character and positioned as a character within a line of text.

A complete form field in a Word document is a complex structure represented by several nodes: field start, field code such as FORMTEXT, form field data, field separator, field result, field end and a bookmark. To programmatically create form fields in a Word document use DocumentBuilder.InsertCheckBox, DocumentBuilder.InsertTextInput and DocumentBuilder.InsertComboBox which make sure all of the form field nodes are created in a correct order and in a suitable state.

Member Function Documentation

◆ Accept()

virtual bool Aspose::Words::Fields::FormField::Accept ( System::SharedPtr< Aspose::Words::DocumentVisitor visitor)
virtual

Accepts a visitor.

Calls DocumentVisitor.VisitFormField.

For more info see the Visitor design pattern.

Parameters
visitorThe visitor that will visit the node.
Returns
False if the visitor requested the enumeration to stop.

Reimplemented from Aspose::Words::SpecialChar.

◆ get_CalculateOnExit()

bool Aspose::Words::Fields::FormField::get_CalculateOnExit ( )

True if references to the specified form field are automatically updated whenever the field is exited.

Setting CalculateOnExit only affects the behavior of the form field when the document is opened in Microsoft Word. Aspose.Words never updates references to the form field.

◆ get_CheckBoxSize()

double Aspose::Words::Fields::FormField::get_CheckBoxSize ( )

Gets or sets the size of the checkbox in points. Has effect only when Aspose::Words::Fields::FormField::get_IsCheckBoxExactSize is true.

Applicable for a check box form field only.

See also
Aspose::Words::Fields::FormField::get_IsCheckBoxExactSize

◆ get_Checked()

bool Aspose::Words::Fields::FormField::get_Checked ( )

Gets or sets the checked status of the check box form field. Default value for this property is false.

Applicable for a check box form field only.

◆ get_Default()

bool Aspose::Words::Fields::FormField::get_Default ( )

Gets or sets the default value of the check box form field. Default value for this property is false.

Applicable for a check box form field only.

◆ get_DropDownItems()

System::SharedPtr<Aspose::Words::Fields::DropDownItemCollection> Aspose::Words::Fields::FormField::get_DropDownItems ( )

Provides access to the items of a dropdown form field.

Microsoft Word allows maximum 25 items in a dropdown form field.

◆ get_DropDownSelectedIndex()

int32_t Aspose::Words::Fields::FormField::get_DropDownSelectedIndex ( )

Gets or sets the index specifying the currently selected item in a dropdown form field.

◆ get_Enabled()

bool Aspose::Words::Fields::FormField::get_Enabled ( )

True if a form field is enabled.

If a form field is enabled, its contents can be changed as the form is filled in.

◆ get_EntryMacro()

System::String Aspose::Words::Fields::FormField::get_EntryMacro ( )

Returns or sets an entry macro name for the form field.

The entry macro runs when the form field gets the focus in Microsoft Word.

Microsoft Word allows strings with at most 32 characters.

◆ get_ExitMacro()

System::String Aspose::Words::Fields::FormField::get_ExitMacro ( )

Returns or sets an exit macro name for the form field.

The exit macro runs when the form field loses the focus in Microsoft Word.

Microsoft Word allows strings with at most 32 characters.

◆ get_HelpText()

System::String Aspose::Words::Fields::FormField::get_HelpText ( )

Returns or sets the text that's displayed in a message box when the form field has the focus and the user presses F1.

If the OwnHelp property is set to True, HelpText specifies the text string value. If OwnHelp is set to False, HelpText specifies the name of an AutoText entry that contains help text for the form field.

Microsoft Word allows strings with at most 255 characters.

◆ get_IsCheckBoxExactSize()

bool Aspose::Words::Fields::FormField::get_IsCheckBoxExactSize ( )

Gets or sets the boolean value that indicates whether the size of the textbox is automatic or specified explicitly.

Applicable for a check box form field only.

See also
Aspose::Words::Fields::FormField::get_CheckBoxSize

◆ get_MaxLength()

int32_t Aspose::Words::Fields::FormField::get_MaxLength ( )

Maximum length for the text field. Zero when the length is not limited.

◆ get_Name()

System::String Aspose::Words::Fields::FormField::get_Name ( )

Gets or sets the form field name.

Microsoft Word allows strings with at most 20 characters.

◆ get_NodeType()

virtual Aspose::Words::NodeType Aspose::Words::Fields::FormField::get_NodeType ( ) const
virtual

Returns NodeType.FormField.

Reimplemented from Aspose::Words::SpecialChar.

◆ get_OwnHelp()

bool Aspose::Words::Fields::FormField::get_OwnHelp ( )

Specifies the source of the text that's displayed in a message box when a form field has the focus and the user presses F1.

If True, the text specified by the HelpText property is displayed. If False, the text in the AutoText entry specified by the HelpText property is displayed.

◆ get_OwnStatus()

bool Aspose::Words::Fields::FormField::get_OwnStatus ( )

Specifies the source of the text that's displayed in the status bar when a form field has the focus.

If true, the text specified by the StatusText property is displayed. If false, the text of the AutoText entry specified by the StatusText property is displayed.

◆ get_Result()

System::String Aspose::Words::Fields::FormField::get_Result ( )

Gets or sets a string that represents the result of this form field.

For a text form field the result is the text that is in the field.

For a checkbox form field the result can be "1" or "0" to indicate checked or unchecked.

For a dropdown form field the result is the string selected in the dropdown.

Setting Aspose::Words::Fields::FormField::get_Result for a text form field does not apply the text format specified in Aspose::Words::Fields::FormField::get_TextInputFormat. If you want to set a value and apply the format, use the Aspose::Words::Fields::FormField::SetTextInputValue(System::SharedPtr<$System::Object>) method.

◆ get_StatusText()

System::String Aspose::Words::Fields::FormField::get_StatusText ( )

Returns or sets the text that's displayed in the status bar when a form field has the focus.

If the OwnStatus property is set to true, the StatusText property specifies the status bar text. If the OwnStatus property is set to false, the StatusText property specifies the name of an AutoText entry that contains status bar text for the form field.

Microsoft Word allows strings with at most 138 characters.

◆ get_TextInputDefault()

System::String Aspose::Words::Fields::FormField::get_TextInputDefault ( )

Gets or sets the default string or a calculation expression of a text form field.

The meaning of this property depends on the value of the Aspose::Words::Fields::FormField::get_TextInputType property.

When Aspose::Words::Fields::FormField::get_TextInputType is Aspose::Words::Fields::TextFormFieldType::Regular or Aspose::Words::Fields::TextFormFieldType::Number, this string specifies the default string for the text form field. This string is the content that Microsoft Word will display in the document when the form field is empty.

When Aspose::Words::Fields::FormField::get_TextInputType is Aspose::Words::Fields::TextFormFieldType::Calculated, then this string holds the expression to be calculated. The expression needs to be a formula valid according to Microsoft Word formula field requirements. When you set a new expression using this property, Aspose.Words calculates the formula result automatically and inserts it into the form field.

Microsoft Word allows strings with at most 255 characters.

◆ get_TextInputFormat()

System::String Aspose::Words::Fields::FormField::get_TextInputFormat ( )

Returns or sets the text formatting for a text form field.

If the text form field contains regular text, then valid format strings are "", "UPPERCASE", "LOWERCASE", "FIRST CAPITAL" and "TITLE CASE". The strings are case-insensitive.

If the text form field contains a number or a date/time value, then valid format strings are number or date and time format strings.

Microsoft Word allows strings with at most 64 characters.

◆ get_TextInputType()

Aspose::Words::Fields::TextFormFieldType Aspose::Words::Fields::FormField::get_TextInputType ( )

Gets or sets the type of a text form field.

◆ get_Type()

Aspose::Words::Fields::FieldType Aspose::Words::Fields::FormField::get_Type ( )

Returns the form field type.

◆ RemoveField()

void Aspose::Words::Fields::FormField::RemoveField ( )

Removes the complete form field, not just the form field special character.

If there is a bookmark associated with the form field, the bookmark is not removed.

◆ set_CalculateOnExit()

void Aspose::Words::Fields::FormField::set_CalculateOnExit ( bool  value)

◆ set_CheckBoxSize()

void Aspose::Words::Fields::FormField::set_CheckBoxSize ( double  value)

◆ set_Checked()

void Aspose::Words::Fields::FormField::set_Checked ( bool  value)

◆ set_Default()

void Aspose::Words::Fields::FormField::set_Default ( bool  value)

◆ set_DropDownSelectedIndex()

void Aspose::Words::Fields::FormField::set_DropDownSelectedIndex ( int32_t  value)

◆ set_Enabled()

void Aspose::Words::Fields::FormField::set_Enabled ( bool  value)

◆ set_EntryMacro()

void Aspose::Words::Fields::FormField::set_EntryMacro ( System::String  value)

◆ set_ExitMacro()

void Aspose::Words::Fields::FormField::set_ExitMacro ( System::String  value)

◆ set_HelpText()

void Aspose::Words::Fields::FormField::set_HelpText ( System::String  value)

◆ set_IsCheckBoxExactSize()

void Aspose::Words::Fields::FormField::set_IsCheckBoxExactSize ( bool  value)

◆ set_MaxLength()

void Aspose::Words::Fields::FormField::set_MaxLength ( int32_t  value)

◆ set_Name()

void Aspose::Words::Fields::FormField::set_Name ( System::String  value)

◆ set_OwnHelp()

void Aspose::Words::Fields::FormField::set_OwnHelp ( bool  value)

◆ set_OwnStatus()

void Aspose::Words::Fields::FormField::set_OwnStatus ( bool  value)

◆ set_Result()

void Aspose::Words::Fields::FormField::set_Result ( System::String  value)

◆ set_StatusText()

void Aspose::Words::Fields::FormField::set_StatusText ( System::String  value)

◆ set_TextInputDefault()

void Aspose::Words::Fields::FormField::set_TextInputDefault ( System::String  value)

◆ set_TextInputFormat()

void Aspose::Words::Fields::FormField::set_TextInputFormat ( System::String  value)

◆ set_TextInputType()

void Aspose::Words::Fields::FormField::set_TextInputType ( Aspose::Words::Fields::TextFormFieldType  value)

◆ SetTextInputValue()

void Aspose::Words::Fields::FormField::SetTextInputValue ( System::SharedPtr< System::Object newValue)

Applies the text format specified in Aspose::Words::Fields::FormField::get_TextInputFormat and stores the value in Aspose::Words::Fields::FormField::get_Result.

Parameters
newValueCan be a string, number or a DateTime object.