PM_DataItemEntered

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_DataItemEntered

The Const.PM_DataItemEntered message is sent to a data source when the focus enters a data item connected to the data source.

Parameters

Name Description
hWndFocus = SalNumberToWindowHandle( wParam ) Window handle of the data item that received focus.
lParam Unused

Returns

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

Comments

This message is very useful when the data source want to perform some action (e.g. enable/disable buttons), when the focus is moved.

Example

This example shows how the PM_DataItemEntered message is used to update the status of a LOV button.

On PM_DataItemEntered
   Set hWndFocusField = SalNumberToWindowHandle( wParam )
   Call pbLOV.MethodInvestigateState( )
C# coding

This example shows how the Const.PM_DataItemEntered message is used to update the status of a List button.

private void cWizardDialogBox_MessageActions(ref SalMessage message)
{
	#region Actions
	switch (message.Code)
	{
		case Const.PM_DataItemEntered:
			this.cWizardDialogBox_OnPM_DataItemEntered(ref message);
			break;
	}
	#endregion
}

private void cWizardDialogBox_OnPM_DataItemEntered(ref SalMessage message)
{
	#region Actions
	message.Handled = true;
	// Check for LOV settings for the current field
	this.hWndFocusField = Sys.wParam.ToWindowHandle();
this.pbList.MethodInvestigateState(); #endregion }