guides:programming:programmers_reference_manual:defposprop

DEFPOSPROP property

OLE Control Integration

The DEFPOSPROP property is used to access the current column/row/cell position within the control, in a similar fashion to the standard SELPOS or CARETPOS properties. It can be mapped in one of three ways:

1. By specifying a single actual OLE property of the control (such as "SelPos" for example) that implements an @fm-delimited column and row index format (like CARETPOS).

2. By specifying a comma delimited pair of properties representing the column and row positions respectively, e.g. "CurrCol,CurrRow".

3. By specifying the name of a Basic+ handler function that the form IO layer calls to handle the request in a similar fashion to the DEFPROP handler.

A Basic+ DEFPOSPROP handler should have the following interface:

defPosPropVal = myDefPosPropHandler( ctrlEntID, flags, newPos )

ctrlEntID → ID of the control to get the value for

flags → Denotes if this is a GET or SET/SETONLY request

new → The new position if this is a SET/SETONLY operation

<1> Col

<2> Row

defPosPropVal ← Returns the current position in the format

<1> Col

<2> Row

The final item needed is the POSCHANGED event name so that the form IO layer can check when data has been entered into a cell for validation and update purposes.

Each control has a default property. The controls and properties are as follows.

Control Namedefault Property

Note:

  • guides/programming/programmers_reference_manual/defposprop.txt
  • Last modified: 2024/06/19 20:20
  • by 127.0.0.1