ItemValueStrGetAuto

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.

SalNumber ItemValueStrGetAuto(SalWindowHandle hWndDest,
SalArray<SalString> sItemNames,
SalArray<SalWindowHandle> hWndItems)

The ItemValueStrGetAuto method automatically retrieves values from the DataTransfer object for all the data items in the receiving data source.

Parameters

Name Description
SalWindowHandle hWndDest Window handle of destination (receiving) data source.
SalArray<SalString> sItemNames Array with names of all the items to be received.
SalArray<SalWindowHandle> hWndItems Array with window handles of all the items to be received. These handles are used by the DataTransfer object to put the transferred data in the data items.

Returns

This method does not return a value.

Comments

Another way to describe the ItemValueStrGetAuto method is to say that it automatically "puts" all the values in the DataTransfer object in their corresponding data items on the receiving data source.

The DataTransfer object decides what transfer item to put in which data source by name convention. If there is a data item called 'CUST_ID', it will be given the value(s) of the transfer item 'CUST_ID', if such an item exist.