GetText - OT GetText version OT inTag Text Type Description inObject Longint handle String Tag item retrieve result Text retrieved item larr Discussion OT GetText gets value inObject from item referenced inTag If object not valid object handle error generated OK set zero empty string returned If item object given tag empty string returned option set error generated OK set zero If item given tag exists type OT Character value requested element returned If item given tag exists other type OK set zero empty string returned See ldquoThe Character Item Typerdquo page more information storing and retrieving strings See OT PutText OT PutString OT GetString

OT GetText

View from small screen devices!

OT GetText version 1

OT GetText(inObject; inTag) Text

→

Parameter Type Description

inObject Longint A handle to an object

→

inTag String Tag of the item to retrieve

→

Function result Text The retrieved item

←

Discussion

OT GetText gets a value in inObject from the item referenced by inTag.

If the object is not a valid object handle, an error is generated, OK is set to zero, and an empty string is returned.

If no item in the object has the given tag, an empty string is returned. If the FailOnNoItem option is set, an error is generated and OK is set to zero.

If an item with the given tag exists and has the type OT Is Character (112), the value of the requested element is returned.

If an item with the given tag exists and has any other type, OK is set to zero, and an empty string is returned.

See “The Character Item Type” on page 11 for more information on storing and retrieving strings.