====== DEFPOSPROP property ======


 
==== Applies To ====
 
OLE Control Integration
 
==== Description ====
 
The DEFPOSPROP property is used to access the current column/row/cell position within the control, in a similar fashion to the standard [[selpos|SELPOS]] or [[caretpos|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|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.
 
==== Usage ====
 
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.
 
==== Remarks ====
 


                
 
==== Returns ====
 
                
                

  

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

Control Namedefault Property
                            
                            
                            
                            
                            
                            
                            
                            
                            

**Note:**