DOCUMENT:Q86872  06-NOV-1999  [win16sdk]
TITLE   :Program Manager DDE Command AddItem Documentation
PRODUCT :Microsoft Windows Software Development Kit
PROD/VER:WINDOWS:3.1
OPER/SYS:
KEYWORDS:kb16bitonly

======================================================================
-------------------------------------------------------------------------------
The information in this article applies to:

 - Microsoft Windows Software Development Kit (SDK) 3.1 
-------------------------------------------------------------------------------

SUMMARY
=======

The Microsoft Windows Program Manager has a dynamic data exchange (DDE)
command-string interface that allows another application to create, update, and
delete groups and programs within groups. The text below extends the
documentation for the AddItem command that begins on page 373 of the "Microsoft
Windows Software Development Kit: Reference, Volume 1: Overview."

MORE INFORMATION
================

The syntax for the AddItem command has the following form:

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

The AddItem command instructs Program Manager to add an icon to an existing
group.

If you specify fewer than four parameters, the IconIndex defaults to the last
icon in the group. For example:

   AddItem(notepad.exe, "Notepad", notepad.exe)

If you specify five or more parameters but do not specify values for xPos and
yPos, the icon position defaults to 0, 0 (the first icon in the group). For
example:

   AddItem(notepad.exe, "Notepad", notepad.exe,,,, "c:\")

Therefore, to create the last icon in the group and specify five or more
parameters, set xPos and yPos to -1. For example:

   AddItem(notepad.exe, "Notepad", notepad.exe,, -1, -1, "c:\")

For the HotKey parameter, specify the ASCII value of the desired key. The
application can create a key combination (for example, ALT+SHIFT+A) by adding
one or more of the following values to the ASCII value for the key:

                Decimal
   Key           Offset
   ---           ------
   SHIFT            256
   CTRL             512
   ALT             1024
   Extended        2048

For example, ALT+SHIFT+A is signified by 1345 (1024+256+65).

Additional query words: 3.10

======================================================================
Keywords          : kb16bitonly 
Technology        : kbAudDeveloper kbWin3xSearch kbSDKSearch kbWinSDKSearch kbWinSDK310
Version           : WINDOWS:3.1

=============================================================================

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS
PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.  MICROSOFT DISCLAIMS
ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  IN NO
EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR
ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL,
CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF
MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.  SOME STATES DO NOT ALLOW THE EXCLUSION
OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES
SO THE FOREGOING LIMITATION MAY NOT APPLY.

Copyright Microsoft Corporation 1999.