minigui-docs/programming-guide/MiniGUIProgGuidePart1Chapter12.md

Using mGUtils

mGUtils is a component of MiniGUI, which provides some common dialog boxes as window templates for applications, such as opening files, choosing color values, etc. It also has appropriate customization and flexibility for user, such as adjusting control layout, changing default control properties (text color, visible and invisible, background), adding new control to default dialog box, etc.

Functions

mGUtils provide the following common dialog boxes:

• Open and save as dialog boxes.
• Color dialog box.
• Font dialog box.
• Info dialog box.

mGUtils have the following appropriate customization and flexibility for common dialog boxes:

• Change the size of the dialog box.
• Change the layout of the standard controls in the default template, which defines the number, type, and position of the standard controls in thedialog box.
• Change the properties/styles of the standard and application custom controls.
• Add new controls in the space already available in the dialog box.

Note: Some properties/styles mustn't be changed in default controls, such as ID, control class name, etc.

mGUtils provide the following common windows (these windows is reserved old implementation,):

• Virtual console window.
• Status information window.
• Progress information window.
• Tooltip information window.
• Menu List selection window.
• Entries input window.

Using sample

To meets the need of appropriate customization and flexibility, it needs make a better separation of the appearance and applied logic for common dialog boxes. In application's layer, user is only concerned about the appearance of dialog. In other words, the default controls' applied logic is implemented in mGUtils library.

So we provide a hook mechanism and DLGTEMPLATE structure for user to meet customization demand. The type of hook function is the pointer to WNDPROC, which is a member of common dialog box structure.

For control's appearance in common dialog box, the following properties mustn't be changed:

• class_name.
• id.

And the following control's properties can be changed:

• position and size.
• caption content.
• text color.
• background information.
• renderer.

When you provide a standard hook function for one of the common dialog boxes, the default dialog box procedure processes the MSG_INITDIALOG message first, and then calls the hook function. The lParam parameter, which is a pointer to the initialization structure specified when the dialog was created in MSG_INITDIALOG, will be passed to hook function.

Code:

Common Dialog Box

Open and Save As Dialog Boxes

The Open dialog box displays a model dialog box that lets the user specify the directory, and the name of a file to open. The Save As dialog box displays a model dialog box that lets the user specify the directory, and name of a file to save.

• FileOpenSaveDialog

In mGUtils, at least we need provide two optional file dialog: Open file and save file Dialog.

Figure 1 Open File Dialog

Figure 2 Open File Dialog

ID	class name	remarks
IDC_FOSD_PATH_NOTE	CTRL_STATIC	optional
IDC_FOSD_PATH	CTRL_COMBOBOX
IDC_FOSD_UPPER	CTRL_BUTTON	optional
IDC_FOSD_FILELIST	CTRL_LISTVIEW
IDC_FOSD_FILENAME_NOTE	CTRL_STATIC
IDC_FOSD_FILENAME	CTRL_SLEDIT
IDC_FOSD_FILETYPE_NOTE	CTRL_STATIC
IDC_FOSD_FILETYPE	CTRL_COMBOBOX
IDC_FOSD_ISHIDE	CTRL_BUTTON	optional
IDC_FOSD_OK	CTRL_BUTTON
IDC_FOSD_CANCEL	CTRL_BUTTON

Color Dialog Box

The color dialog box displays a modal dialog box that allows the user to choose a specific color value.

• ColorSelectDialog

Illustration:

Figure 3 Color Select Dialog

Figure 4 Small Color Select Dialog

