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.
In Application Forms, PM_DataSourceObjectConnection
is
now obsolete and object connections no longer uses DataTransfer object in
loading connected objects. Three new public messages are introduced enabling
application developer to override the FW functionality. The messages
PM_AttachmentsEnabledUser and
PM_AttachmentLuNameGet will replace the
uses of PM_DataSourceObjectConnection
.
PM_AttachmentKeysGet will replace the overrides of
DataSourcePrepareKeyTransfer
used in object connections.
Const.PM_DataSourceObjectConnection
Applications and the framework send the Const.PM_DataSourceObjectConnection message to a data source to invoke the Object Connections window.
Name | Description |
---|---|
nWhat = wParam | Standard method parameter. Possible values are Const.METHOD_Inquire, Const.METHOD_Execute, Const.METHOD_GetType |
lParam | Unused |
When nWhat = Const.METHOD_Inquire, the return value is TRUE if the data source is "object connection aware" and there is at least one Object Connections server window registered in the application. Otherwise the return value is FALSE.
When nWhat = Const.METHOD_Execute, the return value is TRUE if the Object Connection window was successfully created, FALSE otherwise.
For Object Connections to be available, there must be at least one object connection server registered in the application. Applications should use the cComponent.ObjConServerRegister method to register object connection servers.
When the framework receives the Const.PM_DataSourceObjectConnection message, the DataTransfer object is initialized by calling DataSourcePrepareKeyTransfer and then the Object Connection window is created.