PM_DataItemLovUserOrderBy

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.

2010-06-30 Tofuse: remove ctd example

Const.PM_DataItemLovUserOrderBy

The Const.PM_DataItemLovUserOrderBy message is sent to a data item when a LOV dialog is being created. Applications should override this message to set the order by statement for a LOV reference.

Parameters

Returns

The return value is the order by statement converted to number

Comments

The Const.PM_DataItemLovUserOrderBy message is useful when an application wants to add an order by statement to a reference.

Note: that the performance will be affected so this message should only be used on LOV's containing a small amount of records.

Example

This example catches the Const.PM_DataItemLovUserOrderBy message to set an order by statement that will be used in the LOV-dialog.

public SalNumber __LovUserOrderBy()
{
	#region Local Variables
	SalString sUserOrderBy = "";
	#endregion
	
	#region Actions
	using (new SalContext(this))
	{
		sUserOrderBy = SalString.FromHandle(Sal.SendMsg(__hWndProfileObject, 
					Const.PM_DataItemLovUserOrderBy, 0, 0));
		if (sUserOrderBy != Const.strNULL) 
		{
			p_sDefaultOrderBy = sUserOrderBy;
		}
	}
	return 0;
	#endregion
}