MiniGUI API Reference (MiniGUI-Threads)  v3.2.0
A mature and proven cross-platform GUI system for embedded and smart IoT devices
Macros
Messages of listbox control

Macros

#define LB_ADDSTRING   0xF180
 Appends the specified string. More...
 
#define LB_INSERTSTRING   0xF181
 Inserts an item to the list box. More...
 
#define LB_DELETESTRING   0xF182
 Removes an item from the list box. More...
 
#define LB_SELITEMRANGEEX   0xF183
 reserved. More...
 
#define LB_RESETCONTENT   0xF184
 Removes the contents of a list box. More...
 
#define LB_GETSEL   0xF187
 Gets the selected state for an specified item. More...
 
#define LB_SETSEL   0xF185
 Selects an item in a multiple-selection list box. More...
 
#define LB_GETCURSEL   0xF188
 Gets the index of the currently selected or highlighted item. More...
 
#define LB_SETCURSEL   0xF186
 Selects an item. More...
 
#define LB_GETTEXT   0xF189
 Retrieves the text of an item in list box. More...
 
#define LB_GETTEXTLEN   0xF18A
 Gets the length of text of item specified in a list box. More...
 
#define LB_GETCOUNT   0xF18B
 Gets the number of items in the list box. More...
 
#define LB_SELECTSTRING   0xF18C
 reserved. More...
 
#define LB_DIR   0xF18D
 reserved. More...
 
#define LB_GETTOPINDEX   0xF18E
 Gets the index to the first visible item in the list box. More...
 
#define LB_FINDSTRING   0xF18F
 Searchs a specified string. More...
 
#define LB_GETSELCOUNT   0xF190
 Gets the number of selected items in a multiple-selection list box. More...
 
#define LB_GETSELITEMS   0xF191
 Gets the numbers of selected items. More...
 
#define LB_GETHORIZONTALEXTENT   0xF193
 reserved. More...
 
#define LB_SETHORIZONTALEXTENT   0xF194
 reserved. More...
 
#define LB_SETCOLUMNWIDTH   0xF195
 reserved. More...
 
#define LB_ADDFILE   0xF196
 reserved. More...
 
#define LB_SETTOPINDEX   0xF197
 Ensures that a particular item in it is visible. More...
 
#define LB_GETITEMRECT   0xF198
 Retrieves the dimensions of the rectangle. More...
 
#define LB_GETITEMDATA   0xF199
 Gets item data in a list box if the box has LBS_CHECKBOX and/or LBS_USEICON styles. More...
 
#define LB_SETITEMDATA   0xF19A
 Sets item data in a list box if the box has LBS_CHECKBOX and/or LBS_USEICON styles. More...
 
#define LB_SETCARETINDEX   0xF19E
 Sets the focus rectangle to the item at the specified index. More...
 
#define LB_GETCARETINDEX   0xF19F
 Determines the index of the item that has the focus rectangle. More...
 
#define LB_SETITEMHEIGHT   0xF1A0
 Sets the height of all items. More...
 
#define LB_GETITEMHEIGHT   0xF1A1
 Gets the height in pixels of an item specified in the wParam parameter. More...
 
#define LB_FINDSTRINGEXACT   0xF1A2
 Searchs for an item that exactly matches the characters specified. More...
 
#define LB_SETLOCALE   0xF1A5
 reserved. More...
 
#define LB_GETLOCALE   0xF1A6
 reserved. More...
 
#define LB_SETCOUNT   0xF1A7
 reserved. More...
 
#define LB_INITSTORAGE   0xF1A8
 reserved. More...
 
#define LB_ITEMFROMPOINT   0xF1A9
 reserved. More...
 
#define LB_SETTEXT   0xF1AA
 Sets text of the specified item. More...
 
#define LB_GETCHECKMARK   0xF1AB
 Gets check mark status of an item. More...
 
#define LB_SETCHECKMARK   0xF1AC
 Sets check mark status of an item. More...
 
#define LB_GETITEMADDDATA   0xF1AD
 Gets the 32-bit data value associated with an item. More...
 
#define LB_SETITEMADDDATA   0xF1AE
 Associates a 32-bit data value with an item. More...
 
#define LB_SETSTRCMPFUNC   0xF1AF
 Sets the STRCMP function used to sort items. More...
 
