VincentWei/minigui-docs
1
0
Fork 0
mirror of https://github.com/VincentWei/minigui-docs.git synced 2025-10-20 13:24:04 +08:00
Code Issues Packages Projects Releases Wiki Activity

tune

Browse Source
This commit is contained in:
Vincent Wei
2019-10-30 16:26:34 +08:00
parent b1628793ec
commit ca1da20f70
1 changed files with 63 additions and 71 deletions
Download Patch File Download Diff File Expand all files Collapse all files

134
programming-guide/MiniGUIProgGuidePart6Chapter19.md
View File

@@ -1,35 +1,35 @@
# `GridView` Control # Gridview Control
`GridView` displays a series of data items (cells) in table form, and the Gridview displays a series of data items (cells) in table form, and the
contents of every cell are independent each other. The contents of gridview contents of every cell are independent each other. The contents of gridview
header, including a column of header and a row of header, usually express the header, including a column of header and a row of header, usually express the
meanings of the column and the row. From the appearance, gridview is a meanings of the column and the row. From the appearance, gridview is a
rectangle box including header cells. You can adjust the height of the row and rectangle box including header cells. You can adjust the height of the row and
the width of the column in the gridview by dragging the header, and use the the width of the column in the gridview by dragging the header, and use the
scrollbar to display the content, which was out of the display window. scrollbar to display the content, which was out of the display window.
`GridView` is a convenient and effective tool, which can arrange and display Gridview is a convenient and effective tool, which can arrange and display
the data item. It suits to deal with a great deal of datum with different the data item. It suits to deal with a great deal of datum with different
attribute, such as experiment data or account table. attribute, such as experiment data or account table.
You can call `CreateWindow` function and use the control name `CTRL_GRID` to You can call `CreateWindow` function and use the control name `CTRL_GRID` to
create a `GridView`. Applications usually add, delete or operate the table create a Gridview. Applications usually add, delete or operate the table
items by sending messages to the `GridView`. Like other controls, `GridView` items by sending messages to the Gridview. Like other controls, Gridview
will not generate messages until it responds user clicking or other operations. will not generate messages until it responds user clicking or other operations.
## Styles of Gridview ## Styles of Gridview
By default, `GridView` window only displays header and cell, and there is no By default, Gridview window only displays header and cell, and there is no
border in the display region. When creating `GridView` with `CreateWindow` border in the display region. When creating Gridview with `CreateWindow`
function, you can use window style `WS_BORDER` to add the border in it. function, you can use window style `WS_BORDER` to add the border in it.
Otherwise, use window style `WS_VSCROLL` and `WS_HSCROLL` to add upright and Otherwise, use window style `WS_VSCROLL` and `WS_HSCROLL` to add upright and
horizontal scroll bars. It is convenient for using mouse to display all horizontal scroll bars. It is convenient for using mouse to display all
contents in the `GridView` by scrolling the bar. contents in the Gridview by scrolling the bar.
## Messages of `GridView` ## Messages of Gridview
When creating `GridView`, you can set a structure `GRIDVIEWDATA` and transfer When creating Gridview, you can set a structure `GRIDVIEWDATA` and transfer
this structure as a parameter. The definition of this structure and the this structure as a parameter. The definition of this structure and the
meanings of every member are: meanings of every member are:
```cpp ```cpp
@@ -48,18 +48,18 @@ typedef struct _GRIDVIEWDATA
### Column Operations ### Column Operations
After creating the `GridView`, user demands to add a column to the control, After creating the Gridview, user demands to add a column to the control,
which can be finished by application sending `GRIDM` `ADDCOLUMN` message to the which can be finished by application sending `GRIDM` `ADDCOLUMN` message to the
control. control.
```cpp ```cpp
int index; int index;
GRIDCELLDATA celldata; GRIDCELLDATA celldata;
GRIDCELLDATAHEADER cellheader; GRIDCELLDATAHEADER cellheader;
SendMessage(hWndGrid, GRIDM_ADDCOLUMN, index, &celldata); SendMessage(hWndGrid, GRIDM_ADDCOLUMN, index, &celldata);
``` ```
Here celldata is a `GRIDCELLDATA` structure, including the information about Here `celldata` is a `GRIDCELLDATA` structure, including the information about
the new added column. The `GRIDCELLDATA` structure definition and the meanings the new added column. The `GRIDCELLDATA` structure definition and the meanings
of every member are: of every member are:
@@ -79,13 +79,13 @@ typedef struct _GRIDCELLDATA
/** mask of properties, can be OR'ed with following values: /** mask of properties, can be OR'ed with following values:
* set or get a cell style * set or get a cell style
* - GVITEM_STYLE\n * - GVITEM_STYLE\n
* set or get a cell text color * set or get a cell text color
* - GVITEM_FGCOLOR\n * - GVITEM_FGCOLOR\n
* set or get a cell background color * set or get a cell background color
* - GVITEM_BGCOLOR\n * - GVITEM_BGCOLOR\n
* set or get a cell text font * set or get a cell text font
* - GVITEM_FONT\n * - GVITEM_FONT\n
* set or get a cell's image * set or get a cell's image
* - GVITEM_IMAGE\n * - GVITEM_IMAGE\n
* set or get all of the content of a cell * set or get all of the content of a cell
* - GVITEM_ALLCONTENT\n * - GVITEM_ALLCONTENT\n
@@ -108,8 +108,8 @@ typedef struct _GRIDCELLDATA
}GRIDCELLDATA; }GRIDCELLDATA;
``` ```
content field in the above structure points to the address of another structure The `content` field in the above structure points to the address of another structure
`GRIDCELLDATAHEADER`. The definition of this structure and the meanings of `GRIDCELLDATAHEADER`. The definition of this structure and the meanings of
every member are: every member are:
```cpp ```cpp
@@ -126,19 +126,19 @@ typedef struct _GRIDCELLDATAHEADER
Before adding a new column, you should set the number size of the structure Before adding a new column, you should set the number size of the structure
`GRIDCELLDATAHEADE` and the number buff point to the caption of the column. The `GRIDCELLDATAHEADE` and the number buff point to the caption of the column. The
number `len_buff` is the length of the caption. Adding a row is same as adding number `len_buff` is the length of the caption. Adding a row is same as adding
a column. But the number size is the height of the new row. a column. But the number size is the height of the new row.
`GRIDCELLDATA` structure is to set the attributes of the row, column and cell `GRIDCELLDATA` structure is to set the attributes of the row, column and cell
in `GridView`, which is used by many messages, such as `GRIDM_SETCELLPROPERTY`, in Gridview, which is used by many messages, such as `GRIDM_SETCELLPROPERTY`,
`GRIDM_GETCELLPROPERTY`, `GRIDM_ADDROW` and `GRIDM_ADDCOLUMN` etc. `GRIDM_GETCELLPROPERTY`, `GRIDM_ADDROW` and `GRIDM_ADDCOLUMN` etc.
style field in the `GRIDCELLDATA` structure is the style of cell. Every times, The `style` field in the `GRIDCELLDATA` structure is the style of cell. Every times,
when you set, you should point out which type is among below options: when you set, you should point out which type is among below options:
`GV_TYPE_HEADER`, `GV_TYPE_TEXT`, `GV_TYPE_NUMBER`, `GV_TYPE_SELECTION` and `GV_TYPE_HEADER`, `GV_TYPE_TEXT`, `GV_TYPE_NUMBER`, `GV_TYPE_SELECTION` and
`GV_TYPE_CHECKBOX`. It can be used with cell style, such as `GVS_READONLY` etc. `GV_TYPE_CHECKBOX`. It can be used with cell style, such as `GVS_READONLY` etc.
content field also can point to other structures, which are The `contentThe ` field also can point to other structures, which are
`GRIDCELLDATATEXT（text` cell）, `GRIDCELLDATANUMBER（data` cell）, `GRIDCELLDATATEXT（text` cell）, `GRIDCELLDATANUMBER（data` cell）,
`GRIDCELLDATASELECTION（combo` boxes cell）, `GRIDCELLDATACHECKBOX(selection` `GRIDCELLDATASELECTION（combo` boxes cell）, `GRIDCELLDATACHECKBOX(selection`
cell). The definition and the meaning of every member are: cell). The definition and the meaning of every member are:
@@ -191,7 +191,7 @@ int width;
SendMessage (hwndGrid, GRIDM_SETCOLWIDTH, index, width) ; SendMessage (hwndGrid, GRIDM_SETCOLWIDTH, index, width) ;
``` ```
Here index is the integral index value of the column needed to set, and width Here index is the integral index value of the column needed to set, and width
is the width of the column. is the width of the column.
`GRIDM_GETCOLWIDTH` can get the width of the control column: `GRIDM_GETCOLWIDTH` can get the width of the control column:
@@ -215,10 +215,10 @@ SendMessage (hwndGrid, GRIDM_ADDCOLUMN, index, celldata) ;
``` ```
Here index is the integral index value of the column upon the added column, and Here index is the integral index value of the column upon the added column, and
celldata is a pointer of `GRIDCELLDATA` structure, which is used to set initial `celldata` is a pointer of `GRIDCELLDATA` structure, which is used to set initial
value for new column. value for new column.
`GRIDM_DELCOLUMN` message is used to delete a column in `GridView`. `GRIDM_DELCOLUMN` message is used to delete a column in Gridview.
```cpp ```cpp
int index; int index;
@@ -227,7 +227,7 @@ SendMessage (hwndGrid, GRIDM_DELCOLUMN, 0, index) ;
Here index is the index value of the deleted column. Here index is the index value of the deleted column.
`GRIDM_GETCOLCOUNT` message is used to get the number of columns in `GridView`. `GRIDM_GETCOLCOUNT` message is used to get the number of columns in Gridview.
```cpp ```cpp
int count; int count;
@@ -260,11 +260,11 @@ int index;
height = SendMessage (hwndGrid, GRIDM_GETROWHEIGHT, 0, index); height = SendMessage (hwndGrid, GRIDM_GETROWHEIGHT, 0, index);
``` ```
Here, index is the integral index value of the row needed to get, and the Here, index is the integral index value of the row needed to get, and the
return value of the `SendMessage` function is the height of the row. The return value of the `SendMessage` function is the height of the row. The
message will return –1 on error. message will return –1 on error.
`GRIDM_ADDROW` message is used to add a new row in `GridView`. `GRIDM_ADDROW` message is used to add a new row in Gridview.
```cpp ```cpp
int index; int index;
@@ -272,11 +272,11 @@ GRIDCELLDATA* celldata;
SendMessage (hwndGrid, GRIDM_ADDROW, index, celldata) ; SendMessage (hwndGrid, GRIDM_ADDROW, index, celldata) ;
``` ```
Here, index is the integral index value of row upon the added row; celldata is Here, index is the integral index value of row upon the added row; `celldata` is
a pointer of `GRIDCELLDATA` structure, which is used to set the initial value a pointer of `GRIDCELLDATA` structure, which is used to set the initial value
of the new row. of the new row.
`GRIDM_DELROW` message is used to delete a row in `GridView`. `GRIDM_DELROW` message is used to delete a row in Gridview.
```cpp ```cpp
int index; int index;
@@ -285,7 +285,7 @@ SendMessage (hwndGrid, GRIDM_DELROW, 0, index) ;
Here index is the index value of the deleted row. Here index is the index value of the deleted row.
`GRIDM_GETROWCOUNT` is used to get the number of the rows in `GridView`. `GRIDM_GETROWCOUNT` is used to get the number of the rows in Gridview.
```cpp ```cpp
int count; int count;
@@ -322,8 +322,8 @@ typedef struct _GRIDCELLS
}GRIDCELLS; }GRIDCELLS;
``` ```
If `SendMessage` function is ok, return `GRID_OKAY`; otherwise, return If `SendMessage` function is ok, return `GRID_OKAY`; otherwise, return
`GRID_ERR`. `GRID_ERR`.
`GRIDM_GETCELLPROPERTY` message is used to obtain the attribute of cell. `GRIDM_GETCELLPROPERTY` message is used to obtain the attribute of cell.
@@ -335,12 +335,12 @@ SendMessage (hwndGrid, GRIDM_GETCELLPROPERTY, &cells, celldata) ;
Here, cells is an idiographic cell, which is not multi-cell. After the content Here, cells is an idiographic cell, which is not multi-cell. After the content
of certain cell is set successfully, the function `SendMessage` will return of certain cell is set successfully, the function `SendMessage` will return
`GRID_OKAY`. The structure celldata contains the information of the certain `GRID_OKAY`. The structure `celldata` contains the information of the certain
cell. If error occurred, the message will return `GRID_ERR`. cell. If error occurred, the message will return `GRID_ERR`.
Otherwise, there are some other messages for cells with different format, such Otherwise, there are some other messages for cells with different format, such
as `GRIDM_SETNUMFORMAT` message, which is used to set the data format of data as `GRIDM_SETNUMFORMAT` message, which is used to set the data format of data
cell (GRIDCELLDATANUMBER). cell (`GRIDCELLDATANUMBER`).
```cpp ```cpp
GRIDCELLS* cells; GRIDCELLS* cells;
@@ -369,7 +369,7 @@ SendMessage (hwndGrid, GRIDM_GETSELECTED, 0, cells);
``` ```
With this option, the function `SendMessage` will return all the highlighted With this option, the function `SendMessage` will return all the highlighted
cells. cells.
## Other Messages ## Other Messages
@@ -385,7 +385,7 @@ highlighted area will be carried out. When cell is double clicked or selected,
it will edit the content of the cell to input character. it will edit the content of the cell to input character.
The grid control is also able to associate some cells (source cells) with other The grid control is also able to associate some cells (source cells) with other
cells (target cells). Then the target cells will refresh themselves according cells (target cells). Then the target cells will refresh themselves according
to the given operation function when the source cells’ data is changed. The to the given operation function when the source cells’ data is changed. The
structure to carry out this operation is listed below: structure to carry out this operation is listed below:
@@ -419,7 +419,7 @@ If success, the message will return the index of the association; otherwise it
will return `GRID_ERR`. will return `GRID_ERR`.
The message `GRIDM_DELDEPENDENCE` is used to delete a cell association in the The message `GRIDM_DELDEPENDENCE` is used to delete a cell association in the
`GridView`. Gridview.
```cpp ```cpp
int dependence_id; int dependence_id;
@@ -430,14 +430,14 @@ Here the `dependence_id` is the index of the associated cell to be deleted. The
message function will return `GRID_OKAY` when deletion is successful, otherwise message function will return `GRID_OKAY` when deletion is successful, otherwise
it will return `GRID_ERR`. it will return `GRID_ERR`.
## Notification Codes of `GridView` ## Notification Codes of Gridview
The `GridView` will generate notification code when it responds to user's The Gridview will generate notification code when it responds to user's
operation such as clicking or some status is changed. The notification codes operation such as clicking or some status is changed. The notification codes
include: include:
- `GRIDN_HEADLDOWN`: the left buttuon of the user's mouse is pressed on the - `GRIDN_HEADLDOWN`: the left button of the user's mouse is pressed on the
table head table head
- `GRIDN_HEADLUP`: the left buttuon of the user’s mouse is released on the - `GRIDN_HEADLUP`: the left button of the user’s mouse is released on the
table head table head
- `GRIDN_KEYDOWN`: key is pressed down - `GRIDN_KEYDOWN`: key is pressed down
- `GRIDN_CELLDBCLK`: user double click one cell - `GRIDN_CELLDBCLK`: user double click one cell
@@ -446,21 +446,20 @@ table head
- `GRIDN_CELLTEXTCHANGED`: the content of the cell is changed - `GRIDN_CELLTEXTCHANGED`: the content of the cell is changed
When the left button of the user’s mouse is pressed on some cell, the cell will When the left button of the user’s mouse is pressed on some cell, the cell will
be selected, and two notification codes `GRIDN_FOCUSCHANGED` and be selected, and two notification codes `GRIDN_FOCUSCHANGED` and
`GRIDN_CELLCLK` will be generated. `GRIDN_CELLCLK` will be generated.
If an application needs to know the notification code of the grid control, a If an application needs to know the notification code of the grid control, a
notification handle function should be registered using notification handle function should be registered using
`SetNotificationCallback` to handle all the received notification code. `SetNotificationCallback` to handle all the received notification code.
## Sample Program ## Sample Program
Code in List 1 illustrates the use of a `GridView` control. Please refer to Code in List 1 illustrates the use of a Gridview control. Please refer to
grid.c file of the demo program package `mg-samples` of this guide for complete grid.c file of the demo program package `mg-samples` of this guide for complete
source code. source code.
__List 1__ Use of Gridview Control
List 1 Use of `GridView` Control
```cpp ```cpp
int ww = 800; int ww = 800;
@@ -504,7 +503,7 @@ int total(GRIDCELLS* target, GRIDCELLS* source, DWORD dwAddData)
cells.row = target->row; cells.row = target->row;
cells.column = target->column; cells.column = target->column;
SendMessage(hGVWnd, GRIDM_SETCELLPROPERTY, (WPARAM)&cells, (LPARAM)&data); SendMessage(hGVWnd, GRIDM_SETCELLPROPERTY, (WPARAM)&cells, (LPARAM)&data);
return 0; return 0;
} }
@@ -540,7 +539,7 @@ int averge(GRIDCELLS* target, GRIDCELLS* source, DWORD dwAddData)
cells.row = target->row; cells.row = target->row;
cells.column = target->column; cells.column = target->column;
SendMessage(hGVWnd, GRIDM_SETCELLPROPERTY, (WPARAM)&cells, (LPARAM)&data); SendMessage(hGVWnd, GRIDM_SETCELLPROPERTY, (WPARAM)&cells, (LPARAM)&data);
return 0; return 0;
return 0; return 0;
} }
@@ -615,7 +614,7 @@ ControlTestWinProc (HWND hWnd, int message, WPARAM wParam, LPARAM lParam)
cellsel.width = 3; cellsel.width = 3;
cellsel.height = 4; cellsel.height = 4;
SendMessage(hGVWnd, GRIDM_SETCELLPROPERTY, (WPARAM)&cellsel, (LPARAM)&celldata); SendMessage(hGVWnd, GRIDM_SETCELLPROPERTY, (WPARAM)&cellsel, (LPARAM)&celldata);
/* operation to add one column */ /* operation to add one column */
memset(&header, 0, sizeof(header)); memset(&header, 0, sizeof(header));
memset(&celldata, 0, sizeof(celldata)); memset(&celldata, 0, sizeof(celldata));
@@ -695,28 +694,21 @@ ControlTestWinProc (HWND hWnd, int message, WPARAM wParam, LPARAM lParam)
DestroyMainWindow (hWnd); DestroyMainWindow (hWnd);
MainWindowCleanup (hWnd); MainWindowCleanup (hWnd);
return 0; return 0;
} }
return DefaultMainWinProc (hWnd, message, wParam, lParam); return DefaultMainWinProc (hWnd, message, wParam, lParam);
} }
``` ```
![alt](figures/37.1.jpeg) ![alt](figures/37.1.jpeg)
Figure 1 Use of a `GridView` control __Figure 1__ Use of a Gridview control
-- Main.XiaodongLi - 26 Oct 2009
---- ----
[<< ](MiniGUIProgGuidePart.md) | [<< Animation Control](MiniGUIProgGuidePart6Chapter18.md) |
[Table of Contents](README.md) | [Table of Contents](README.md) |
[ >>](MiniGUIProgGuidePart.md) [Iconview Control >>](MiniGUIProgGuidePart6Chapter19.md)
[Release Notes for MiniGUI 3.2]: /supplementary-docs/Release-Notes-for-MiniGUI-3.2.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 [Release Notes for MiniGUI 4.0]: /supplementary-docs/Release-Notes-for-MiniGUI-4.0.md