SendMessageToChildrenOk

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.

SalBoolean SendMessageToChildrenOk( SalNumber nChildTypes,
                                 SalNumber nMessage,
                                 SalNumber nwParam,
                                 SalNumber nlParam )

The SendMessageToChildrenOk sends a message to all logical children of the specified type(s). If any child returns FALSE, the SendMessageToChildrenOk returns and the message is not sent to any other children.

Parameters

Name	Description
SalNumber nChildTypes	Types of logical children that shall receive the message. Specify one or more of the Const.CHILDTYPE_* constants.
SalNumber nMessage	Number of the message to send. This is typically a Const.SAM_, Const.PM_, or Const.PAM_* message constant.
SalNumber nwParam	The value that will be available to the receiver in the wParam system variable.
SalNumber nlParam	The value that will be available to the receiver in the lParam system variable.

Returns

The return value is true if all children return a non-zero value, false otherwise.

Comments

To send messages in a way that the sending continues even if a child returns false, applications should use the SendMessageToChildren method.