PM_DataItemNew

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_DataItemNew

The Const.PM_DataItemNew message is sent to all data items in a data source after a record in the data source has been created or duplicated.

Parameters

Name Description
wParam Unused
bDuplicate = lParam Indicates if the record was duplicated. A value of TRUE indicates that an existing record was duplicated, a value of FALSE indicates that a new record was created.
sParam = SalNumberToHString( lParam ) desc

Returns

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

Example

This example catches the PM_DataItemNew message to update the window title

On PM_DataItemNew
   Call SalSendClassMessage ( PM_DataItemNew, wParam, lParam )
   Call SalSetWindowText( hWndForm, sCompanyWindowVariable ||
            ' - ' || TranslateConstant(TEXT_NAV_Order) )
This example catches the Const.PM_DataItemNew message to clear a field
private void cControlSelectionComboBox_OnPM_DataItemNew(ref SalMessage message)
{
	#region Actions
	message.Handled = true;
	Sal.SendClassMessage(Const.PM_DataItemNew, Sys.wParam, Sys.lParam);
	if (this.p_sSqlColumn != Const.strNULL) 
	{
		Sal.ClearField(this.i_hWndSelf);
	}
	#endregion
}