OS/2 2.0 Workplace Shell Tools (tested with 6.304)
by Ned Konz
BIX: nkonz, CI$ 76046,223
March 15, 1992

================ BACKGROUND

These programs are quick hacks which will let you play around with the WPS
object creation. Note that you can get yourself into trouble with these;
the system will let you make duplicate clocks, etc. which may be hard to
get rid of, and I can't take any responsibility for your use of them.
As with any program, you should read the source code before you use them
if you're concerned about what they do.

================ GETTING YOUR CLOCK BACK

To get your clock back into the System Setup folder, use MAKEOBJ like this:

MAKEOBJ WPClock "System Clock" ""

This will create a new clock in the System Setup folder, just like the
original one.

Don't run this more than once, or you'll end up with too many clocks
(see next section). These can be hard to get rid of and can confuse the
system, which expects to have only one.

================ GETTING RID OF PESKY EXTRA CLOCKS

I wrote these programs to experiment with the WPS object functions,
and to get my System Clock back. I promptly made too many clocks and
had to go through the following to get rid of them:

(from command prompt)
mkdir c:\xyz

(go to WP Shell, then:)
open new folder c:\xyz from Drives
move extra clocks into this folder
close the folder

(from command prompt)
rmdir c:\xyz

=============== THE PROGRAMS

There are four executable files here:

============== MAKEOBJ.EXE

usage: MAKEOBJ Classname Title Location [SetupString]

This creates a new Workplace Shell object (even new folders).
See below for Classname, Location, and (optional) SetupString arguments.

Examples:
To make a new system clock in the system startup folder:

MAKEOBJ WPClock "System Clock" ""

To make a template of a folder and put it on the desktop, using the icon
which resides in c:\icons\xyz.ico

MAKEOBJ WPFolder "My New Folder" "" "TEMPLATE=YES,ICON=c:\icons\xyz.ico"

============== MODOBJ.EXE

usage: MODOBJ ObjID setupstring

This modifies the attributes of an existing object if it can find it.

ObjID is either an absolute path name or "" type location name.
Probably others would work too, but I don't know their syntax.

for SetupString, see below.

============= DESTOBJ.EXE

usage: DESTOBJ ObjID

This destroys an object if it can find it. See MODOBJ for OBJID.
Obviously, you can delete things which may be hard to put back. Be careful.

============= ENUMAPP.EXE

usage: ENUMAPP

This lists the application/key pairs from both OS2.INI and OS2SYS.INI.
The abstract objects (those without pathnames) live in the INI files;
you might be able to learn something from their contents.

=============== WPS LOCATIONS
===============================================================================
Some locations I've found (see \OS2\INI.RC for more)
Physical Name Location ID Type
(on FAT system)
===============================================================================
\Nowhere Nowhere WPFolder
\Desktop Desktop WPDesktop
\Desktop\Template Desktop->Templates WPTemplates
\Desktop\Minimize Desktop->Minimized Window Viewer WPMinWinViewer
\Desktop\OS!2_Sys Desktop->OS/2 System WPFolder
\Desktop\OS!2_Sys\Drives Desktop->OS/2 System->Drives WPDrives
\Desktop\OS!2_Sys\Startup ... Startup WPStartup
\Desktop\OS!2_Sys\System_S ... System Setup WPFolder

other locations I found on my system (using enumapp.exe):
















============ SETUP STRINGS

The setup string is a series of keyword=value pairs, separated by commas.
For instance, if I wanted to make a template for a Folder using the icon
in the file "c:\icons\folder.ico", I would use the setup string:

"TEMPLATE=YES,ICON=c:\icons\folder.ico,TITLE=My New Folder"
==============================================================================
These are the keyname-value pairs supported by the WPObject class:


KEYNAME VALUE Description

TITLE Title This sets the object's title. This is
equivalent to calling the wpSetTitle
method.

ICON filename This sets the object's icon. This is
equivalent to calling the wpSetIconData
method.

HELPPANEL id This sets the object's default help
panel. This is equivalent to calling the
wpSetDefaultHelp method.

TEMPLATE YES This sets the object's template
property. This is equivalent to calling
the wpSetStyle method with a style of
OBJSTYLE_TEMPLATE.

NO This resets the object's template
property.

NODELETE YES This sets the object's no delete
property. This is equivalent to calling
the wpSetStyle method with a style of
OBJSTYLE_NODELETE.

NO This resets the object's no delete
property.

NOCOPY YES This sets the object's no copy property.
This is equivalent to calling the
wpSetStyle method with a style of
OBJSTYLE_NOCOPY.

NO This resets the object's no copy style.

NOMOVE YES This sets the object's no move property.
This is equivalent to calling the
wpSetStyle method with a style of
OBJSTYLE_NOMOVE.

NO This resets the object's no move
property.

NOLINK YES This sets the object's no link property.
This is equivalent to calling the
wpSetStyle method with a style of
OBJSTYLE_NOLINK.

NO This resets the object's no link
property.