#define LB_SETITEMDISABLE   0xF1B0
 Sets the item disable. More...
 
#define LB_GETITEMDISABLE   0xF1B1
 Get the item disable status. More...
 
#define LB_SETITEMBOLD   0xF1B2
 Sets the item display use bold font. More...
 
#define LB_MULTIADDITEM   0xF1B3
 Appends the multi strings. More...
 

Detailed Description

Macro Definition Documentation

#define LB_ADDFILE   0xF196

reserved.

Definition at line 645 of file listbox.h.

#define LB_ADDSTRING   0xF180

Appends the specified string.

An application sends an LB_ADDSTRING message to append an item specified in the lParam parameter to a list box.

For a text-only list box:

1 LB_ADDSTRING
2 const char* text;
3 
4 wParam = 0;
5 lParam = (LPARAM)text;
Parameters
textPointer to the string of the item to be added.

For a list box with check box or icon (with LBS_CHECKBOX or LBS_USEICON styles):

1 LB_ADDSTRING
2 PLISTBOXITEMINFO plbii;
3 
4 wParam = 0;
5 lParam = (LPARAM)plbii;
Parameters
plbiiPointer to the listbox item info to be added.
Returns
The index of the new item on success, else the one of the following error codes:
  • LB_ERRSPACE No memory can be allocated for new item.
  • LB_ERR Invalid passed arguments.

Definition at line 265 of file listbox.h.

#define LB_DELETESTRING   0xF182

Removes an item from the list box.

An application sends an LB_DELETESTRING message to a list box to remove from the list box.

1 LB_DELETESTRING
2 int del;
3 
4 wParam = (WPARAM)del;
5 lParam = 0;
Parameters
delThe index of the listbox item to be deleted.
Returns
LB_OKAY on success, else LB_ERR to indicate you passed an invalid index.

Definition at line 331 of file listbox.h.

#define LB_DIR   0xF18D

reserved.

Definition at line 528 of file listbox.h.

#define LB_FINDSTRING   0xF18F

Searchs a specified string.

An application sends an LB_FINDSTRING message to search a list box for an item that begins with the characters specified in the lParam parameter. The wParam parameter specifies the zero-based index of the item before the first item to be searched; The lParam parameter specifies a pointer to a null-terminated string that contains the prefix to search for.

1 LB_FINDSTRING
2 int index;
3 char *string;
4 
5 wParam = (WPARAM)index;
6 lParam = (LPARAM)string;
Parameters
indexThe index of the item to be searched.
stringThe string of the item to be searched.
Returns
The index of the matched item; LB_ERR for not found.

Definition at line 573 of file listbox.h.

#define LB_FINDSTRINGEXACT   0xF1A2

Searchs for an item that exactly matches the characters specified.

An application sends an LB_FINDSTRINGEXACT message to a list box to search it for an item that exactly matches the characters specified in the lParam parameter.

1 LB_FINDSTRINGEXACT
2 int index;
3 const char *string;
4 
5 wParam = (WPARAM)index;
6 lParam = (LPARAM)string;
Parameters
indexThe index of the specified item.
stringThe string of the item to be searched for.
Returns
The index of the found item on success, else LB_ERR.

Definition at line 853 of file listbox.h.

#define LB_GETCARETINDEX   0xF19F

Determines the index of the item that has the focus rectangle.

An application sends an LB_GETCARETINDEX message to a list box to determine the index of the item that has the focus rectangle in a multiple-selection list box.

1 LB_GETCARETINDEX
2 
3 wParam = 0;
4 lParam = 0;
Returns
The index of the item that has the focus rectangle.

Definition at line 791 of file listbox.h.

#define LB_GETCHECKMARK   0xF1AB

Gets check mark status of an item.

1 LB_GETCHECKMARK
2 int index;
3 
4 wParam = (WPARAM)index;
5 lParam = 0;
Parameters
indexThe index of the specified item.
Returns
The check mark status of specified item on success; LB_ERR on error.
Return values
LB_ERRInvalid item index or the list box have no LBS_CHECKBOX style.
CMFLAG_CHECKEDThe item is checked.
CMFLAG_PARTCHECKEDThe item is partly checked.
CMFLAG_BLANKThe item is not checked.

