Show Method (WINDOW)


PLBCMP GUI Only

 

The Show method alters the state of a WINDOW. The method uses the following format:

 

[label]

{object}.Show

[GIVING {return}] USING [*Mode=]{mode}

 

Where:

label

Optional. A Program Execution Label.

object

Required. A WINDOW object that is accessed.

return

Optional. A Numeric Variable that indicates the success or failure of the method.

mode

Required. A Numeric Variable that specifies the show mode.

Flags Affected: EOS, OVER, ZERO

Note the following:

  1. The required {mode} parameter is a decimal number, a Numeric Variable an Expression, or a keyword as defined in PLBEQU.INC. The supported values and keywords are:

  2.  

    Value

    Keyword

    The runtime ...

    0

    $SW_HIDE

    hides the window and activates another window.

    1

    $SW_SHOWNORMAL

    activates and displays a window. If the window is minimized or maximized, the system restores it to its original size and position.

    2

    $SW_SHOWMINIMIZED

    activates the window and displays it as a minimized window.

    3

    $SW_SHOWMAXIMIZED

    activates the window and displays it as a maximized window.

    3

    $SW_MAXIMIZE

    maximizes the window.

    4

    $SW_SHOWNOACTIVATE

    displays a window in its most recent size and position. This value is similar to $SW_SHOWNORMAL except the window is not activated.

    5

    $SW_SHOW

    activates the window and displays it in its current size and position.

    6

    $SW_MINIMIZE

    minimizes the specified window and activates the next top-level window in the ZORDER.

    7

    $SW_SHOWMINNOACTIVE

    displays the window as a minimized window. This value is similar to $SW_SHOWMINIMIZED except the window is not activated.

    8

    $SW_SHOWNA

    displays the window in its current size and position. This value is similar to $SW_SHOW, except the window is not activated.

    9

    $SW_RESTORE

    activates and displays the window. If the window is minimized or maximized, the system restores it to its original size and position. An application should specify this flag when restoring a minimized window.

    103

     

    maximizes the window while not overlaying the taskbar area.

 

  1. If the value returned is zero, the ZERO Condition Flag is set.

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

  3. This method is not the same as setting the VISIBLE property to true.

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

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

 

 

See Also: Method Syntax, WINDOW Methods

 



PL/B Language Reference SetVScrollPos Method (WINDOW or PANEL)