ID	class name	remarks
IDC_CSD_BASIC_COLOR_NOTE	CTRL_STATIC
IDC_CSD_BASIC_COLOR_0	CTRL_STATIC
IDC_CSD_BASIC_COLOR_1	CTRL_STATIC
IDC_CSD_BASIC_COLOR_2	CTRL_STATIC
IDC_CSD_BASIC_COLOR_3	CTRL_STATIC
IDC_CSD_BASIC_COLOR_4	CTRL_STATIC
IDC_CSD_BASIC_COLOR_5	CTRL_STATIC
IDC_CSD_BASIC_COLOR_6	CTRL_STATIC
IDC_CSD_BASIC_COLOR_7	CTRL_STATIC
IDC_CSD_BASIC_COLOR_8	CTRL_STATIC
IDC_CSD_BASIC_COLOR_9	CTRL_STATIC
IDC_CSD_BASIC_COLOR_10	CTRL_STATIC
IDC_CSD_BASIC_COLOR_11	CTRL_STATIC
IDC_CSD_BASIC_COLOR_12	CTRL_STATIC
IDC_CSD_BASIC_COLOR_13	CTRL_STATIC
IDC_CSD_BASIC_COLOR_14	CTRL_STATIC
IDC_CSD_BASIC_COLOR_15	CTRL_STATIC
IDC_CSD_BASIC_COLOR_16	CTRL_STATIC
IDC_CSD_BASIC_COLOR_17	CTRL_STATIC
IDC_CSD_BASIC_COLOR_18	CTRL_STATIC
IDC_CSD_BASIC_COLOR_19	CTRL_STATIC
IDC_CSD_BASIC_COLOR_20	CTRL_STATIC
IDC_CSD_BASIC_COLOR_21	CTRL_STATIC
IDC_CSD_BASIC_COLOR_22	CTRL_STATIC
IDC_CSD_BASIC_COLOR_23	CTRL_STATIC
IDC_CSD_BASIC_COLOR_24	CTRL_STATIC
IDC_CSD_BASIC_COLOR_25	CTRL_STATIC
IDC_CSD_BASIC_COLOR_26	CTRL_STATIC
IDC_CSD_BASIC_COLOR_27	CTRL_STATIC
IDC_CSD_BASIC_COLOR_28	CTRL_STATIC
IDC_CSD_BASIC_COLOR_29	CTRL_STATIC
IDC_CSD_CUSTOM_COLOR_NOTE	CTRL_STATIC
IDC_CSD_CUSTOM_COLOR_0	CTRL_STATIC
IDC_CSD_CUSTOM_COLOR_1	CTRL_STATIC
IDC_CSD_CUSTOM_COLOR_2	CTRL_STATIC
IDC_CSD_CUSTOM_COLOR_3	CTRL_STATIC
IDC_CSD_CUSTOM_COLOR_4	CTRL_STATIC
IDC_CSD_CUSTOM_COLOR_5	CTRL_STATIC
IDC_CSD_SPACE	CTRL_STATIC
IDC_CSD_YSPACE	CTRL_STATIC
IDC_CSD_COLOR	CTRL_STATIC
IDC_CSD_NOTE_Y	CTRL_STATIC
IDC_CSD_NOTE_U	CTRL_STATIC
IDC_CSD_NOTE_V	CTRL_STATIC
IDC_CSD_NOTE_R	CTRL_STATIC
IDC_CSD_NOTE_G	CTRL_STATIC
IDC_CSD_NOTE_B	CTRL_STATIC
IDC_CSD_VALUE_Y	CTRL_SLEDIT
IDC_CSD_VALUE_U	CTRL_SLEDIT
IDC_CSD_VALUE_V	CTRL_SLEDIT
IDC_CSD_VALUE_R	CTRL_SLEDIT
IDC_CSD_VALUE_G	CTRL_SLEDIT
IDC_CSD_VALUE_B	CTRL_SLEDIT
IDC_CSD_ADD	CTRL_BUTTON
IDC_CSD_OK	CTRL_BUTTON
IDC_CSD_CANCEL	CTRL_BUTTON

Font Dialog Box

The Font dialog box displays a model dialog box that lets the user choose attributes for a logical font, such as family, style (bold, italic, or regular), point size, effects (underline, strikeout, and text color, etc), and character set.

• FontSelectDialog

• Font style: NIL\ALL\BLACK\BOLD\BOOK\DEMIBOLD\LIGHT\MEDIUM\REGULAR\SUBPIXEL
• Font:

Illustration:

Figure 5 Small Color Select Dialog

