ListView
 |
TAListView |
Creates a listview control
Properties:
| Align | Design only property, does not generate code, helps with aligning controls while editing. alBottom - control moves to bottom of client area, resizes to width of client area x original height alClient - control occupies the whole of the client area alCustom - not used alLeft - control moves to left edge of client area, resizes to original width x height of client area alNone - no aligning alRight - control moves to right edge of client area, resizes to original width x height of client area alTop - control moves to top of client area, resizes to width of client area x original height |
| Color | Background color of control. Choose from the list, or enter your own. Format is 0xnumber where number is 6 hexadecimal digits: 2 for blue, 2 for green and 2 for red |
| Columns | Columns and their headings (in report mode). Double-click to the right to specify them using Columns editor |
| ContextMenu | Specifies context menu to attach to control. Create the ContextMenu first |
| Cursor | Cursor shape to display when mouse is over this control |
| Enabled | False generates GUICtrlSetState(-1, $GUI_DISABLE) |
| Font | Double-click to the right to open the Font dialog. Click on + to show the Color, Name, Size and Style properties |
| Left,Top | Position of control relative to its parent |
| Width,Height | Size of control in pixels |
| Hint | Text that appears when cursor hovers over control. Generates call to GUICtrlSetTip |
| Images | If list items are to have icons, select an ImageList from drop-down to attach it. The ImageList must already exist. |
| Items | Double-click to the right to specify list contents using ListView editor. |
| Name | Name of control and of the variable that is assigned its control ID in generated code. If not specified, no variable is generated |
| OnClick | Generates (in Message Loop mode) a Case or (in OnEvent mode) a call to GUISetOnEvent and a skeleton event function. Double-click to right to open Events Editor |
| Resizing | Click on + to expand resize modes: DocAuto - resize and reposition according to new window size DocRight - Do not move right side DocLeft - Do not move left side DocTop - Do not move top DocBottom - Do not move bottom DocHCenter - Horizontal center remains fixed DocVCenter - Vertical center remains fixed DocWidth - Width does not change DocHeight - Height does not change |
| TabOrder | Sequence in which controls are selected with the Tab and Shift+Tab keys. For a Form and for each Group, TabOrder starts with 0. You may prefer to use the TabOrder Visual Editor: press Ctrl+T to open it. |
| Visible | If False, generates GUICtrlSetState(-1, $GUI_HIDE) |
Columns:
Each column has its own properties:
| Alignment | Alignment of header text: taCenter,taLeftJustify, taRightJustify |
| Caption | Text of column header |
| Width | Width of column. Special values: -1 - width is set to maximum width of items in the column -2 - width is width of text in column header |
Styles:
| LVS_REPORT | Report view: has columns with or without headings |
| LVS_LIST | List view: a list, optionally with 32×32 icons |
| LVS_EDITLABELS | Item text can be edited in place |
| LVS_NOCOLUMNHEADER | Column headers are not displayed in report view |
| LVS_SINGLESEL | Restricts selection to one row, rather than being able to select multiple rows. Requires LVS_REPORT |
| LVS_SHOWSELALWAYS | Retains selection of row when control loses focus |
| LVS_SORTASCENDING | Sorts rows in ascending alphabetic order of first column |
| LVS_SORTDESCENDING | Sorts rows in ascending alphabetic order of first column |
| LVS_NOLABELWRAP | Items are restricted to a single line, rather than wrapping to a second line |
| LVS_NOSCROLL | Prevent scroll bars showing when data exceeds bounds of control |
| WS_TABSTOP | Control can be selected with Tab and Shift+Tab |
| WS_HSCROLL | Control has horizontal scroll bar |
| WS_VSCROLL | Control has vertical scroll bar |
| WS_VISIBLE | Control is visible |
| WS_BORDER | Control has a thin-line border |
| WS_CLIPSIBLINGS | If this control overlaps with another, this control shows partially |
Extra Styles:
| WS_EX_CLIENTEDGE | Control has border with sunken edge |
| WS_EX_STATICEDGE | Control has a three-dimensional border |
Remarks:
Column 0 can only be left-justified when created. To right- or center-justify this column, use the procedure in Columns editor.
Related:
None
