IfmManage::RestoreZOrder

This method resets the z-order for a Forms Manager to the value of the z-order before the last call to IfmManage::MoveToForeground.

Syntax

HRESULT RestoreZOrder( LONG ZOrder );

Parameters

ZOrder: Set to 0 to force the Forms Manager to the background. Set to a nonzero value to restore the ZOrder to a previous value obtained from IfmManage::MoveToForeground. This parameter is ignored if the default Forms Manager has the foreground.

Return Values

NOERROR indicates success. If an error occurs, the appropriate HRESULT value is returned.

Remarks

After calling IfmManage::MoveToForeground, your application can restore the z-order of the application by calling IfmManage::RestoreZOrder with the z-order that the application received from the call to IfmManage::MoveToForeground.