# Static Control - [Types and Styles of Static Control](#types-and-styles-of-static-control) + [Standard Type](#standard-type) + [Bitmap Type](#bitmap-type) + [Group Box](#group-box) + [Other static control types](#other-static-control-types) - [Static Control Messages](#static-control-messages) - [Notification Codes of Static Control](#notification-codes-of-static-control) - [Sample Program](#sample-program) A static control is used to display information, such as text and digits, in the specified position of a window, and can also be used to display some static image information, such as corporation logos, product brands, etc. As suggested by its name, the behavior of a static box cannot respond dynamically to the user input. The existence of the control is basically for displaying some information, and does not receive any input from the keyboard or the mouse. Fig 19.1 shows the typical use of the static control: to be the label of other controls in a dialog box. ![alt](figures/19.1.jpeg) Figure 1 Typical use of the static control You can create a static control by calling `CreateWindow` function with `CTRL_STATIC` as the control class name. ## Types and Styles of Static Control Styles of a static control comprise the type of the static control and some flags. We can divide the static controls into standard type (display text only), bitmap type (display icon or bitmap), and special type of group box. We will introduce the different types of static control in the following sections. ### Standard Type By setting the style of a static control to be one of `SS_SIMPLE`, `SS_LEFT`, `SS_CENTER`, `SS_RIGHT`, and `SS_LEFTNOWORDWRAP`, you can create a static control displaying only text. The displayed content thereof is specified in the caption argument of `CreateWindow` function and can be changed by calling `SetWindowText`. Static controls with `SS_SIMPLE` style can only be used to display single-line text, that is to say, the text in such controls is not wrapped automatically, and is always align left. Static controls with `SS_LEFT`, `SS_CENTER`, or `SS_RIGHT` style can be used to display multiple-line text, and align the text in the control left, center, and right respectively. Static controls with `SS_LEFTNOWORDWRAP` will extend `TAB` characters in the text, but words are not wrapped automatically. The following program creates static controls of the several types described above: ```cpp CreateWindow (CTRL_STATIC, "This is a simple static control.", WS_CHILD | SS_NOTIFY | SS_SIMPLE | WS_VISIBLE | WS_BORDER, IDC_STATIC1, 10, 10, 180, 20, hWnd, 0); CreateWindow (CTRL_STATIC, "This is a left-aligned static control (auto-wrap).", WS_CHILD | SS_NOTIFY | SS_LEFT | WS_VISIBLE | WS_BORDER, IDC_STATIC2, 10, 40, 100, 45, hWnd, 0); CreateWindow (CTRL_STATIC, "This is a right-aligned static control (auto-wrap).", WS_CHILD | SS_NOTIFY | SS_RIGHT | WS_VISIBLE | WS_BORDER, IDC_STATIC3, 10, 90, 100, 45, hWnd, 0); CreateWindow (CTRL_STATIC, "This is a center-aligned static control (auto-wrap).", WS_CHILD | SS_NOTIFY | SS_CENTER | WS_VISIBLE | WS_BORDER, IDC_STATIC4, 10, 140, 100, 45, hWnd, 0); CreateWindow (CTRL_STATIC, "SS_LEFTNOWORDWRAP: " "\tTabs are expanded, but words are not wrapped. " "Text that extends past the end of a line is clipped.", WS_CHILD | SS_LEFTNOWORDWRAP | WS_VISIBLE | WS_BORDER, IDC_STATIC, 10, 290, 540, 20, hWnd, 0); ``` The appearance of the controls described above is shown in Figure 2. For showing the effect clearly, all these static controls have borders. ![alt](figures/19.2.jpeg) Figure 2 Static controls of standard type ### Bitmap Type A static control with `SS_BITMAP` or `SS_ICON` style displays a bitmap or an icon in the control. For these two types of static control, it is needed to set the handle of an icon object or the pointer to a bitmap object to be displayed through `dwAddData` parameter when the static control is created. Styles associated with these two types of static control are `SS_CENTERIMAGE` and `SS_REALSIZEIMAGE`. These two styles are used to control the position of a bitmap or an icon in the control. By default, the bitmap or icon fills the whole static control by appropriate scale, but this scaling operation will be canceled when `SS_REALSIZEIMAGE` style is used, and the bitmap or icon aligns in the top-left of the static control. If `SS_REALSIZEIMAGE` style is used with `SS_CENTERIMAGE` style simultaneously, the bitmap or icon will be displayed in the center of the control. The following program creates a bitmap static control and an icon static control, and creates a bitmap static control displayed in the center of the control by using `SS_REALSIZEIMAGE` and `SS_CENTERIMAGE` styles: ```cpp CreateWindow (CTRL_STATIC, "", WS_CHILD | SS_BITMAP | WS_VISIBLE, IDC_STATIC, 100, 80, 50, 50, hWnd, (DWORD)GetSystemBitmap (SYSBMP_CHECKMARK)); CreateWindow (CTRL_STATIC, "", WS_CHILD | SS_ICON | WS_VISIBLE, IDC_STATIC, 100, 20, 50, 50, hWnd, (DWORD)GetLargeSystemIcon (IDI_INFORMATION)); CreateWindow (CTRL_STATIC, "", WS_CHILD | SS_BITMAP | SS_REALSIZEIMAGE | SS_CENTERIMAGE | WS_VISIBLE, IDC_STATIC, 100 , 140, 50, 50, hWnd, (DWORD)GetSystemBitmap (SYSBMP_CHECKMARK)); ``` __NOTE__ Many predefined controls need you pass some initial parameters of them through dwAddData parameter of CreateWindowEx function. Here the first additional data of the window is used to pass these parameters during creating the control, and the application can also use the first additional data of the window to save private data after the control has been created. The appearance of the static controls created by the above program is shown in Figure 3. ![alt](figures/19.3.jpeg) Figure 3 Static control of bitmap type ### Group Box A static control with `SS_GROUPBOX` style is called a group box, which is a special type of static control. A group box is a rectangle with the caption displayed in the top, and it is usually used to include other controls. The controls that can be created in the group box include Static, Button, Edit Box, `TextEdit`, List Box, Track Bar, Menu Button. The following program creates a group box, and its effect is shown in Figure 4: ```cpp CreateWindow (CTRL_STATIC, "A Group Box", WS_CHILD | SS_GROUPBOX | WS_VISIBLE, IDC_STATIC, 350, 10, 200, 100, hWnd, 0); ``` ![alt](figures/19.4.jpeg) ### Other static control types Besides the static controls described above, there are several other static control types not frequently used: - `SS_WHITERECT：A` rectangle filled with the light white color. - `SS_GRAYRECT：A` rectangle filled with the light gray color. - `SS_BLACKRECT：A` rectangle filled with the black color. - `SS_GRAYFRAME：A` frame drawn with the light gray color. - `SS_WHITEFRAME：A` frame drawn with the light white color. - `SS_BLACKFRAME：A` frame drawn with the black color. Appearances of the static controls using the above styles are shown in Figure 5. ![alt](figures/19.5.jpeg) Figure 5 Other static control types ## Static Control Messages When the static control is of bitmap type, the bitmap can be gotten or changed by the following messages: - `STM_GETIMAGE：This` message returns the pointer to the bitmap object or the handle to the icon. - `STM_SETIMAGE：To` set the pointer to the bitmap or the handle to the icon through `wParam` parameter, and returns the old one. ## Notification Codes of Static Control When the style of a static control includes `SS_NOTIFY`, the static control can generate the following two notification messages: - `STN_DBLCLK：Indicates` the user clicked the left button of the mouse in a static control. - `STN_CLICKED：Indicates` the user double-clicked the left button of the mouse in a static control. ## Sample Program The program in List 1 creates a bitmap static control, and changes the text when the user double-clicks the static control. Please refer to static.c of the demo program package `mg-samples` of this guide to get the complete source code of the program. The running effect of the program is shown in Figure 6. List 1 Sample program of static control ```cpp #include #include <minigui/common.h> #include <minigui/minigui.h> #include <minigui/gdi.h> #include <minigui/window.h> #include <minigui/control.h> static void my_notif_proc (HWND hwnd, int id, int nc, DWORD add_data) { /* When the user double-clicked the static control, * SetWindowText is called to change the text of the control. */ if (nc == STN_DBLCLK) SetWindowText (hwnd, "I am double-clicked. :)"); } static int StaticDemoWinProc (HWND hWnd, int message, WPARAM wParam, LPARAM lParam) { HWND hwnd; switch (message) { case MSG_CREATE: /* Create a static box and set the notification callback function */ hwnd = CreateWindow (CTRL_STATIC, "Double-click me!", WS_VISIBLE | SS_CENTER | SS_NOTIFY, 50, 80, 100, 200, 20, hWnd, 0); SetNotificationCallback (hwnd, my_notif_proc); return 0; case MSG_DESTROY: DestroyAllControls (hWnd); return 0; case MSG_CLOSE: DestroyMainWindow (hWnd); PostQuitMessage (hWnd); return 0; } return DefaultMainWinProc (hWnd, message, wParam, lParam); } /* The Following code to create the main window are omitted */ ``` ![alt](figures/19.6.jpeg) Figure 6 The sample of static control ---- [<< Universal Startup API for RTOSes](MiniGUIProgGuidePart5Chapter04.md) | [Table of Contents](README.md) | [Button Control >>](MiniGUIProgGuidePart6Chapter02.md) [Release Notes for MiniGUI 3.2]: /supplementary-docs/Release-Notes-for-MiniGUI-3.2.md [Release Notes for MiniGUI 4.0]: /supplementary-docs/Release-Notes-for-MiniGUI-4.0.md [Showing Text in Complex or Mixed Scripts]: /supplementary-docs/Showing-Text-in-Complex-or-Mixed-Scripts.md [Supporting and Using Extra Input Messages]: /supplementary-docs/Supporting-and-Using-Extra-Input-Messages.md [Using CommLCD NEWGAL Engine and Comm IAL Engine]: /supplementary-docs/Using-CommLCD-NEWGAL-Engine-and-Comm-IAL-Engine.md [Using Enhanced Font Interfaces]: /supplementary-docs/Using-Enhanced-Font-Interfaces.md [Using Images and Fonts on System without File System]: /supplementary-docs/Using-Images-and-Fonts-on-System-without-File-System.md [Using SyncUpdateDC to Reduce Screen Flicker]: /supplementary-docs/Using-SyncUpdateDC-to-Reduce-Screen-Flicker.md [Writing DRM Engine Driver for Your GPU]: /supplementary-docs/Writing-DRM-Engine-Driver-for-Your-GPU.md [Writing MiniGUI Apps for 64-bit Platforms]: /supplementary-docs/Writing-MiniGUI-Apps-for-64-bit-Platforms.md [Quick Start]: /user-manual/MiniGUIUserManualQuickStart.md [Building MiniGUI]: /user-manual/MiniGUIUserManualBuildingMiniGUI.md [Compile-time Configuration]: /user-manual/MiniGUIUserManualCompiletimeConfiguration.md [Runtime Configuration]: /user-manual/MiniGUIUserManualRuntimeConfiguration.md [Tools]: /user-manual/MiniGUIUserManualTools.md [Feature List]: /user-manual/MiniGUIUserManualFeatureList.md [MiniGUI Overview]: /MiniGUI-Overview.md [MiniGUI User Manual]: /user-manual/README.md [MiniGUI Programming Guide]: /programming-guide/README.md [MiniGUI Porting Guide]: /porting-guide/README.md [MiniGUI Supplementary Documents]: /supplementary-docs/README.md [MiniGUI API Reference Manuals]: /api-reference/README.md [MiniGUI Official Website]: http://www.minigui.com [Beijing FMSoft Technologies Co., Ltd.]: https://www.fmsoft.cn [FMSoft Technologies]: https://www.fmsoft.cn [HarfBuzz]: https://www.freedesktop.org/wiki/Software/HarfBuzz/