Definition at line 924 of file listbox.h.

#define LB_GETCOUNT   0xF18B

Gets the number of items in the list box.

An application sends an LB_GETCOUNT message to a list box to get the number of items in the list box.

1 LB_GETCOUNT
2 
3 wParam = 0;
4 lParam = 0;
Returns
The number of items in the listbox.

Definition at line 516 of file listbox.h.

#define LB_GETCURSEL   0xF188

Gets the index of the currently selected or highlighted item.

An application sends an LB_GETCURSEL message to a list box to get the index of the currently selected item, if there is one, in a single-selection list box. For multiple-selection list box, appliction send an LB_GETCURSEL message to a list box to get the index of the current highlighted item.

1 LB_GETCURSEL
2 
3 wParam = 0;
4 lParam = 0;
Returns
The index of the currently selected item for single-selection list box; Else the index of the highlighted item for multiple-selection list box.

Definition at line 427 of file listbox.h.

#define LB_GETHORIZONTALEXTENT   0xF193

reserved.

Definition at line 627 of file listbox.h.

#define LB_GETITEMADDDATA   0xF1AD

Gets the 32-bit data value associated with an item.

An application sends an LB_GETITEMADDDATA message to a list box to get the 32-bit data value the list box has stored for the item with index of wParam; By default this is zero. An application must set the item data value by sending an LB_SETITEMADDDATA message to the list box for this value to have meaning.

1 LB_GETITEMADDDATA
2 int index;
3 
4 wParam = (WPARAM)index;
5 lParam = 0;
Parameters
indexThe index of the specified item.
Returns
The 32-bit data value associated with an item on success, otherwise LB_ERR to indicate an error.

Definition at line 974 of file listbox.h.

#define LB_GETITEMDATA   0xF199

Gets item data in a list box if the box has LBS_CHECKBOX and/or LBS_USEICON styles.

An application sends LB_GETITEMDATA message to a list box to retrive the check box flag and the handle of icon. Note that the text of the item will not be returned, i.e., the field of string of LISTBOXITEMINFO structure will be ignored.

1 LB_GETITEMDATA
2 int index;
3 PLISTBOXITEMINFO plbii;
4 
5 wParam = (WPARAM)index;
6 lParam = (LPARAM)plbii;
Parameters
indexThe index of the specified item.
plbiiPointer to the buffer used for storing the item data of the specified item.
Returns
LB_OKAY on success; LB_ERR on error.
See also
LISTBOXITEMINFO

Definition at line 722 of file listbox.h.

#define LB_GETITEMDISABLE   0xF1B1

Get the item disable status.

An application sends an LB_SETITEMDISABLE message to get a item to disable status.

1 wParam = index;
2 lParam = 0;
Returns
One of the following values:
  • TRUE
    Item is disable
  • FLASE
    Item is enable

Definition at line 1066 of file listbox.h.

#define LB_GETITEMHEIGHT   0xF1A1

Gets the height in pixels of an item specified in the wParam parameter.

An application sends an LB_GETITEMHEIGHT message to a list box to get the height in pixels of an item specified in the wParam parameter.

1 LB_GETITEMHEIGHT
2 
3 wParam = 0;
4 lParam = 0;
Returns
The height of item in the listbox.

Definition at line 830 of file listbox.h.

#define LB_GETITEMRECT   0xF198

Retrieves the dimensions of the rectangle.

An application sends an LB_GETITEMRECT message to a list box to retrieve the dimensions of the rectangle that bounds an item as it is currently displayed in the list box window. The item is specified in the wParam parameter, and a pointer to a RECT structure is given in the lParam parameter.

1 LB_GETITEMRECT
2 int index;
3 RECT *rcItem;
4 
5 wParam = (WPARAM)index;
6 lParam = (LPARAM)rcItem;
Parameters
indexThe index of the specified item.
rcItemPointer to the buffer used for storing the item rect;
Returns
LB_OKAY on success; LB_ERR on error.

Definition at line 693 of file listbox.h.

#define LB_GETLOCALE   0xF1A6

reserved.

Definition at line 864 of file listbox.h.

#define LB_GETSEL   0xF187

Gets the selected state for an specified item.

An application sends an LB_GETSEL message to a list box to get the selected state for an item specified in the wParam parameter.

