Program Manager DDE Command AddItem Documentation

Last reviewed: July 23, 1997
Article ID: Q86872

3.10 WINDOWS kbprg

The information in this article applies to:

Microsoft Windows Software Development Kit (SDK) for Windows version 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 reference words: 3.10
KBCategory: kbprg
KBSubcategory: UsrDde
Keywords : kb16bitonly

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.

Last reviewed: July 23, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.