GetPosFromCharIndex Method

8.7C, PLBCMP GUI Only

The GetPosFromCharIndex method retrieves the client area coordinates of a specified character in an EDITTEXT or a RICHEDITTEXT object. The method uses the following format:

[label]

{object}.GetPosFromCharIndex

[GIVING {return}] USING [*CharIndex=]{charndx}

Where:

label

Optional. A Program Execution Label.

object

Required. An EDITTEXT or RICHEDITTEXT object that is accessed.

return

Optional. A Numeric Variable that reports the position.

charndx

Required. A decimal number or Numeric Variable that specifies the one-based character index.

Flags Affected: EOS, OVER, ZERO

Note the following:

If the value returned is zero, the ZERO condition flag is set.
The OVER and EOS Condition Flags are always cleared.
A character index returned is the one-based index of the character from the beginning of the object.
The returned value is the vertical position times 10,000 plus the horizontal position.
When using the PL/B Web Server, this method is not supported.