1 LB_GETSEL
2 int index;
3 
4 wParam = (WPARAM)index;
5 lParam = 0;
Parameters
indexThe index of the specified item.
Returns
The state of the specified item:
  • 0
    Not selected.
  • >0
    Selected.
  • LB_ERR
    Invalid index.

Definition at line 379 of file listbox.h.

#define LB_GETSELCOUNT   0xF190

Gets the number of selected items in a multiple-selection list box.

An application sends an LB_GETSELCOUNT message to a list box to get the number of selected items in a multiple-selection list box.

1 LB_GETSELCOUNT
2 
3 wParam = 0;
4 lParam = 0;
Returns
The number of selected items in the multiple-selection listbox.

Definition at line 591 of file listbox.h.

#define LB_GETSELITEMS   0xF191

Gets the numbers of selected items.

An application sends an LB_GETSELITEMS message to a list box to fill a buffer with an array of integers that specify the item numbers of selected items in a multiple-selection list box.

1 LB_GETSELITEMS
2 int nItem;
3 int *pInt;
4 
5 wParam = (WPARAM)nItem;
6 lParam = (LPARAM)pInt;
Parameters
nItemThe maximum integer numbers wanted.
pIntThe buffer of an array of integers to save the indices of selected items.
Returns
The number of selected items.

Definition at line 615 of file listbox.h.

#define LB_GETTEXT   0xF189

Retrieves the text of an item in list box.

An application sends an LB_GETTEXT message to a list box to retrieve the text of an item.

1 LB_GETTEXT
2 int index;
3 char *string;
4 
5 wParam = (WPARAM)index;
6 lParam = (LPARAM)string;
Parameters
indexThe index of the selected item.
stringPointer to the string buffer. The buffer should be large enough to contain the text of the item.
Returns
One of the following values:
  • LB_OKAY
    Success.
  • LB_ERR
    Invalid item index.
See also
LB_GETTEXTLEN

Definition at line 477 of file listbox.h.

#define LB_GETTEXTLEN   0xF18A

Gets the length of text of item specified in a list box.

An application sends an LB_GETTEXTLEN message to a list box to get the length of text of the item specified in the wParam parameter.

1 LB_GETTEXTLEN
2 int index;
3 
4 wParam = (WPARAM)index;
5 lParam = 0;
Parameters
indexThe index of the specified item.
Returns
The length of the strings on success, else LB_ERR to indicate invalid index.

Definition at line 498 of file listbox.h.

#define LB_GETTOPINDEX   0xF18E

Gets the index to the first visible item in the list box.

An application sends an LB_GETTOPINDEX message to get the index to the first visible item in the list box. Initially, the first visible item is item 0, but this changes as the list box is scrolled.

1 LB_GETTOPINDEX
2 
3 wParam = 0;
4 lParam = 0;
Returns
The index of the first visible item in the listbox.

Definition at line 547 of file listbox.h.

#define LB_INITSTORAGE   0xF1A8

reserved.

Definition at line 874 of file listbox.h.

#define LB_INSERTSTRING   0xF181

Inserts an item to the list box.

An application sends an LB_INSERTSTRING message to insert an item into a list box. Unlike LB_ADDSTRING message, the LB_INSERTSTRING message do not cause the list to be sorted.

For a text-only list box:

1 LB_INSERTSTRING
2 const char* text;
3 
4 wParam = index;
5 lParam = (LPARAM)text;
Parameters
indexSpecifies the index of the position at which to insert the item.
textPointer to the string of the item to be inserted.

For a list box with check box or icon (with LBS_CHECKBOX or LBS_USEICON styles):

1 LB_INSERTSTRING
2 int index;
3 PLISTBOXITEMINFO plbii;
4 
5 wParam = (WPARAM)index;
6 lParam = (LPARAM)plbii;
Parameters
indexSpecifies the index of the position at which to insert the item.
plbiiPointer to the listbox item info to be inserted.
Returns
The index of the new item on success, else the one of the following error codes:
  • LB_ERRSPACE No memory can be allocated for new item.
  • LB_ERR Invalid passed arguments.

Definition at line 310 of file listbox.h.

#define LB_ITEMFROMPOINT   0xF1A9

reserved.

Definition at line 879 of file listbox.h.

#define LB_MULTIADDITEM   0xF1B3

