DOCUMENT:Q117378 15-FEB-2002 [visualc] TITLE :INFO: Command IDs and In-Place Frame Window Toolbar PRODUCT :Microsoft C Compiler PROD/VER::1.5,1.51,1.52,2.0,2.1 OPER/SYS: KEYWORDS:kbwizard kbVC150 kbVC151 kbVC152 kbVC200 kbVC210 kbGrpDSTools ====================================================================== ------------------------------------------------------------------------------- The information in this article applies to: - The AppWizard, included with: - Microsoft Visual C++, versions 1.5, 1.51, 1.52 - Microsoft Visual C++, 32-bit Editions, versions 2.0, 2.1 ------------------------------------------------------------------------------- SUMMARY ======= AppWizard generates code that uses a static UINT array called "buttons" to associate command IDs to a single toolbar bitmap that contains several images for buttons 16 pixels wide and 15 pixels high. The IDs are associated with the toolbar buttons, based on their order in the array. When you construct a full-server or mini-server OLE application using AppWizard and you have not selected context-sensitive Help support, the "buttons" array used by the application's in-place frame window class will contain one less command ID than the toolbar contains buttons. This behavior is by design. The image for the Help mode button is included in the toolbar bitmap, even when the application is generated without context- sensitive Help support. MORE INFORMATION ================ To view this behavior, perform the following steps: 1. Start AppWizard and choose full-server or mini-server for the application by selecting OLE Options from the main AppWizard dialog box. 2. Have AppWizard create the application. 3. Open App Studio, and, if you have a full-server application, open the bitmap with the ID "IDR_xxxxxxTYPE_SRVR_IP", where xxxxxx is the first six letters of your project. For example, if the project is named "EXAMPLE", the bitmap would be "IDR_EXAMPLTYPE_SRVR_IP". If you have a mini-server application, the bitmap would have the ID "IDR_SRVR_INPLACE". 4. Open the file IPFRAME.CPP in Visual C++. Find the variable named "buttons". Count how many IDs are there besides the ID_SEPARATOR IDs. This would normally be equal to the number of button images that appear on the toolbar bitmap, but in this situation they are not equal. 5. Now count how many button images are in the bitmap. There will be one more image than there are IDs (not including ID_SEPARATOR IDs). In a default application created by AppWizard, there will be four IDs and five button images. You need to be aware of this behavior if you decide to add buttons to the toolbar for the in-place frame window class. If the application does not support context-sensitive Help or the Help mode button, the button image could simply be replaced with the new button. If context-sensitive Help will be part of the application, then you need to make sure the command IDs that you add correspond to the correct button image. Otherwise, the buttons will not operate the way you expect them to operate. Additional query words: ====================================================================== Keywords : kbwizard kbVC150 kbVC151 kbVC152 kbVC200 kbVC210 kbGrpDSTools Technology : kbVCsearch kbAudDeveloper kbAppWizard Version : :1.5,1.51,1.52,2.0,2.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 2002.