SetForegroundWindow Method (WINDOW)

9.4C, PLBCMP GUI Only

The SetForegroundWIndow method makes a WINDOW object visible. The method uses the following format:

Where:

label

Optional. A Program Execution Label.

object

Required. A WINDOW that is activated.

return

Optional. A Numeric Variable that receives the pass or fail result for the execution of the method.

Flags Affected: EOS, OVER, ZERO

Note the following:

1. The {return} for this method is always set to zero and the ZERO Condition Flag is set.

2. The OVER and EOS Condition Flags are always cleared.

3. For improved performance in the Application Server environment, do not specify the optional return value unless needed.

4. If the {object} has not been set to a visible/activated state, this method is ignored.

5. If the {object} has a WINTYPE of $MDICHILD, a message is sent to the MDI client window to activate the MDI child window.

6. This method is not available when using the PL/B Web Server.

See Also: Method Syntax, WINDOW Methods