InitFromObjConRef

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 InitFromObjConRef(SalString sSourceName,
 		SalWindowHandle hWndSource,
 		SalString sKeyReference)

The InitFromObjConRef method initializes the DataTransfer object from a key reference string.

Parameters

Name	Description
SalString sSourceName	Name of the transfer source object. For data sources this is typically the name of the Logical Unit associated with the data source.
SalWindowHandle hWndSource	Window handle of transfer source object.
SalString sKeyReference	String containing the complete key reference for the connection object.

Returns

This method does not return a value.

Comments

Key reference strings are typically used in conjunction with Object Connections.

Example

Function: UserMethod
   Returns
       Number:
   Parameters
       Number: nWhat
       String: sMethod
   Static Variables
   Local variables
   Actions
       If sMethod = 'show object information'
          If nWhat = METHOD_Inquire
              Return ( Component.LUDefaultWindowGet( colLuName ) != strNULL )
          Else If nWhat = METHOD_Execute
              ! Open the default window for the connected object and populate with 
                the correct object.
              Call DataTransfer.InitFromObjConRef( p_sLogicalUnit, i_hWndSelf, colKeyRef )
              Call SalCreateWindow( Component.LUDefaultWindowGet( colLuName ), hWndMDI )

Add C# code sample