> For the complete documentation index, see [llms.txt](https://fmsoft.gitbook.io/minigui/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fmsoft.gitbook.io/minigui/development-documents/programming-guide/part-vi-using-minigui-inherent-controls/miniguiprogguidepart6chapter17.md). # Cool Bar Control * [Styles of Cool Bar](#styles-of-cool-bar) * [Messages of Cool Bar](#messages-of-cool-bar) * [Sample Program](#sample-program) The cool bar control is a toolbar which can display a line of text or icon buttons. The cool bar is very simple and is easy to use. You can create a cool bar control by calling `CreateWindow` function with `CTRL_COOLBAR` as the control class name. ## Styles of Cool Bar The button items of cool bar with the styles `CBS_BMP_16X16` and `CBS_BMP_32X32` will display bitmaps with size of `16x16` and `32x32` respectively. The button items of a cool bar with `CBS_BMP_CUSTOM` style will use bitmaps with customized size. For cool bar controls with this style, you should pass the height and width of the bitmap to the control through `dwAddData` argument when calling `CreateWindow` to create the control: ```cpp CreateWindowEx (CTRL_COOLBAR, ..., MAKELONG (item_width, item_height))); ``` A cool bar with `CBS_USEBKBMP` style has a background bitmap, and you should pass the path of the bitmap file to the control by `spCaption` argument of `CreateWindow` function when creating the control. ```cpp CreateWindowEx (CTRL_COOLBAR, “res/bk.bmp”, ...); ``` Cool bar cannot accept height when create it. ## Messages of Cool Bar After a cool bar has been created, we can use `CBM_ADDITEM` message to add items to the toolbar: ```cpp COOLBARITEMINFO itemInfo; SendMessage (hwndCoolBar, CBM_ADDITEM, 0, (LPARAM)&itemInfo) ; ``` Here `itemInfo` is a structure of `COOLBARITEMINFO` type: ```cpp typedef struct _COOLBARITEMINFO { /* Reserved */ int insPos; /* The identifier of the button item */ int id; /* The type of the button item */ int ItemType; /* The bitmap object used by the button */ PBITMAP Bmp; /* The hint text of the button */ const char *ItemHint; /* The caption of the */ const char *Caption; /* The additional data of the button item */ DWORD dwAddData; } COOLBARITEMINFO; ``` Here id is the identifier of the item in a toolbar. When the user clicks the item, the cool bar will generate notification messages, and the high word (`HIWORD`) of `wParam` is the identifier value of the corresponding item, the low word (`LOWORD`) of `wParam` is the identifier value of the tool Control. `ItemType` specifies the type of the item, value of which can be one of `TYPE_BARITEM`, `TYPE_BMPITEM`, and `TYPE_TEXTITEM`. Item of `TYPE_BARITEM` is a vertical separator; item of `TYPE_BMPITEM` is a bitmap button; and item of `TYPE_TEXTITEM` is a text button. If the type of an item is `TYPE_BMPITEM`, `bmp` specifies the bitmap object used by the item. `ItemHint` is the prompt text to be displayed when the mouse move onto the item. If the style of an item is `TPYE_TEXTITEM`, Caption should point to the text string displayed on the item. `dwAddData` is the additional data of an item. `CBM_ENABLE` message disables or enables an item: ```cpp int id; BOOL beEnabled; SendMessage (hwndCoolBar, CBM_ENABLE, id, beEnabled) ; ``` Here id is the identifier value of the item to be set. If `beEnabled` is `TRUE`, enable the item and `FALSE` disable the item. ## Sample Program The program in List 1 illustrates the use of a cool bar control. Please refer to `coolbar.c` file of the demo program package of this guide for the complete source code. **List 1** Use of cool bar control ```cpp #define ITEM_NUM 10 /* The text to be displayed on the coolbar */ static const char* caption[] = { "0", "1", "2", "3", "4", "5","6", "7", "8", "9" }; /* Specify the hint text */ static const char* hint[] = { "数字 0", "数字 1", "数字 2", "数字 3", "数字 4", "数字 5", "数字 6", "数字 7", "数字 8", "数字 9" }; /* Create the coolbar, and add the tool items */ static void create_coolbar (HWND hWnd) { HWND cb; COOLBARITEMINFO item; int i; cb = CreateWindow (CTRL_COOLBAR, "", WS_CHILD | WS_VISIBLE | WS_BORDER, 100, 10, 100, 100, 20, hWnd, 0); item.ItemType = TYPE_TEXTITEM; item.Bmp = NULL; item.dwAddData = 0; for (i = 0; i < ITEM_NUM; i++) { item.insPos = i; item.id = i; item.Caption = caption[i]; item.ItemHint = hint[i]; SendMessage (cb, CBM_ADDITEM, 0, (LPARAM)&item); } } static int CoolbarWinProc(HWND hWnd, int message, WPARAM wParam, LPARAM lParam) { static HWND ed; switch (message) { case MSG_CREATE: /* Create an edit box to feedback the user’s operation on the toolbar */ ed = CreateWindow (CTRL_EDIT, "", WS_CHILD | WS_VISIBLE | WS_BORDER, 200, 10, 10, 100, 20, hWnd, 0); create_coolbar (hWnd); break; case MSG_COMMAND: { int id = LOWORD (wParam); int code = HIWORD (wParam); if (id == 100) { static char buffer[100]; char buf[2]; /* Type appropriate character into the edit box according to * the tool item clicked by the user */ sprintf (buf, "%d", code); SendMessage (ed, MSG_GETTEXT, 90, (LPARAM)buffer); strcat (buffer, buf); SendMessage (ed, MSG_SETTEXT, 0, (LPARAM)buffer); } } break; case MSG_DESTROY: DestroyAllControls (hWnd); return 0; case MSG_CLOSE: DestroyMainWindow (hWnd); PostQuitMessage (hWnd); return 0; } return DefaultMainWinProc(hWnd, message, wParam, lParam); } /* Following codes to create the main window are omitted */ ``` ![alt](/files/ReFPDL3UOvQRD02eP7c4) **Figure 1** Use of cool bar control This program creates a tool bar comprised of “0-9” figures in a dialog box. When the user clicks the item in the toolbar, the corresponding figure is typed into the above edit box. *** [<< Spin Box Control](/minigui/development-documents/programming-guide/part-vi-using-minigui-inherent-controls/miniguiprogguidepart6chapter16.md) | [Table of Contents](/minigui/development-documents/programming-guide.md) | [Animation Control >>](/minigui/development-documents/programming-guide/part-vi-using-minigui-inherent-controls/miniguiprogguidepart6chapter18.md)