 图 p2c6-1 scrollview 程序的输出 Figure p2c6-1 Output of scrollview Program
清单 p214-1 scrollview.c
List p214-1 scrollview.c
```cpp %INCLUDE{"%ATTACHURL%/scrollview"}% ``` ## `mListBox` - *控件窗口类*: `NCSCTRL_LISTBOX` - *控件英文名*: `ListBox` - *简介*: 将用户提供的一系列可选项显示在可滚动的子窗口中，用户可通过键盘及鼠标操作来选中某一项或者多个项，选中的列表项通常高亮显示。列表框的最典型用法就是文件打开对话框。 - *示意图*: - *Control window class*: `NCSCTRL_LISTBOX` - *Control English name*: `ListBox` - *Brief introduction*: Display a series of options provided by the users in the child window that can scroll. Users can select certain item or multiple items through keyboard and mouse operation, and the selected list item is usually high light displayed. The most typical usage of list box is file opening dialog box. - *Schematic diagram*:  ### `mListBox` 风格 ### Style of `mListBox` 继承自 mItemView 风格 It is inherited from the` style of `mItemView` | * 风格名 * | *miniStudio属性名* | *说明* | | `NCSS_LSTBOX_SINGLE` | Multi->FALSE | 单选列表项支持 | | `NCSS_LSTBOX_MULTIPLE` | Multi->TRUE | 多选列表项支持 | | `NCSS_LSTBOX_SORT` | `AutoSort` | 列表项排序支持 | | `NCSS_LSTBOX_MOUSEFOLLOW` | `MouseFollow` | 列表项支持鼠标跟随 | | `NCSS_LSTBOX_STRING` | - | 带有字符串的列表项 | | `NCSS_LSTBOX_USEBITMAP` | `UseBitmap` | 列表项带有位图 | | `NCSS_LSTBOX_CHECKBOX` | Checkable | 列表项包含 checkbox | | `NCSS_LSTBOX_AUTOCHECK` | `AutoCheck` | 列表项中的 checkbox 支持自动选择 | | `NCSS_LSTBOX_AUTOCHECKBOX` | - | 同时包含 `NCSS_LSTBOX_CHECKBOX` 和 `NCSS_LSTBOX_AUTOCHECK` 2种风格 | | *Style name* | *mstudio property name* | *Explanation* | | `NCSS_LSTBOX_SINGLE` | Multi->FALSE | Single selection list item supported | | `NCSS_LSTBOX_MULTIPLE` | Multi->TRUE | Multi selection list item supported | | `NCSS_LSTBOX_SORT` | `AutoSort` | List item sorting supported | | `NCSS_LSTBOX_MOUSEFOLLOW` | `MouseFollow` | The list item supports mouse following | | `NCSS_LSTBOX_STRING` | - | List item with character string | | `NCSS_LSTBOX_USEBITMAP` | `UseBitmap` | The list item has bit map | | `NCSS_LSTBOX_CHECKBOX` | Checkable | The list item contains checkbox | | `NCSS_LSTBOX_AUTOCHECK` | `AutoCheck` | checkbox in the list item supports automatic selection | | `NCSS_LSTBOX_AUTOCHECKBOX` | - | Simultaneously contain `NCSS_LSTBOX_CHECKBOX` and `NCSS_LSTBOX_AUTOCHECK` styles | ### `mListBox` 属性 ### Property of `mListBox` 继承自 mItemView 属性 It is inherited from the` property of `mItemView | * 属性ID *| *miniStudio 名*| *类型* | *权限* |* 说明 *| | `NCSP_LSTBOX_ITEMWIDTH` | - | int | `RO` | 列表项最大宽度 | | `NCSP_LSTBOX_ITEMCOUNT` | - | int | `RO` | 列表项总数目 | | `NCSP_LSTBOX_ITEMHEIGHT` | - | int | `RW` | 列表项高度 | | `NCSP_LSTBOX_TOPITEM` | - | int | `RW` | 第一个可见列表项索引 | | `NCSP_LSTBOX_HILIGHTEDITEM` | - | int | `RW` | 高亮列表项索引 | | *Property ID | *mstudio name* | *Type* | *Authority* | *Explanation* | | `NCSP_LSTBOX_ITEMWIDTH` | - | int | `RO` | Maximum width of the list item | | `NCSP_LSTBOX_ITEMCOUNT` | - | int | `RO` | Total number of the list item | | `NCSP_LSTBOX_ITEMHEIGHT` | - | int | `RW` | Height of the list item | | `NCSP_LSTBOX_TOPITEM` | - | int | `RW` | The first visible list item index | | `NCSP_LSTBOX_HILIGHTEDITEM` | - | int | `RW` | High light list item index | ### `mListBox` 事件 ### Event of `mListBox` 继承自 mItemView 事件 It is inherited from event` of `mItemView | * 事件通知码 *|* 说明 *|* 参数 *| | `NCSN_LSTBOX_CLICKED` | 鼠标点击事件 | | | `NCSN_LSTBOX_SELCHANGED` | 选择条目已改变 | 新的选择条目句柄 | | `NCSN_LSTBOX_ENTER` | Enter 键被按下 | - | | `NCSN_LSTBOX_SETFOCUS` | 获取焦点 | - | | `NCSN_LSTBOX_KILLFOCUS` | 失去焦点 | - | | `NCSN_LSTBOX_ERRSPACE` | 空间不足 | - | | `NCSN_LSTBOX_DBCLK` | 双击列表项 | - | | `NCSN_LSTBOX_SELCANCEL` | 取消选择条目 | - | | `NCSN_LSTBOX_CLKCHKMARK` | check mark 被点击 | - | | * Event notification code *|* Explanation *|* Parameter *| | `NCSN_LSTBOX_CLICKED` | Mouse clicking event | | | `NCSN_LSTBOX_SELCHANGED` | The selected item has changed | New selected item sentence handle | | `NCSN_LSTBOX_ENTER` | Enter key is pressed down | - | | `NCSN_LSTBOX_SETFOCUS` | Get focus | - | | `NCSN_LSTBOX_KILLFOCUS` | Lose focus | - | | `NCSN_LSTBOX_ERRSPACE` | Space is insufficient | - | | `NCSN_LSTBOX_DBCLK` | Double click list item | - | | `NCSN_LSTBOX_SELCANCEL` | Deselect the item | - | | `NCSN_LSTBOX_CLKCHKMARK` | check mark is clicked | - | ### `mListBox` 方法 ### Method of `mListBox` 继承自 mItemView 方法 It is inherited from the` method of `mItemView #### 将字符串加入列表框 #### Add the character string to the list box 建立 listbox 控件之后，下一步是将字符串放入其中，这可以通过调用 `addString` 方法来完成，添加成功后该方法将返回列表项所在的索引值。字符串通常通过以0开始计数的索引数来引用，其中0对应于最顶上的条目。 After establishing listbox control, the next step is placing the character string in it, which can be completed through calling `addString` method. After adding is successful, the method will return the index value of the list item. The character string is usually quoted through the index number counting from 0, and 0 corresponds to the top item. ```cpp int addString(mListBox *self, const char* string, DWORD addData); ``` 也可以使用 `insertString` 指定一个索引值，将字符串插入到列表框中的指定位置，但在 `NCSS_LISTBOX_SORT` 风格下，会根据排序结果插入到相应位置，将忽略索引值设置： `insertString` can be used to appoint an index value, and insert the character string to the specified position in the list box. But under `NCSS_LISTBOX_SORT` style, it will insert to the corresponding position according to the sorting result, and index value setting will be ignored. ```cpp int insertString(mListBox *self, const char* string, DWORD addData, int index); ``` 如： For Example: ```cpp %INCLUDE{"%ATTACHURL%/listbox" pattern="^.*?// START_OF_ADDITEMS(.*?)// END_OF_ADDITEMS.*"}% ``` 如果添加的列表项除了包含字符串以外，还包含位图等信息，可通过 `addItems` 方法来完成。 If the added list item contains bit map etc. besides character string, it can be completed through `addItems` method. ```cpp typedef struct _NCS_LSTBOX_ITEMINFO { char* string; DWORD flag; DWORD image; DWORD addData; }NCS_LSTBOX_ITEMINFO; void addItems(mListBox *self, NCS_LSTBOX_ITEMINFO *info, int count); ``` 如： For Example: ```cpp int count = 3; mListItemInfo lbii[count]; lbii[0].string = "test list"; lbii[0].flag = 0; lbii[0].image = 0; ... ... _c(listFile)->addItems(listFile, lbii, count); ``` #### 删除列表框条目 #### Remove List Box Item 列表框控件通过 `delString` 或 `removeItemByIdx` 方法可以删除指定索引值的列表项或通过 `removeItem` 方法删除指定列表项；同时也可以通过 `resetContent` 清空列表框中的所有内容。函数原型如下： List box control can remove the list item of specified index value through `delString` or `removeItemByIdx` method or the specified list item is removed through `removeItem` method; at the same time, all the content in the list box can be emptied through `resetContent`. Prototype of the function is as below: ```cpp BOOL delString(mListBox *self, int index); int removeItemByIdx(mListBox *self, int index); ``` 如： For Example: ```cpp %INCLUDE{"%ATTACHURL%/listbox" pattern="^.*?// START_OF_DELITEMS(.*?)// END_OF_DELITEMS.*"}% ``` #### 选择和获取条目 #### Select and Get Item 对于单项选择列表框和多项选择列表框在检索列表框条目的选中状态时需要使用不同的方法，下面先看单项选择列表框。选择条目除了通过鼠标和键盘操作外，还可以通过方法 `setCurSel` 来控制： For single selection list box and multi selection list box, in the selected status of index list item, different methods need to be used, below let’s firstly look at the single selection list box. The selected item can control through `setCurSel` besides through mouse and keyboard operation. ```cpp _c(listFile)->setCurSel(listFile, 1); ``` 反之，可通过 `getCurSel` 来获取当前选定的索引项，如果没有选定项， 将返回 -1。 On the contrary, currently selected index item can be obtained through `getCurSel`, if there is no selected item, -1 will be returned. ```cpp _c(listFile)->getCurSel(listFile); ``` 另外也可以通过 _selectByIdx_ 或 _deselectByIdx_ 设置或取消选中状态。 In addition, selected status can be set or canceled through `selectByIdx` or `deselectByIdx`. ```cpp int selectByIdx(mListBox *self, int index); int deselectByIdx(mListBox *self, int index); ``` 对于多项选择列表框来说，通过 `setCurSel` 和 `getCurSel` 方法只能用来设置和获取当前高亮项，无法获得所有具有选中状态的条目。但我们可以使用 `setSel` 来设定某特定条目的选择状态，而不影响其他项，其中 flag的取值有三种含义： - -1：时对指定列表项进行相反操作，即原状态未选中则选中它，否则取消选中状态。 - 0：取消对列表项的选中。 - 其它：选中列表项。 For multi selection list box, `setCurSel` and `getCurSel` method can only be used to set and get current high light item, and all the items with selected status cannot be obtained. However, we can use `setSel` to set selection status of specific item without influencing other items, and value of flag has three meanings: - -1: carry out reversed operation to the specified list item, that is, if the original status is not selected, select it, otherwise cancel the selected status. - 0: cancel selection to the list item. - Others: select the list item. 方法原型： Prototype of the method: ```cpp int setSel(mListBox *self, int newSel, int flag); ``` 使用示例如： Example is as following: ```cpp _c(listFile)->setSel(listFile, 0, 1); ``` 反之，我们可以用 `isSelected` 方法确定某特定条目的选择状态： On the contrary, we can use `isSelected` method to determine selection status of specific item: ```cpp _c(listFile)->isSelected(listFile, 0); ``` 另外对于多选列表框，可以通过 `getSelectionCount` 方法获取当前选中的条目个数，并通过 `getSelection` 获得所有被选中条目的索引值： In addition, for multi selection list box, we can get the currently selected item number through `getSelectionCount` method, and get index values of all the selected items through `getSelection` method. ```cpp HITEM* selItems; int selCount = _c(listFile)->getSelectionCount(listFile); if (selCount == 0) return; selItem = alloca (sizeof(HITEM)*selCount); _c(listFile)->getSelection(listFile, selItem, selCount); ``` #### 查找含有字符串的条目 #### Find Items Containing Character String 列表框通过 `findString` 方法提供了在指定范围内精确或模糊查找包含某一指定字符串的列表项的方法： The list box provides the method to accurately or vaguely find list item containing certain specified character string within the specified range through `findString` method: ```cpp int findString(mListBox *self, int start, char* string, BOOL bExact); ``` 下面的操作将从第3个列表项开始精确查找字符串为 test 的列表项。成功会返回查找到的列表项索引，否则返回 -1： The following operation will start to accurately find the list item with character string as test from the third list item. If it is successful, the list item index found will be returned, otherwise -1 will be returned: ```cpp _c(listFile)->findString(listFile, 2, "test", TRUE); ``` #### 设置和获取某条目的检查框的当前状态 #### Set and get current status of the check box of certain item ```cpp _c(listFile)->getCheckMark(listFile, index); ``` 返回由 index 指定索引处条目的检查框的状态。如果没有找到相应条目，将返回 -1。NCSF_LSTITEM_CMCHECKED 表示该条目的检查框处于选择状态。NCSF_LSTITEM_CMPARTCHECKED 表示该条目的检查框处于部分选择状态。NCSF_LSTITEM_CMBLANK 表示该条目的检查框处于未选择状态。 Return the status of the check box of the item at the specified index. If corresponding item is not found, -1 will be returned. `NCSF_LSTITEM_CMCHECKED` represents that the check box of the item is in selected status. `NCSF_LSTITEM_CMPARTCHECKED` represents that the check box of the item is in partial selected status. `NCSF_LSTITEM_CMBLANK` represents that the check box of the item is in unselected status. ```cpp _c(listFile)->setCheckMark(listFile, index, (DWORD)status); ``` 设置由 index 指定索引处条目的检查框的状态为 status 中指定的值。当没有找到 index 指定的条目时，返回 `FALSE，成功返回` `TRUE`。 Set the status of the check box of the item at the index specified by index as the value specified in status. When the item specified by index is not found, `FALSE` will be returned, if it is successful, `TRUE` will be returned. #### 设置某列表框条目加粗显示状态 #### Set Certain List Box Item as Bold Display Status ```cpp _c(listFile)->bold(listFile, index, TRUE); ``` 该操作将指定索引项的内容进行加粗设置。 The operation will carry out bold setting to the content of the specified index item. #### 设置或获取某列表框条目选择状态 #### Set or Get Selection Status of Certain List Box Item 列表框通过 _isEnabled_ 方法确定某特定条目是否处于禁止选中状态： The list box determines if a specific item is in forbid selected status through `isEnabled` method. %CODE{"cpp"}% _c(listFile)->isEnabled(listFile, 0); ``` 通过 _enableByIdx_ 或 _enable_ 方法可以支持条目选中或禁止条目选中。 Item selected or forbid item selected can be supported through enableByIdx or enable method. %CODE{"cpp"}% _c(listFile)->enableByIdx(listFile, 0, TRUE); or _c(listFile)->enableByIdx(listFile, 0, FALSE); ``` #### 设置字符串比较函数 #### Set Character String Comparison Function 列表框控件通过 _setStrCmpFunc_ 方法来使用用户设置的排序方法排列列表项。 The list box control uses the sorting method set by the user to arrange the list items through `setStrCmpFunc` method. ```cpp static int my_strcmp (const char* s1, const char* s2, size_t n) { int i1 = atoi (s1); int i2 = atoi (s2); return (i1 – i2); } _c(listFile)->setStrCmpFunc(listFile, my_strcmp); ``` ### `mListBox` 实例 ### Instance of `mListBox` 图 p2c6-1 listbox 程序的输出 Figure p2c6-1 Output of listbox Program
清单 p2c14-3 listbox.c
##### List 3 listbox.c ##### List 3 listbox.cList p2c14-3 listbox.c
```cpp %INCLUDE{"%ATTACHURL%/listbox"}% ``` ## `mIconView` - *控件窗口类*: `NCSCTRL_ICONVIEW` - *控件英文名*: `IconView` - *简介*: 将用户提供的一系列可选项以图标加标签文字的方式供其浏览，用户可通过键盘及鼠标操作来选中某一项或者多个项，选中的列表项通常高亮显示。标型控件的典型用法是作为桌面图标的容器和目录下文件的显示。 - *示意图*: - *Control window class*: `NCSCTRL_ICONVIEW` - *Control English name*: `IconView` - *Brief introduction*: a series of options provided by the users is offered in the mode of icon plus label literal for browsing. Users can select certain item or multiple items through keyboard and mouse operation, and the selected item is usually high light displayed. The typical usage of icon control is as the display of the container of desktop icon and documents under the directory. - *Schematic diagram*:  ### `mIconView` 风格 ### Style of `mIconView` 继承自 mItemView 风格 It is inherited from the` style of `mItemView | * 风格名 * | *miniStudio属性名* | *说明* | | `NCSS_ICONV_LOOP` | Loop | 条目可循环浏览 | | `NCSS_ICONV_SORT` | `AutoSort` | 条目自动排序 | | *Style name* | *mstudio property name* | *Explanation* | | `NCSS_ICONV_LOOP` | Loop | Item circulative browsing | | `NCSS_ICONV_SORT` | `AutoSort` | Item automatic sorting | ### `mIconView` 属性 ### Property of `mIconView` 继承自 mItemView 属性 | * 属性ID *| *miniStudio 名*| *类型* | *权限* |* 说明 *| | `NCSP_ICONV_DEFICONHEIGHT` | - | int | `RW` | 列表项高度 | | `NCSP_ICONV_DEFICONWIDTH` | - | int | `RW` | 列表项宽度 | It is inherited from the` property of `mItemView | *Property ID | *mstudio name* | *Type* | *Authority* | *Explanation* | | `NCSP_ICONV_DEFICONHEIGHT` | - | int | `RW` | Height of the list item | | `NCSP_ICONV_DEFICONWIDTH` | - | int | `RW` | Width of the list item | ### `mIconView` 方法 ### Method of `mIconView` 继承自 mItemView 方法 It is inherited from the method of ,mItemView iconview 控件通过 `setIconSize` 方法来初始化列表项的大小，并通过 `addItem` 方法根据列表项信息添加列表项。 Iconview control initializes the size of the list item through `setIconSize` method, and adds list item according to list item information through `addItem` method. ```cpp typedef struct _NCS_ICONV_ITEMINFO { int index; PBITMAP bmp; const char *label; DWORD addData; }NCS_ICONV_ITEMINFO; void setIconSize(mIconView *self, int width, int height); HITEM addItem(mIconView *self, NCS_ICONV_ITEMINFO *info, int *pos); ``` 添加列表项的示例代码如： Example codes of adding list item are: ```cpp %INCLUDE{"%ATTACHURL%/iconview" pattern="^.*?// START_OF_ADDITEMS(.*?)// END_OF_ADDITEMS.*"}% ``` ### `mIconView` 实例 ### Instance of `mIconView` 图 p2c6-1 iconview 程序的输出 Figure p2c6-1 Output of iconview Program
清单 p2c14-3 iconview.c
##### List 3 iconview.c ##### List 3 iconview.cList p2c14-3 iconview.c
```cpp %INCLUDE{"%ATTACHURL%/iconview"}% ``` ## `mListView` - *控件窗口类*: `NCSCTRL_LISTVIEW` - *控件英文名*: `ListView` - *简介*: 以列表的方式显示一系列的数据项（列表项），不同列表项的相同类型子项以列的方式组织，列表型控件的表头（header）内容通常反映了列表项不同子项的意义。列表型控件经常用来作为文件浏览框，它可以在一个区域内显示包括文件名、文件类型、大小和修改日期在内的诸多文件属性。 - *示意图*: - *Control window class*: `NCSCTRL_LISTVIEW` - *Control English name*: `ListView` - *Brief introduction*:Display a series of data items (list items) in the list mode. Same type of child items of different list items are organized in the column mode, and content of the header of the list control usually reflect the meanings of different child items of the list item. List control is usually used as file browsing box, which can show many file properties including file name, file type, size and modification date in a region. - *Schematic diagram*:  ### `mListView` 风格 ### Style of `mListView` 继承自 mItemView 风格 | * 风格名 * | *miniStudio属性名* | *说明* | | `NCSS_LISTV_NOTIFY` | Notify | 通知事件支持 | | `NCSS_LISTV_LOOP` | Loop | 循环浏览支持 | | `NCSS_LISTV_MULTIPLE` | Multi->TRUE | 多选支持 | | `NCSS_LISTV_SINGLE` | | Multi->FALSE | 单选支持 | | `NCSS_LISTV_CHECKBOX` | `CheckBox` | 列表项包含 checkbox | | `NCSS_LISTV_AUTOCHECK` | `AutoCheck` | 列表项中的 checkbox 支持自动选择 | | `NCSS_LISTV_AUTOCHECKBOX` | - | 同时包含 `NCSS_LSTBOX_CHECKBOX` 和 `NCSS_LSTBOX_AUTOCHECK` 2种风格 | | `NCSS_LISTV_TREE` | Tree | 支持树状列表 | | `NCSS_LISTV_WITHICON` | `WithIcon` | | | `NCSS_LISTV_SORT` | Sort | 排序支持 | It is inherited from the` style of `mItemView | *Style name* | *mstudio property name* | *Explanation* | | `NCSS_LISTV_NOTIFY` | Notify | Notification event supported | | `NCSS_LISTV_LOOP` | Loop | Circulative browsing supported | | `NCSS_LISTV_MULTIPLE` | Multi->TRUE | Multiple selection supported | | `NCSS_LISTV_SINGLE` | | Multi->FALSE | Single selection supported | | `NCSS_LISTV_CHECKBOX` | `CheckBox` | The list item contains checkbox| | `NCSS_LISTV_AUTOCHECK` | `AutoCheck` | checkbox in the list item supports automatic selection | | `NCSS_LISTV_AUTOCHECKBOX` | - | Contain `NCSS_LSTBOX_CHECKBOX` and `NCSS_LSTBOX_AUTOCHECK` styles simultaneously. | | `NCSS_LISTV_TREE` | Tree | Support tree list | | `NCSS_LISTV_WITHICON` | `WithIcon` | | | `NCSS_LISTV_SORT` | Sort | Sorting supported | ### `mListView` 属性 ### Property of `mListView` 继承自[mItemView的属性](MStudioMGNCSV1dot0PGP2C3#mItemView) | * 属性ID *| *miniStudio 名*| *类型* | *权限* |* 说明 *| | `NCSP_LISTV_DEFITEMHEIGHT` | - | int | `RW` | 列表项默认高度 | | `NCSP_LISTV_ROWCOUNT` | - | `RO` | int | 列表项行数 | | `NCSP_LISTV_HDRHEIGHT` | `HeadHeight` | int | `RW` | 列表头高度 | | `NCSP_LISTV_HDRWIDTH` | `HeadWidth` | int | `RW` | 列表头总宽度 | | `NCSP_LISTV_HDRVISIBLE` | - | `BOOL` | `RW` | 列表头是否可见 | | `NCSP_LISTV_SORTCOLUMN` | - | int | `RW` | 排序列索引 | | `NCSP_LISTV_GRIDLINEWIDTH` | `GridLineWidth` | int | `RW` | 网格宽度 | | `NCSP_LISTV_GRIDLINECOLOR` | `GridLineColor` | int | `RW` | 网格颜色 | | `NCSP_LISTV_COLCOUNT` | - | int | `RO` | 列表项列数 | It is inherited from [the property of `mItemView](MStudioMGNCSV1dot0PGP2C3#mItemView`) | *Property ID | *mstudio name* | *Type* | *Authority* | *Explanation* | | `NCSP_LISTV_DEFITEMHEIGHT` | - | int | `RW` | Default height of the list item | | `NCSP_LISTV_ROWCOUNT` | - | `RO` | int | Row number of the list item | | `NCSP_LISTV_HDRHEIGHT` | `HeadHeight` | int | `RW` | height of the list header | | `NCSP_LISTV_HDRWIDTH` | `HeadWidth` | int | `RW` | Total width of the list header | | `NCSP_LISTV_HDRVISIBLE` | - | `BOOL` | `RW` | If the list header is visible | | `NCSP_LISTV_SORTCOLUMN` | - | int | `RW` | Index of the sorted columns | | `NCSP_LISTV_GRIDLINEWIDTH` | `GridLineWidth` | int | `RW` | Grid width | | `NCSP_LISTV_GRIDLINECOLOR` | `GridLineColor` | int | `RW` | Grid color | | `NCSP_LISTV_COLCOUNT` | - | int | `RO` | Column number of the list item | ### `mListView` 事件 ### Event of `mListView` /** Double click in item. */ `NCSN_LISTV_ITEMDBCLK`, /** Fold item. */ , /** Unfold item. */ `NCSN_LISTV_UNFOLDITEM`, 继承自 mItemView 事件 | * 事件通知码 *|* 说明 *|* 参数 *| | `NCSN_LISTV_CLICKED` | 鼠标点击事件 | | | `NCSN_LISTV_SELCHANGED` | 选择条目已改变 | 新的选择项句柄 | | `NCSN_LISTV_ITEMRDOWN` | 鼠标右键在列表项上按下 | 被点击的行索引 | | `NCSN_LISTV_ITEMRUP` | 鼠标右键在列表项上弹起 | 被点击的行索引 | | `NCSN_LISTV_HDRRDOWN` | 鼠标右键在表头上按下 | 被点击的列索引 | | `NCSN_LISTV_HDRRUP` | 鼠标右键在列表项上弹起 | 被点击的列索引 | | `NCSN_LISTV_ITEMDBCLK` | 双击列表项 | - | | `NCSN_LISTV_FOLDITEM` | 树列表项折叠子节点 | 被点击的列表项句柄 | | `NCSN_LISTV_UNFOLDITEM` | 树列表项打开子节点 | 被点击的列表项句柄 | It is inherited from the` event of `mItemView | * Event notification code *|* Explanation *|* Parameter *| | `NCSN_LISTV_CLICKED` | Mouse clicking event | | | `NCSN_LISTV_SELCHANGED` | The selected item has changed | New selection item sentence handle | | `NCSN_LISTV_ITEMRDOWN` | The mouse right key presses down on the list item | Indexed by the clicked row | | `NCSN_LISTV_ITEMRUP` | The mouse right key pops up on the list item | Indexed by the clicked row | | `NCSN_LISTV_HDRRDOWN` | The mouse right key presses down on the header | Indexed by the clicked column | | `NCSN_LISTV_HDRRUP` | The mouse right key pops up on the list item | Indexed by the clicked column | | `NCSN_LISTV_ITEMDBCLK` | Double click the list item | - | | `NCSN_LISTV_FOLDITEM` | The tree list item folds the child node | Clicked list item sentence handle | | `NCSN_LISTV_UNFOLDITEM` | The tree list item opens the child node | Clicked list item sentence handle | ### `mListView` 方法 ### Method of `mListView` 继承自 mItemView 风格 It is inherited from the` style of `mItemView #### 列操作 #### Column Operation 在向该控件中添加列表项前，首先需要通过 `addColumn` 方法添加列： before adding list item to the control, it is necessary to firstly add column through `addColumn` method: ```cpp %INCLUDE{"%ATTACHURL%/listview" pattern="^.*?// START_OF_ADDCLMS(.*?)// END_OF_ADDCLMS.*"}% ``` 其中 `lstv_clminfo` 是一个 `NCS_LISTV_CLMINFO` 结构，它包含了列表型控件的列信息。在添加列后，若需要设置或获取列的相关信息时，可通过如下方法来完成： `lstv_clminfo` is a `NCS_LISTV_CLMINFO` structure, which contains the column information of the list control. After adding column, if it is necessary to set or get information related to column, it can be completed through the following method: ```cpp void setColumnWidth(mListView *self, int index, int width); BOOL setHeadText(mListView *self, int col, const char* text); mListColumn* getColumn(mListView *self, int index); int getColumnIndex(mListView *self, mListColumn *column); int getColumnWidth(mListView *self, int index); int getColumnCount(mListView *self); void showColumn(mListView *self, mListColumn *column); ``` 此外，删除指定列可通过 `delColumn` 方法实现： In addition, deleting specified column can be realized through `delColumn`: ```cpp BOOL delColumn(mListView *self, int index); ``` #### 列表项操作 #### List Item Operation 列表型控件由许多纵向排列的列表项组成，每个列表项由列分为多个子项，列表项可以包含特定的应用程序定义的附加数据。应用程序可以通过相应的方法来添加、修改和设置、删除列表项或获取列表项的属性信息。 List control is composed of many vertically arranged list items, and each list item is divided into many child items by the column. List item can contain additional data defined by specific applications. Applications can add, modify, set and remove list item or get property information of the list item through corresponding method. 控件创建并添加列后，还没有列表项，此时需要通过 _addItem_ 向其添加列表项： After the control creates and adds column, there is no list item, and now it is necessary to add list item to it through `addItem`: ```cpp %INCLUDE{"%ATTACHURL%/listview" pattern="^.*?// START_OF_ADDITEMS(.*?)// END_OF_ADDITEMS.*"}% ``` 每个列表项包括一个或多个子项，子项的数目和列表型控件的列数相同。一个子项中包括字符串和图像，可以使用下列方法来获取和设置子项的信息： Each list item includes one or multiple child item, and number of the child items is the same as the column number of the list control. A child item includes character string and image, and the following method can be used to get and set the information of child item: ```cpp void setBackground(mListView *self,int row,int col,int *color); void setForeground(mListView *self,int row,int col,int *color); int getBackground(mListView *self,int row,int col,int *color); int getForeground(mListView *self,int row,int col,int *color); BOOL setItemInfo(mListView *self, NCS_LISTV_ITEMDATA *info); BOOL getItemInfo(mListView *self, NCS_LISTV_ITEMDATA *info); const char* getItemText(mListView *self, int row, int col); int getItemTextLen(mListView *self, int row, int col); BOOL setItemText(mListView *self, int row, int col, const char* str); ``` #### 查找列表项 #### Find List Item `findItem` 用于在列表型控件中查找一个特定的列表项。如果查找成功的话，返回列表项句柄。 `findItem` is used to find a specific list item in the list control. If the finding is successful, list item sentence handle is returned. ```cpp HITEM findItem(mListView *self, NCS_LISTV_FINDINFO *info); ``` #### 比较和排序 #### Comparison and Sorting 除了继承自基类的排序功能支持外，该控件还可以指定某一列作为其排序的依照列，同时还可以设定排序类型是升序还是降序，或无序（不排列）。 Besides the sorting function inherited from the basic class is supported, the control can appoint certain column as the accordance column of the sorting, and at the same time, it can set the sorting type as ascending, descending, or unsorted (not arranged). ```cpp void sort(mListView *self, NCS_CB_LISTV_CMPCLM func, int col, ncsLstClmSortType sort); void setSortDirection(mListView *self, ncsLstClmSortType direction); ncsLstClmSortType getSortDirection(mListView *self); mListColumn* getSortColumn(mListView *self); void setSortColumn(mListView *self, mListColumn* column); ``` #### 回调方法 #### Callback Method 对列表头的绘制包括了背景色和内容绘制2部分，控件对此提供了回调方法供上层应用处理表头的绘制。方法： Drawing of the list header includes drawing of background color and content, and control provides callback method for the upper layer application to process drawing of header. Method: ```cpp void setCustomDrawHeader(mListView *self, NCS_CB_LISTV_CSTMHDROPS *func); ``` #### 树型节点的操作 #### 树型节点的操作 树型节点的操作包括获取相关节点和折叠一个节点。 相关方法有： Operation of tree node includes getting related nodes and folding a node, and the related method is: ```cpp HITEM getRelatedItem(mListView *self,HITEM hItem,ncsListVIRType type); HITEM getChildItem(mListView *self, HITEM parent, int index); int getChildCount(mListView *self, HITEM hItem); int foldItem(mListView *self, HITEM hItem, BOOL fold); ``` - `getRelatedItem` 用于获取一个节点的相关树型节点，如父节点，兄弟节点或第一个子节点。ncsListVIRType 指定相关节点和目标节点的关系，包括： - `NCSID_LISTV_IR_PARENT：父节点` - `NCSID_LISTV_IR_FIRSTCHILD：第一个子节点` - `NCSID_LISTV_IR_LASTCHILD：最后一个节点` - `NCSID_LISTV_IR_NEXTSIBLING：下一个兄弟节点` - `NCSID_LISTV_IR_PREVSIBLING：上一个兄弟节点` - `foldItem` 用来折叠或者展开一个包含子节点的节点项。 - `getChildItem：用于获取指定父节点下的子节点`。 - `getChildCount：用于获取指定节点的子节点数目`。 - `getRelatedItem` is used to get the related tree nodes of a node, such as parent node, brother node or the first child node. `ncsListVIRType` appoints the relations between the related nodes and the objective nodes, including: - `NCSID_LISTV_IR_PARENT：parent` node - `NCSID_LISTV_IR_FIRSTCHILD：first` child node - `NCSID_LISTV_IR_LASTCHILD：last` node - `NCSID_LISTV_IR_NEXTSIBLING：next` brother node - `NCSID_LISTV_IR_PREVSIBLING：previous` brother node - `foldItem` is used to fold or unfold a node item containing child node. - `getChildItem`: used to get the child nodes under the specified parent node. - `getChildCount`: used to get the number of the child nodes of the specified node. ### `mListView` 实例 ### Instance of `mListView` 图 p2c6-1 listview 程序的输出 Figure p2c6-1 Output of listview Program
清单 p2c14-4 listview.c
##### List 4 listview.c ##### List 4 listview.cList p2c14-4 listview.c
```cpp %INCLUDE{"%ATTACHURL%/listview"}% ``` [Next](MStudioMGNCSV1dot0PGP2C13][Previous]] < [[MStudioMGNCSV1dot0PG][Index]] > [[MStudioMGNCSV1dot0PGP2C15) -- Main.XiaodongLi - 22 Feb 2010 ---- [<< ](MiniGUIProgGuidePart.md) | [Table of Contents](README.md) | [ >>](MiniGUIProgGuidePart.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 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 [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/