MiniGUI API Reference (MiniGUI-Standalone)  v3.2.0
A mature and proven cross-platform GUI system for embedded and smart IoT devices
Modules | Macros
User-machine Interaction messages

Modules

 Notification codes of srollbar control
 

Macros

#define MSG_SETCURSOR   0x0020
 Sets cursor shape in the client area. More...
 
#define MSG_NCHITTEST   0x0021
 Hit test in non-client area. This is an async message. More...
 
#define MSG_HITTEST   MSG_NCHITTEST
 Hit test in non-client area. More...
 
#define MSG_CHANGESIZE   0x0022
 Change window size. More...
 
#define MSG_QUERYCLIENTAREA   0x0024
 Query client area. More...
 
#define MSG_SIZECHANGING   0x0025
 Indicates the size of the window is being changed. More...
 
#define MSG_SIZECHANGED   0x0026
 Indicates the size of the window has been changed. More...
 
#define MSG_CSIZECHANGED   0x0027
 Indicates the size of the client area of the window has been changed. More...
 
#define MSG_SETFOCUS   0x0030
 Indicates that the window has gained the input focus. More...
 
#define MSG_KILLFOCUS   0x0031
 Indicates that the window has lost the input focus. More...
 
#define MSG_MOUSEACTIVE   0x0032
 Indicates that the window has gained the input focus because the user clicked the window. More...
 
#define MSG_ACTIVE   0x0033
 Indicates that the window has gained the input focus because the user clicked the window. More...
 
#define MSG_CHILDHIDDEN   0x0034
 Hide child window. More...
 
#define MSG_ACTIVEMENU   0x0040
 Indicates that the user activates the menu bar and tracks it. More...
 
#define MSG_DEACTIVEMENU   0x0041
 Indicates the end of the tracking of a menu bar or a popup menu. More...
 
#define MSG_HSCROLL   0x0042
 Indicates that the user has clicked the horizontal scroll bar. More...
 
#define MSG_VSCROLL   0x0043
 Indicates that the user has clicked the vertical scroll bar. More...
 
#define MSG_NCSETCURSOR   0x0044
 Sets cursor shape in the non-client area. More...
 
#define MSG_MOUSEMOVEIN   0x0050
 Indicates the mouse is moved in/out the area of the window. More...
 
#define MSG_WINDOWDROPPED   0x0051
 Indicates that user dropped window. server to client; (wParam, lParam): result rectangle. More...
 

Detailed Description

Macro Definition Documentation

#define MSG_ACTIVE   0x0033

Indicates that the window has gained the input focus because the user clicked the window.

This message is sent to the window procedure after the user clicked the window and it has gained the input focus.

Definition at line 883 of file window.h.

#define MSG_ACTIVEMENU   0x0040

Indicates that the user activates the menu bar and tracks it.

This message is sent to the window procedure when the user activates the menu bar and tracks it.

If you want to change the states of menu items in the submenu before displaying it, you can handle this message.

1 MSG_ACTIVEMENU
2 int pos = (int)wParam;
3 HMENU submenu = (HMENU)lParam;
Parameters
posThe position of the activated submenu. The position value of the first submenu is 0.
submenuThe handle to the activated submenu.

Example:

/*
* This handler checks the specified menu items to contain
* a radio bitmap by calling CheckMenuRadioItem function,
* if the submenu at position 2 has been activated.
*/
if (wParam == 2) {
IDM_40X15, IDM_CUSTOMIZE,
pConInfo->termType, MF_BYCOMMAND);
IDM_DEFAULT, IDM_BIG5,
pConInfo->termCharset, MF_BYCOMMAND);
}
break;

Definition at line 919 of file window.h.

#define MSG_CHANGESIZE   0x0022

Change window size.

Definition at line 763 of file window.h.

#define MSG_CHILDHIDDEN   0x0034

Hide child window.

Definition at line 889 of file window.h.

#define MSG_CSIZECHANGED   0x0027

Indicates the size of the client area of the window has been changed.

This message is sent as a notification to the window when the size of the client area has been changed.

1 MSG_CSIZECHANGED
2 int client_width = (int)wParam;
3 int client_height = (int)lParam;
Parameters
client_widthThe width of the client area.
client_heightThe height of the client area.

Definition at line 839 of file window.h.

#define MSG_DEACTIVEMENU   0x0041

Indicates the end of the tracking of a menu bar or a popup menu.

This message is sent to the window procedure when the user has closed the tracking menu bar or popup menu.

1 MSG_DEACTIVEMENU
2 HMENU menubar = (HMENU)wParam;
3 HMENU submenu = (HMENU)lParam;
Parameters
menubarThe handle to the menu bar. It will be zero when the deactivated menu is a popup menu.
submenuThe handle to the submenu.

Definition at line 938 of file window.h.

#define MSG_HITTEST   MSG_NCHITTEST

Hit test in non-client area.

See also
MSG_NCHITTEST

Definition at line 757 of file window.h.

#define MSG_HSCROLL   0x0042

Indicates that the user has clicked the horizontal scroll bar.

This message is sent to the window procedure when the user has clicked the horizontal scroll bar and changed the position of the thumb.

1 MSG_HSCROLL
2 int hs_nc = (int)wParam;
Parameters
hs_ncThe scrolling code, can be one of the following values:
  • SB_LINELEFT
    The user clicked the left arrow on the bar.
  • SB_LINERIGHT
    The user clicked the right arrow on the bar.
  • SB_PAGELEFT
    The user clicked the left page area on the bar.
  • SB_PAGERIGHT
    The user clicked the right page area on the bar.
  • SB_THUMBPOSITION
    The user set a new thumb position.
  • SB_THUMBTRACK
    The user is draging and tracking the thumb.
  • SB_ENDSCROLL
    The end of scrolling.

