GetTextLen Method (DATALIST)


PLBCMP GUI Only

 

The GetTextLen method retrieves the length of the text for a specified item in a DATALIST object. The method uses the following format:

 

[label]

{object}.GetTextLen

[GIVING {return}] USING [*Index=]{index}

 

Where:

label

Optional. A Program Execution Label.

object

Required. A DATALIST object that is accessed.

return

Optional. A Numeric Variable that returns the length of the specified item.

index

Required. A Numeric Variable that specifies the zero-based item within the object.

Flags Affected: EOS, OVER, ZERO

Note the following:

  1. Upon completion, {return} will contain the length of the specified item's text.

  2. If the value returned is zero, the ZERO Condition Flag is set.

  3. If {return} is too small to contain the length, the OVER Condition Flag is set.

  4. The EOS Condition Flag is always cleared.

 

 

See Also: Method Syntax, DATALIST Methods

 



PL/B Language Reference GetText Method (COMBOBOX / DATALIST) GetTopIndex Method (COMBOBOX / DATALIST)