Appends the multi strings.

An application sends an LB_MULTIADDITEM message to append item array specified in the lParam parameter to a list box.

For a text-only list box:

1 LB_MULTIADDITEM
2 int num;
3 const char text[num][];
4 
5 wParam = num;
6 lParam = (LPARAM)text;
Parameters
numis count of text array
textpointer to the string of the item array to be added.

For a list box with check box or icon (with LBS_CHECKBOX or LBS_USEICON styles):

1 LB_MULTIADDITEM
2 LISTBOXITEMINFO plbii[num];
3 
4 wParam = num;
5 lParam = (LPARAM)plbii;
Parameters
numis count of plbii array
plbiipointer to the listbox item info to be added.
Returns
The index of the new item on success, else the one of the following error codes:
  • LB_ERRSPACE No memory can be allocated for new item.
  • LB_ERR Invalid passed arguments.

Definition at line 1128 of file listbox.h.

#define LB_RESETCONTENT   0xF184

Removes the contents of a list box.

An application sends an LB_RESETCONTENT message to remove the all items in a list box.

1 LB_RESETCONTENT
2 
3 wParam = 0;
4 lParam = 0;
Returns
Always be zero.

Definition at line 355 of file listbox.h.

#define LB_SELECTSTRING   0xF18C

reserved.

Definition at line 522 of file listbox.h.

#define LB_SELITEMRANGEEX   0xF183

reserved.

#define LB_SETCARETINDEX   0xF19E

Sets the focus rectangle to the item at the specified index.

An application sends an LB_SETCARETINDEX message to set the focus rectangle to the item at the specified index in a multiple-selection list box.

1 LB_SETCARETINDEX
2 int index;
3 
4 wParam = (WPARAM)index;
5 lParam = 0;

Definition at line 772 of file listbox.h.

#define LB_SETCHECKMARK   0xF1AC

Sets check mark status of an item.

1 LB_SETCHECKMARK
2 int index, status;
3 
4 wParam = (WPARAM)index;
5 lParam = (LPARAM)status;
Parameters
indexThe index of the specified item.
statusThe new check mark status, can be one of the followings.
  • CMFLAG_CHECKED
    The item is checked.
  • CMFLAG_PARTCHECKED
    The item is partly checked.
Returns
One of the following values:
  • LB_OKAY
    Success
  • LB_ERR
    Invalid item index or this list box have no LBS_CHECKBOX style.

Definition at line 949 of file listbox.h.

#define LB_SETCOLUMNWIDTH   0xF195

reserved.

Definition at line 639 of file listbox.h.

#define LB_SETCOUNT   0xF1A7

reserved.

Definition at line 869 of file listbox.h.

#define LB_SETCURSEL   0xF186

Selects an item.

An application sends an LB_SETCURSEL message to a list box to select an item and scroll it into view, if necessary.

1 LB_SETCURSEL
2 int cursel;
3 
4 wParam = (WPARAM)cursel;
5 lParam = 0;
Parameters
curselThe index of the item to be selected and hilighted.
Returns
The old index of the item selected on error, else LB_ERR to indicate an error occurred.

Definition at line 449 of file listbox.h.

#define LB_SETHORIZONTALEXTENT   0xF194

reserved.

Definition at line 633 of file listbox.h.

#define LB_SETITEMADDDATA   0xF1AE

Associates a 32-bit data value with an item.

An application sends an LB_SETITEMADDDATA message to associate a 32-bit data value specified in the lParam parameter with an item in the list box.

1 LB_SETITEMADDDATA
2 int index;
3 DWORD addData;
4 
5 wParam = (WPARAM)index;
6 lParam = (LPARAM)addData;
Parameters
indexThe index of the specified item.
addDatathe 32-bit data value which will associated with the item.
Returns
One of the following values:
  • LB_OKAY
    Success
  • LB_ERR
    Invalid item index

Definition at line 999 of file listbox.h.

#define LB_SETITEMBOLD   0xF1B2

Sets the item display use bold font.

An application sends an LB_SETITEMBOLD message to set a item display use bold font.

1 wParam = index;
2 lParam = (LPARAM)bold;
Returns
One of the following values:
  • LB_OKAY
    Success
  • LB_ERR
    index of item is not exist.