Definition at line 1067 of file window.h.

#define MSG_KILLFOCUS   0x0031

Indicates that the window has lost the input focus.

Parameters
lparamThe parameter passed into used for pass killfocus msg to child control if lparam > 0.

This message is sent to the window procedure after the window losts the input focus.

Definition at line 863 of file window.h.

#define MSG_MOUSEACTIVE   0x0032

Indicates that the window has gained the input focus because the user clicked the window.

This message is sent to the window procedure after the user clicked the window and it has gained the input focus.

Definition at line 873 of file window.h.

#define MSG_MOUSEMOVEIN   0x0050

Indicates the mouse is moved in/out the area of the window.

This message is posted to the window when the user moves the mouse in/out the area of the window.

1 MSG_MOUSEMOVEIN
2 BOOL in_out = (BOOL)wParam;
Parameters
in_outIndicates whether the mouse has been moved in the window or out the window.

Definition at line 1128 of file window.h.

#define MSG_NCHITTEST   0x0021

Hit test in non-client area. This is an async message.

Definition at line 749 of file window.h.

#define MSG_NCSETCURSOR   0x0044

Sets cursor shape in the non-client area.

This message is posted to the window under the cursor when the user moves the mouse in order to give the chance to change the cursor shape. The default handler set the cursor shape to the default cursor of the window. If you set a new cursor shape, your message handler should return immediately.

See also
MSG_SETCURSOR

Definition at line 1111 of file window.h.

#define MSG_QUERYCLIENTAREA   0x0024

Query client area.

Definition at line 772 of file window.h.

#define MSG_SETCURSOR   0x0020

Sets cursor shape in the client area.

This message is posted to the window under the cursor when the user moves the mouse in order to give the chance to change the cursor shape. The default handler set the cursor shape to the default cursor of the window. If you set a new cursor shape, your message handler should return immediately.

1 MSG_SETCURSOR
2 int cx = LOSWORD (lParam);
3 int cy = HISWORD (lParam);
Parameters
cx,cyThe client coordinates of the cursor.

Example:

/*
* The following MSG_SETCURSOR handler set the cursor
* shape to the arrow cursor when the window is disabled.
*/
if (GetWindowStyle (hwnd) & WS_DISABLED) {
return 0;
}
break;
See also
MSG_NCSETCURSOR

Definition at line 683 of file window.h.

#define MSG_SETFOCUS   0x0030

Indicates that the window has gained the input focus.

Parameters
lparamThe parameter passed into used for pass setfocus msg to child control if lparam > 0.

This message is sent to the window procedure after the window gains the input focus.

Definition at line 851 of file window.h.

#define MSG_SIZECHANGED   0x0026

Indicates the size of the window has been changed.

This message is sent to the window when the size has been changed. If you want adjust the size of the client area of the window, you should handle this message, change the values of the client area, and return non-zero value to indicate that the client area has been modified.

1 MSG_SIZECHANGED
2 RECT* rcClient = (RECT*)lParam;
Parameters
rcClientThe pointer to a RECT structure which contains the new client area.

Example:

{
RECT* rcClient = (RECT*)lParam;
rcClient->right = rcClient->left + _WIDTH;
rcClient->bottom = rcClient->top + _HEIGHT;
return 1;
}

Definition at line 821 of file window.h.

#define MSG_SIZECHANGING   0x0025

Indicates the size of the window is being changed.

This message is sent to the window when the size is being changed. If you want to control the actual position and size of the window when the size is being changed (this may be caused by MoveWindow or other functions), you should handle this message, and return the actual position and size of the window through the second parameter.

1 MSG_SIZECHANGING
2 const RECT* rcExpect = (const RECT*)wParam;
3 RECT* rcResult = (RECT*)lParam;
Parameters
rcExpectThe expected size of the window after changing.
rcResultThe actual size of the window after changing.

Example:

/*
* The handler set the actual size of the window always
* to be _WIDTH wide and _HEIGHT high.
*/
{
const RECT* rcExpect = (const RECT*)wParam;
RECT* rcResult = (RECT*)lParam;
rcResult->left = rcExpect->left;
rcResult->top = rcExpect->top;
rcResult->right = rcExpect->left + _WIDTH;
rcResult->bottom = rcExpect->top + _HEIGHT;
return 0;
}

Definition at line 797 of file window.h.

#define MSG_VSCROLL   0x0043

Indicates that the user has clicked the vertical scroll bar.

This message is sent to the window procedure when the user has clicked the vertical scroll bar and changed the position of the thumb.

1 MSG_HSCROLL
2 int vs_nc = (int)wParam;
Parameters
vs_ncThe scrolling code, can be one of the following values:
  • SB_LINEUP
    The user clicked the up arrow on the bar.
  • SB_LINEDOWN
    The user clicked the down arrow on the bar.
  • SB_PAGEUP
    The user clicked the up page area on the bar.
  • SB_PAGEDOWN
    The user clicked the down page area on the bar.
  • SB_THUMBPOSITION
    The user set a new thumb position.
  • SB_THUMBTRACK
    The user is draging and tracking the thumb.
  • SB_ENDSCROLL
    The end of scrolling.

Definition at line 1097 of file window.h.

#define MSG_WINDOWDROPPED   0x0051

Indicates that user dropped window. server to client; (wParam, lParam): result rectangle.

Definition at line 1135 of file window.h.