Defining Folders

Use the following structure to define a folder. Refer to the TLKBASE.SCR file located in the \TOOLKIT\SAMPLES\MM\SHORTCF subdirectory for an example.

WPObject =
 (
 WPClassName = "WPFolder"
 WPTitle = "title"
 WPSetupString = "ICONFILE=$(DEST)icon;OBJECTID=<folderobjid>"
 WPLocation = "<parentfolderobjid>"
 WPFlags = 0
 )

title

Specifies the folder title to be displayed below the object.
icon
Specifies the name of the icon to displayed on the desktop.
folderobjid
Specifies the OS/2 unique object ID that is used to find this folder. This is used by the installation program to determine if this folder exists or not. It is also used in the WPLocation field of other WPObject definitions.
parentfolderobjid
Specifies the folder object ID of the folder in which this folder is to be placed. For example, "<WP_DESKTOP>" is the object ID for the Workplace Shell desktop folder.
WPFlags = 0
Specifies creation control. These flags are also documented under WinCreateObject in the OS/2 Presentation Manager Programming Reference. already exist. Possible values include:

• CO_FAILIFEXISTS) - The folder is to be replaced if it exists, or added if it does not already exist.
  
• CO_REPLACEIFEXISTS) - The folder is to be replaced if it exists, or added if it does not already exist.
  
• CO_UPDATEIFEXISTS) - The folder is to be updated with the values supplied if it exists, or added using values supplied and defaults if it does not already exist.

In the following example, a folder called Multimedia Presentation Manager Toolkit/2 will be added to the desktop.

WPObject =    (
    WPClassName   = "WPFolder"
    WPTitle       = "Multimedia Presentation\nManager Toolkit/2"
    WPSetupString = "ICONFILE=$(DEST)MMTOOLKT.ICO;OBJECTID=<MMPMTLK>"
    WPLocation    = "<WP_DESKTOP>"
    WPFlags = 2L
    )

Defining Programs

Use the following structure to define a program that is to be added to a folder. Refer to the TLKSTRN.SCR file located in the \TOOLKIT\SAMPLES\MM\SHORTCF subdirectory for an example.

WPObject =
(
WPClassName   = "WPProgram"
WPTitle       = "title"
WPSetupString = "EXENAME=path file;STARTUPDIR=dir;PROGTYPE=PM;
     ICONFILE=$(DEST)icon; [ASSOCTYPE=type;]
     [ASSOCFILTER=filter;] OBJECTID=<pgmobjid>"
WPLocation    = "<parentfolderobjid>"
WPFlags = 0
)

Note: The program setup information (WPSetupString) must be on one line, not two as shown in the previous figure.

title

Specifies the title to be displayed below the object in the parent folder.
path
Specifies a supported macro or the full path for the EXE file.
icon
Specifies the name of the icon to be displayed on the desktop.
file
Specifies the EXE file name.
dir
Specifies the full path of the startup directory or the macro $(DIR)# (where # is a defined destination directory in CONTROL.SCR).
type
Specifies one or more association types such as "Waveform." Multiple values are separated by commas.
filter
Specifies one or more association filter types such as "*.WAV." Multiple values are separated by commas.
pgmobjid
Specifies the OS/2 unique object ID that is used to find this program. This is used by the installation program to determine if this program exists in the parent folder. It is not used in the WPLocation field of any WPObject definition.
parentfolderobjid
Specifies the folder object ID of the folder in which this program is to be placed.
WPFlags = 0
Specifies that the program is to be added to the folder only if it does not already exist.

---

[Back: INI Change Control Files]
[Next: Caption DLL]