PM_DataItemSetTabOrder

Note: This page includes content based on the F1 documentation for Centura development. It may be partially converted to support APF development, but should be regarded to be of uncertain actuality. It is provided as is. Eventually, it should be replaced by documentation available from within Visual Studio.

Const.PM_DataItemSetTabOrder

Applications and the frame work send the Const.PM_DataItemSetTabOrder to data items in order to modify the items placement in the tab order, or to remove the item from the tab order.

Parameters

Name Description
hWndInsertAfter = SalNumberToWindowHandle(wParam ) Window handle of the item after which the item receiving Const.PM_DataItemSetTabOrder should be inserted. If this parameter is hWndNULL, the item is removed from the tab order.
lParam Unused

Returns

Unused (the Framework ignores the return value of this message)

Example

This example sends the Const.PM_DataItemSetTabOrder message to remove dfDescription from the tab order.

cDataField: dfDescription
   Message Actions
       On SAM_Create
          Call SalSendClassMessage( hWndItem, wParam, lParam )
          Call SalSendMsg( hWndItem, PM_DataItemSetTabOrder, 
                      SalWindowHandleToNumber( hWndNULL ), 0 )
This example sends the Const.PM_DataItemSetTabOrder message to Disable a field if it is not insertable or updatable.
if (!(p_nFieldFlags & ((Const.FIELD_Update | Const.FIELD_UpdateIfNull) | Const.FIELD_Insert))) 
{
	Sal.SendMsg(i_hWndSelf, Const.PM_DataItemSetTabOrder,
Sal.WindowHandleToNumber(SalWindowHandle.Null), 0); }