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

KiXtart 2001 Manual

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 the group window in its current state. The active window remains active.

Common group flag

Optional numeric parameter. This parameter is available only on Windows NT/2000. 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  
 
See Also: AddProgramGroup( )
 
Example:

If ShowProgramGroup("NewGroup", 6, 0) = 0
  ? "NewGroup has been minimized...."
Endif