Definition at line 1084 of file listbox.h.

#define LB_SETITEMDATA   0xF19A

Sets item data in a list box if the box has LBS_CHECKBOX and/or LBS_USEICON styles.

An application sends LB_SETITEMDATA message to a list box to set the check box flag and the handle of icon. Note that the text of the item will not be changed, i.e., the field of string of LISTBOXITEMINFO structure will be ignored.

1 LB_SETITEMDATA
2 int index;
3 PLISTBOXITEMINFO plbii;
4 
5 wParam = (WPARAM)index;
6 lParam = (LPARAM)plbii;
Parameters
indexThe index of the specified item.
plbiiPointer to the buffer used for setting the item info of the specified item.
Returns
LB_OKAY on success; LB_ERR on error.
See also
LISTBOXITEMINFO

Definition at line 751 of file listbox.h.

#define LB_SETITEMDISABLE   0xF1B0

Sets the item disable.

An application sends an LB_SETITEMDISABLE message to set a item to disable.

1 wParam = index;
2 lParam = (LPARAM)disable;
Returns
One of the following values:
  • LB_OKAY
    Success
  • LB_ERR
    index of item is not exist.

Definition at line 1048 of file listbox.h.

#define LB_SETITEMHEIGHT   0xF1A0

Sets the height of all items.

An application sends an LB_SETITEMHEIGHT message to set the height of all items in a list box.

1 LB_SETITEMHEIGHT
2 int itemHeight;
3 
4 wParam = 0;
5 lParam = (LPARAM)itemHeight;
Parameters
itemHeightNew height of item.
Returns
The effective height of item.

Definition at line 812 of file listbox.h.

#define LB_SETLOCALE   0xF1A5

reserved.

Definition at line 859 of file listbox.h.

#define LB_SETSEL   0xF185

Selects an item in a multiple-selection list box.

An application sends an LB_SETSEL message to select an item in a multiple-selection list box and scroll it into view if necessary.

1 LB_SETSEL
2 int index, sel
3 
4 wParam = (WPARAM)sel;
5 lParam = (LPARAM)index;
Parameters
selIndicates the changes to be made to the listbox item, can be one of the following values:
  • -1
    If the item has been selected, makes it unselected, vice versa.
  • 0
    Makes the item unselected.
  • other
    Makes the item selected.
indexThe index of the item.
Returns
LB_OKAY on success, else LB_ERR to indicate you passed an invalid index or the list box has no LBS_MULTIPLESEL style.

Definition at line 406 of file listbox.h.

#define LB_SETSTRCMPFUNC   0xF1AF

Sets the STRCMP function used to sort items.

An application sends an LB_SETSTRCMPFUNC message to set a new STRCMP function to sort items.

Note that you should send this message before adding any item to the list box control.

1 static int my_strcmp (const char* s1, const char* s2, size_t n)
2 {
3  ...
4  return 0;
5 }
6 
7 LB_SETSTRCMPFUNC
8 
9 wParam = 0;
10 lParam = (LPARAM)my_strcmp;
Parameters
my_strcmpYour own function to compare two strings.
Returns
One of the following values:
  • LB_OKAY
    Success
  • LB_ERR
    Not an empty list box.

Definition at line 1030 of file listbox.h.

#define LB_SETTEXT   0xF1AA

Sets text of the specified item.

1 LB_SETTEXT
2 int index;
3 const char *string;
4 
5 wParam = (WPARAM)index;
6 lParam = (LPARAM)string;
Parameters
indexThe index of the specified item.
stringThe string of the item to be set.
Returns
One of the following values:
  • LB_OKAY
    Success
  • LB_ERR
    Invalid item index or memory allocation error.

Definition at line 901 of file listbox.h.

#define LB_SETTOPINDEX   0xF197

Ensures that a particular item in it is visible.

An application sends an LB_SETTOPINDEX message to a list box to ensure that a particular item in it is visible. The item is specified in the wParam parameter. The list box scrolls so that either the specified item appears at the top of the list box or the maximum scroll range has been reached.

1 LB_SETTOPINDEX
2 int index;
3 
4 wParam = (WPARAM)index;
5 lParam = 0;
Parameters
indexThe index of the particular item to be set.
Returns
Always be zero.

Definition at line 668 of file listbox.h.