IfmManage::MoveToForeground

This method moves the specified Forms Manager to the foreground and gives it the focus.

Syntax

HRESULT MoveToForeground( BOOL fThis, LONG *pZOrder );

Parameters

fThis: Boolean that is set to TRUE to move the specified Forms Manager to the foreground, or to FALSE to move the default Forms Manager for the application to the foreground.
pZOrder: Pointer to the current z-order.

Return Values

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

Remarks

Only complex applications that use multiple Forms Manager objects should use this method. Application that use a single Forms Manager object should use IfmManage::MoveAppToForeground.

This method only affects the z-order for a single Forms Manager. If the application does not have the foreground, the change in z-order is not visible until the application is brought to the foreground.

To restore the original z-order of your Forms Manager after using this method, your application should call IfmManage::RestoreZOrder with the z-order that the application received from the original call to IfmManage::MoveToForeground.