VincentWei/minigui-docs
1
0
Fork 0
mirror of https://github.com/VincentWei/minigui-docs.git synced 2025-10-20 22:10:27 +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

78
programming-guide/MiniGUIProgGuidePart6Chapter19.md
View File

@@ -1,6 +1,6 @@
# `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
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
@@ -8,27 +8,27 @@ 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
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
attribute, such as experiment data or account table.
You can call `CreateWindow` function and use the control name `CTRL_GRID` to
create a `GridView`. Applications usually add, delete or operate the table
items by sending messages to the `GridView`. Like other controls, `GridView`
create a Gridview. Applications usually add, delete or operate the table
items by sending messages to the Gridview. Like other controls, Gridview
will not generate messages until it responds user clicking or other operations.
## Styles of Gridview
By default, `GridView` window only displays header and cell, and there is no
border in the display region. When creating `GridView` with `CreateWindow`
By default, Gridview window only displays header and cell, and there is no
border in the display region. When creating Gridview with `CreateWindow`
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
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
meanings of every member are:
@@ -48,7 +48,7 @@ typedef struct _GRIDVIEWDATA
### 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
control.
@@ -59,7 +59,7 @@ GRIDCELLDATAHEADER cellheader;
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
of every member are:
@@ -108,7 +108,7 @@ typedef struct _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
every member are:
@@ -130,15 +130,15 @@ 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.
`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.
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:
`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.
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）,
`GRIDCELLDATASELECTION（combo` boxes cell）, `GRIDCELLDATACHECKBOX(selection`
cell). The definition and the meaning of every member are:
@@ -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
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.
`GRIDM_DELCOLUMN` message is used to delete a column in `GridView`.
`GRIDM_DELCOLUMN` message is used to delete a column in Gridview.
```cpp
int index;
@@ -227,7 +227,7 @@ SendMessage (hwndGrid, GRIDM_DELCOLUMN, 0, index) ;
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
int count;
@@ -264,7 +264,7 @@ 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
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
int index;
@@ -272,11 +272,11 @@ GRIDCELLDATA* 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
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
int index;
@@ -285,7 +285,7 @@ SendMessage (hwndGrid, GRIDM_DELROW, 0, index) ;
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
int count;
@@ -335,12 +335,12 @@ SendMessage (hwndGrid, GRIDM_GETCELLPROPERTY, &cells, celldata) ;
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
`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`.
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
cell (GRIDCELLDATANUMBER).
cell (`GRIDCELLDATANUMBER`).
```cpp
GRIDCELLS* cells;
@@ -419,7 +419,7 @@ If success, the message will return the index of the association; otherwise it
will return `GRID_ERR`.
The message `GRIDM_DELDEPENDENCE` is used to delete a cell association in the
`GridView`.
Gridview.
```cpp
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
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
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
- `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
- `GRIDN_KEYDOWN`: key is pressed down
- `GRIDN_CELLDBCLK`: user double click one cell
@@ -455,12 +455,11 @@ notification handle function should be registered using
## 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
source code.
List 1 Use of `GridView` Control
__List 1__ Use of Gridview Control
```cpp
int ww = 800;
@@ -699,24 +698,17 @@ ControlTestWinProc (HWND hWnd, int message, WPARAM wParam, LPARAM lParam)
}
return DefaultMainWinProc (hWnd, message, wParam, lParam);
}
```
![alt](figures/37.1.jpeg)
Figure 1 Use of a `GridView` control
-- Main.XiaodongLi - 26 Oct 2009
__Figure 1__ Use of a Gridview control
----
[<< ](MiniGUIProgGuidePart.md) |
[<< Animation Control](MiniGUIProgGuidePart6Chapter18.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 4.0]: /supplementary-docs/Release-Notes-for-MiniGUI-4.0.md