ID	class name	remarks
IDC_FSD_FONT_NOTE	CTRL_STATIC
IDC_FSD_FONT	CTRL_COMBOBOX
IDC_FSD_STYLE_NOTE	CTRL_STATIC
IDC_FSD_STYLE	CTRL_COMBOBOX
IDC_FSDSIZE_NOTE	CTRL_STATIC
IDC_FSD_SIZE	CTRL_COMBOBOX
IDC_FSD_EFFECTS_NOTE	CTRL_STATIC	WS_GROUP
IDC_FSD_FLIP_NOTE	CTRL_STATIC
IDC_FSD_FLIP	CTRL_COMBOBOX
IDC_FSD_COLOR_NOTE	CTRL_STATIC
IDC_FSD_COLOR	CTRL_COMBOBOX
IDC_FSD_ITALIC	CTRL_BUTTON
IDC_FSD_STRIKEOUT	CTRL_BUTTON
IDC_FSD_UNDERLINE	CTRL_BUTTON
IDC_FSD_SAMPLE_NOTE	CTRL_STATIC
IDC_FSD_SAMPLE	CTRL_STATIC
IDC_FSD_CHARSET_NOTE	CTRL_STATIC
IDC_FSD_CHARSET	CTRL_COMBOBOX
IDC_FSD_OK	CTRL_BUTTON
IDC_FSD_CANCEL	CTRL_BUTTON

Info Dialog Box

The Info dialog box displays user-defined information.

• InfoShowDialog

Illustration:

Figure 6 Small Color Select Dialog

ID	class name	remarks
IDC_IFD_SPIN	CTRL_SPINBOX

Common window dialog

These common window dialog box displays user-defined information.

• myMessgeBox: Creates a message box.

creates a message box calling MessageBox and passing hwnd, it also receives printf-like arguments to format a string. return Identifier of the button which closes the message box.

Figure 7 Small Color Select Dialog

• ProgressBar: Creates a main window within a progress bar.

creates a main window within a progress bar and returns the handle. Note that you can use SendDlgItemMessage to send a message to the progress bar in the main window in order to update the progress bar.

Figure 8 Progress Box

• Other common dialog:
• createStatusWin: creates a status main window
• errorWindow: creates a message box by using myMessageBox, and display the current system error message
• myWinTernary: creates a message box hosted to the main window, displays a message and an application icon in the message box, and creates two buttons in it
• myWinMessage: creates a message box within only one button
• myWinMenu:creates a menu main window including a few buttons, and a list box with checkable item.
• myWinEntries: Creates a entry main window for the user to enter something

• Using Sample

How to using message box and progress bar, you should enable --enable-ctrlpgbar first before you use an progress bar dialog.

Message

MSG_FILESELOK

An Open or Save As dialog box sends the MSG_FILESELOK message to the hook procedure, when the user specifies a file name and clicks the OK button. The hook procedure can accept the file name and allow the dialog box to close, or reject the file name and force the dialog box to remain open.

Parameters:

• wParam: not used.
• lParam: The pointer to an FILEDLGDATA structure. The filefullname member of this structure contains the path, and file name specified by the user.

Return value:

• If the hook procedure returns zero, the Open or Save As dialog box accepts the specified file name and closes.
• If the hook procedure returns a nonzero value, the Open or Save As dialog box rejects the specified file name and remains open.

MSG_COLORSELOK

An Color dialog box sends the MSG_COLORSELOK message to the hook procedure, when the user selects a color and clicks the OK button. The hook procedure can accept the color and allow the dialog box to close, or reject the color and force the dialog box to remain open.

Parameters:

• wParam: not used.
• lParam: The pointer to an COLORDLGDATA structure. The r, g, b member of this structure contain the RGB color value of the selected color.

Return value:

• If the hook procedure returns zero, the Color dialog box accepts the selected color and closes.
• If the hook procedure returns a nonzero value, the Color dialog box rejects the selected color and remains open.

MSG_FONTSELOK

An Font dialog box sends the MSG_FONTSELOK message to the hook procedure, when the user specifies a logical font and clicks the OK button. The hook procedure can accept logical font and allow the dialog box to close, or reject the logical font and force the dialog box to remain open.

Parameters:

• wParam: not used.
• lParam: The pointer to an FONTDLGDATA structure. The logfont member of this structure contains the logical font specified by the user.

Return value:

• If the hook procedure returns zero, the Font dialog box accepts the specified logical font and closes.
• If the hook procedure returns a nonzero value, the Font dialog box rejects the specified logical font and remains open.

---

<< Other Programming Topic | Table of Contents | Brief Introduction to mGNCS >>

[Writing DRI Engine Driver for Your GPU]: /supplementary-docs/Writing-DRI-Engine-Driver-for-Your-GPU.md [Writing MiniGUI Apps for 64-bit Platforms]: /supplementary-docs/Writing-MiniGUI-Apps-for-64-bit-Platforms.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