Click here to return to the KiXtart HelpDesk main page...

KiXtart Command Reference

SHOWPROGRAMGROUP

action

Instructs Program Manager to minimize, maximize, or restore the window of an existing program group.

syntax

SHOWPROGRAMGROUP ("group name", show command, common group flag)

parameters

Group name

Identifies the group window to minimize, maximize, or restore.

Show command

Specifies the action Program Manager is to perform on the group window. This parameter is an integer and it must have one of the following values.

Value

action

1

Activates and displays the group window. If the window is minimized or maximized, Windows restores it to its original size and position.

2

Activates the group window and displays it as an icon.

3

Activates the group window and displays it as a maximized window.

4

Displays the group window in its most recent size and position. The active window remains active.

5

Activates the group window and displays it in its current size and position.

6

Minimizes the group window.

7

Displays the group window as an icon. The active window remains active.

8

Displays thegroup window in its current state. The active window remains active.

Common group flag

Optional numeric parameter. This parameter is available only on Windows NT. Common group flag can have the following values:

0

Acts upon a personal group.

1

Acts upon a common group. To manipulate a common group, the user must have administrative privileges, or the function fails.

returns

0

Program group maximized, minimized, or restored

Error code

Function failed

example

If ShowProgramGroup("NewGroup", 6, 0) = 0

   ? "NewGroup has been minimized...."

Endif