Top
PowerCOBOL V11.0 Reference
FUJITSU Software

5.52 InsertString Method

Description:

Inserts a character string contained in the first parameter at the position contained in the second parameter.

Used in controls:

ComboBox

ListBox

Used in objects:

None.

Parameters:

1. VT_BSTR - TextStringX(8192)
2. VT_I4 - IndexS9(9) COMP-5

Description of Parameters:

TextString: Contains the string to insert to the list.

Index: The index position at which the string is inserted.
The value is an integer greater than zero. The string is inserted at the top of the list if the value is 1, and inserted at the end of the list if the value is ListCount property plus 1.

Return value:

VT_I4 - ReturnValueS9(9) COMP-5

If positive, this is the index of the inserted item.
-1 indicates an error (for example, the data type is not correct)

Example:

INVOKE CmCombo1 "InsertString"
  USING     TextString
            Index
  RETURNING ReturnValue

Backward compatibility
method name:

None.