AddItemAddItem*
*Contents  *Index  *Topic Contents
*Previous Topic: Command-String Interface
*Next Topic: CreateGroup

AddItem


AddItem(CmdLine[,
Name[,IconPath[,IconIndex[,xPos,yPos[,DefDir[,
HotKey[,fMinimize[fSeparateMemSpace] ] ] ] ] ] ])

Instructs Program Manager to add an icon to an existing group. There is a limit of 50 items per group.

CmdLine
Full command line required to run the application. This parameter is a string. At a minimum, this string is the name of the executable file for the application. It can also include the full path of the application and any parameters required by the application.
Name
Title that is displayed below the icon in the group window.
IconPath
File name for the icon to be displayed in the group window. This parameter is a string. This file can be either a Windows-based executable file or an icon file. If no value is specified for this parameter, Program Manager uses the first icon in the file specified by the CmdLine parameter if that file is an executable file. If CmdLine specifies an associated file, Program Manager uses the first icon of the associated executable file. The association is taken from the registry. If CmdLine specifies neither an executable file nor an associated executable file, Program Manager uses a default icon.
IconIndex
Index of the icon in the file identified by the IconPath parameter. The IconIndex parameter is an integer. Progman.exe contains five built-in icons that can be used for programs not written for Windows.
xPos
Horizontal position of the icon in the group window. This parameter is an integer. Both the xPos and yPos parameters must be used to specify the position of the icon. If the position is not specified, Program Manager places the icon in the next available space.
yPos
Vertical position of the icon in the group window. This parameter is an integer. Both the xPos and yPos parameters must be used to specify the position of the icon. If the position is not specified, Program Manager places the icon in the next available space.
DefDir
Name of the default (or working) directory. This parameter is a string.
HotKey
Hot (or shortcut) key that is specified by the user.
fMinimize
Specifies whether an application window is to be minimized when first displayed.
fSeparateMemSpace
Specifies whether a 16-bit application runs in a separate memory space.

Up Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.