2.359 .text

This attribute defines the static text of an object.

With an image, the text to appear with the image is defined.

In notepage the text which appears in the status line is defined with .text (default 0) If no text is defined, the notepage contains no status line.

With the doccursor, the attribute contains the value of all sub-nodes within a DOM node. A string is delivered which represents the text of all sub-nodes. This attribute is mainly helpful when only the text of an XML element is needed, as it is not required to navigate to the child nodes containing the actual text.

The .text attribute must not be used for a statictext that is the child of a spinbox. Its value is set exclusively though the corresponding attributes of the spinbox object itself.

Definition

  • Data type

    string, object [ text ]

  • Access

    get, set

  • changed event

    yes

  • C

    Identifier: AT_text

    Data type: DT_string, DT_text

  • COBOL

    Identifier: AT-text

    Data type: DT-string, DT-text

  • Classification

    text attribute

doccursor

Setting this attribute automatically deletes all child nodes and inserts a new text node.

This attribute is not passed down because it refers to a runtime characteristic.

Please note that an XML Cursor, whose attribute .mapped possesses the value false, will automatically be positioned to the root of the DOM Document.