GridView (gb.qt4)
Implements a control that displays data in a grid.
You can fill the grid explicitly, or implement the
Data event to display the grid contents on demand.
You should use the last method if you have a lot of rows to display. The control can handle millions of lines gracefully.
Constants
Both
|
Indicate that both horizontal and vertical headers must be displayed.
|
Horizontal
|
Indicate that the horizontal header must be displayed.
|
None
|
Indicate that no header is displayed.
|
Vertical
|
Indicate that the vertical header must be displayed.
|
Properties
AutoResize
|
Return or set if the last column will automatically be resized so that the gridview view area is entirely covered.
|
Background
|
Returns or sets the background color used by the control.
|
Border
|
Return or set if the control displays a border.
|
ClientH
|
A synonymous for the ClientHeight property.
|
ClientHeight
|
Return the height of the internal area containing the cells.
|
ClientW
|
A synonymous for the ClientWidth property.
|
ClientWidth
|
Return the width of the internal area containing the cells.
|
ClientX
|
Return the left position of the internal area containing the cells.
|
ClientY
|
Return the top position of the internal area containing the cells.
|
Column
|
Return or set the index of the current column.
|
Columns
|
Return a virtual array of each gridview column.
|
Current
|
Return the current cell.
|
Data
|
Use this property to store the contents of a cell during the Data event handler.
|
Grid
|
Return or set if the grid is displayed.
|
Header
|
Return or set which headers should be displayed:
|
Mode
|
Return or set the selection mode:
|
Padding
|
Return or set the default cell padding in pixels.
|
Resizable
|
Return or set if the column headers are resizable.
|
Row
|
Return or set the index of the current row.
|
Rows
|
Return a virtual array of each gridview row.
|
ScrollBar
|
Return or set which scrollbars are displayed.
|
ScrollH
|
A synonymous for ScrollHeight.
|
ScrollHeight
|
Returns the contents height.
|
ScrollW
|
A synonymous for ScrollWidth.
|
ScrollWidth
|
Returns the contents width.
|
ScrollX
|
Returns or sets the horizontal scrolling position.
|
ScrollY
|
Returns or sets the vertical scrolling position.
|
ShowCursor
|
Return or set if a light cursor is drawn around the current cell.
|
Sorted
|
Return or set if clicking on a column header toggles the sort indicator.
|
Inherited properties
Action
|
Returns or sets the action string associated with the control.
|
Children
|
Returns a collection of each control included in the container.
|
Cursor
|
Use this property for assigning a custom cursor to a control.
|
Design
|
Indicates that the control is in design mode.
|
Direction
|
Return or set the control text direction.
|
Drop
|
Returns or sets if a control accepts drops.
|
Enabled
|
Indicates that the control is enabled.
|
Expand
|
Returns or sets if a control will expand if included in a container
that arranges its contents.
|
Font
|
Returns or sets the font used to draw text in the control.
|
Foreground
|
Returns or sets the foreground color used by the control.
|
H
|
A synonymous for the Height property.
|
Handle
|
Returns the internal X11 window handle of the control.
|
HasFocus
|
Returns whether the control has the focus.
|
Height
|
Returns or sets the height of the control.
|
Hovered
|
Returns whether the mouse cursor is inside the control.
|
Id
|
A synonymous for the Handle property.
|
Ignore
|
Returns or sets if a control must be ignored when its parent arranges its children.
|
Left
|
Returns or sets the position of the left border of the control relative to its parent.
|
Mouse
|
Returns or sets the appearence of the cursor when it points inside the control.
|
Name
|
Returns or sets the name of the control.
|
Next
|
Returns the next control having the same parent.
|
NoTabFocus
|
Return or set if a control cannot be focused with the TAB key.
|
Parent
|
Returns the control container.
|
PopupMenu
|
Return or set the name of the menu that will be popped-up when the user presses the right mouse button or the keyboard MENU key.
|
Previous
|
Returns the previous control having the same parent.
|
Proxy
|
Return or set the "proxy" of a control.
|
ProxyFor
|
Return which control that control is a proxy for.
|
RightToLeft
|
Return if the control is right to left oriented.
|
ScreenX
|
Returns the position of the left border of the control in screen coordinates.
|
ScreenY
|
Returns the position of the top border of the control in screen coordinates.
|
Tag
|
Returns or sets the control tag.
|
Tooltip
|
Returns or sets the tooltip shown when the mouse stays on the control for a short time.
|
Top
|
Returns or sets the position of the top border of the control relative to its parent.
|
Tracking
|
Returns or sets if the control will receive MouseMove events.
|
Visible
|
Indicates if the control is visible or not.
|
W
|
A synonymous for the Width property.
|
Width
|
Returns or sets the width of the control.
|
Window
|
Returns the top-level window that contains the control.
|
X
|
Returns or sets the position of the left border of the control relative to its parent.
|
Y
|
Returns or sets the position of the top border of the control relative to its parent.
|
Methods
AddColumn
|
Add a new column to the GridView.
|
Clear
|
Clear the grid static contents.
|
ColumnAt
|
Return the index of the column pointed by the specified horizontal position.
|
MoveTo
|
Set the current cell row and column.
|
RowAt
|
Return the index of the row pointed by the specified vertical position.
|
Scroll
|
Scroll the contents to the given position.
|
Select
|
Selects several rows.
|
SelectAll
|
Select all rows.
|
UnSelectAll
|
Unselect all rows.
|
Inherited methods
Delete
|
Destroys the control.
|
Drag
|
Starts a drag & drop process.
|
FindChild
|
Finds the first child control pointed by the X and Y coordinates.
|
Grab
|
Grab the keyboard and the mouse so that all keyboard and mouse events are received by the control.
|
Hide
|
Hides the control.
|
Lower
|
Sends the control to the background of its parent.
|
Move
|
Moves and/or resizes the control.
|
MoveScaled
|
Moves and/or resizes the control.
|
Raise
|
Sends the control to the foreground of its parent.
|
Refresh
|
Trigger a redraw of the control.
|
Reparent
|
Changes the container of a control.
|
Resize
|
Resizes the control.
|
ResizeScaled
|
Resizes the control.
|
SetFocus
|
Gives the focus to the control.
|
Show
|
Shows the control.
|
Events
Activate
|
Raised when the user double-clicks on a cell.
|
Change
|
Raised when the current cell has moved.
|
Click
|
Raised when the user clicks on a cell.
|
ColumnClick
|
Raised when the user clicks on a column header.
|
ColumnResize
|
Raised when a column is resized.
|
ColumnSize
|
Raised when a specific column has been resized by the user with a double-click on the border separating it from the next column.
|
Data
|
This event is raised when the data stored in the specified cell is needed (usually to draw it).
|
Draw
|
Raised when a cell must be drawn.
|
Font
|
This event is raised when the control font changes.
|
RowClick
|
Raised when the user clicks on a row header.
|
RowResize
|
Raised when a row is resized.
|
RowSize
|
Raised when a specific row has been resized.
|
Scroll
|
Raised when the control contents have been scrolled.
|
Select
|
Raised when the selection changes.
|
Sort
|
Raised when the GridView contents must be sorted.
|
Inherited events
Arrange
|
This event is raised when a container has just finished arranging its contents.
|
BeforeArrange
|
This event is raised just before a container arranges its contents.
|
DblClick
|
Raised when the user quickly clicks twice on the control.
|
Drag
|
This event is raised when the mouse enters the control during a drag & drop process.
|
DragLeave
|
This event is raised when the mouse leaves the control during a drag & drop operation.
|
DragMove
|
This event is raised while the mouse moves inside the control
during a drag & drop process.
|
Drop
|
This event is raised when a drag is dropped in the control.
|
Enter
|
Raised when the mouse enters the control.
|
GotFocus
|
Raised when the control has got the focus.
|
KeyPress
|
Raised when a key is pressed while the control has the focus.
|
KeyRelease
|
Raised when a key is released while the control has the focus.
|
Leave
|
Raised when the mouse leaves the control.
|
LostFocus
|
Raised when the control has lost the focus.
|
Menu
|
Raised when the user clicks on the control with the right mouse button,
or if it hits the MENU key.
|
MouseDown
|
Raised when a mouse button is pressed while the cursor is inside the control.
|
MouseDrag
|
This event is raised when a drag operation should be started.
|
MouseMove
|
Raised when the mouse moves inside the control while a mouse button is pressed.
|
MouseUp
|
Raised when a mouse button is depressed while the cursor is inside the control.
|
MouseWheel
|
This event is raised when the user moves or presses the mouse wheel
while the mouse is inside the control.
|
NewChild
|
This event is raised when a new child Control has just been inserted into the container.
|
Example
'Fill grid explicitly
GridView1.Columns.Count = 4
GridView1.Rows.Count = 3
GridView1.Columns.Width = 52
GridView1.Rows[1].Height = 52
GridView1[0,0].Text = "0,0"
GridView1[0,0].Alignment = Align.Right
GridView1[1,1].Text = "1,1"
GridView1[0,1].Text = "0,1"
GridView1[1,0].Picture = Picture["image.png"]