Note: A parameterless constructor is required for all derived classes.
When 'AllItems' is specified as the value of the
If this
In the case where the
Note: Specifying a value of 'AllItems' for the
Column headers only appear when the associated
When the end user begins a drag operation on a column header, the
Column headers only appear when the associated
When the end user begins a resize operation on a column header, the
Column headers only appear when the associated
When the end user begins a resize operation on a column header, the
Columns can be sorted programmatically by setting the value of the
The
The Editor and
Editing is not supported for sub-items.
When the Editor and
| DataType | Editor |
|---|---|
| DateTime | |
| Color | |
| Boolean, CheckState | |
| Image | |
| Other | When the |
The
The
Column headers are only displayed when the associated
The NullText property can be used to display a meaningful token when a sub-item's
The Sorting property can be used to rearrange the contents of the
The Sorting property can be used to rearrange the contents of the
When items are displayed in
If your application requires more advanced sorting capability, a custom IComparer implementation can be assigned to the
When the Text property is left at its default value (string.Empty), the value of this
The VisiblePositionInDetailsView property provides a way to change the display position of a column, without changing its ordinal position in the
Note: The AutoSizeMode property is only applicable when the
Note: If the value of the
The AutoSizeMode property affects only the column on which the property is set; to set the auto-sizing mode for all columns displayed by the control, use the
The
The
The
The VisiblePositionInTilesView determines the order in which this
The
Note that not all styles are available on all operating systems. If the version of the OS that your program is running on does not support a particular border style, borders formatted with that style will be drawn using solid lines.
By default, the ToolTipText property will contain the value of of the
This method is provided as a convenience, to simplify the serialization implementation for derived classes. The default implementation does nothing.
The appearance properties which apply to the background are applied to the group's header and the group's item area, with the exception of the image background properties, which is only applied to the item area. The appearance properties which control coloring and formatting for text, as well as the image properties, apply only to the group's header area.
The collection is sorted based on the value of each
The Sort method is overloaded so that the caller can specify a custom IComparer implementation which determines the sort order for the groups.
If your application requires that
This method is provided as a convenience, to simplify the serialization implementation for derived classes. The default implementation does nothing.
The
The
Note: This constructor is for internal infrastructure purposes and should not be used.
An instance of the
When using this constructor, the size of the subItemValues array must match the size of the
This constructor is useful in cases where a large number of items are to be added to the the control's
When using this constructor, the size of the subItems array must match the size of the
This constructor is useful in cases where a large number of items are to be added to the the control's
The contents of the
The value of the source instance's
The value of the source instance's Key property is copied to this instance, so if the returned instance is added to the same
The value of the source instance's
If the 'includeSubItems' parameter is set to true, each member of the source instance's
The value of the source instance's Key property is copied to this instance, so if this instance is added to the same
The value of the source instance's
The members of the source instance's
The value of the source instance's
The value of the source instance's Key property is copied to this instance, so if this instance is added to the same
The value of the source instance's
If the 'includeSubItems' parameter is set to true, each member of the source instance's
The CheckState property is only applicable when the
When the CheckState property is set directly, a property change notification is issued; when an application needs to set the property on a large number of items, this can adversely affect performance. The
Note: Groups are not displayed when the
This method is provided as a convenience, to simplify the serialization implementation for derived classes. The default implementation does nothing.
The
The
This method is provided as a convenience, to simplify the serialization implementation for derived classes. The default implementation does nothing.
The RefreshSort method can be used to sort the
When the publicly exposed
When the publicly exposed
Since the
Since the
When the publicly exposed
This method is provided as a convenience, to simplify the serialization implementation for derived classes. The default implementation does nothing.
The
The UltraListViewItemSettings class also exposes appearance properties that correspond to a specific state of the
The
Note: The Image property of the SelectedAppearance is applied regardless of whether the control has the input focus, i.e., the image displayed does not change when the control acquires or loses the input focus.
The
Lasso selection is disabled for all settings of the
When lasso select mode is enabled, the user can select items by pressing either the
left or right mouse button (depending on the value of the property) while the cursor
is positioned over an area that does not contain a selectable part of an
If the user drags the lasso past the bounds of the control's viewable area, the control is automatically scrolled in that direction, so that the selection operation can continue.
Disabled items cannot be selected, and are not included in a lasso selection if the lasso selection rectangle intersects with them.
When the
The
The references contained by the source instance's
Since the value of the Key property is defined by the
The value of the source instance's
The references contained by the source instance's
Since the value of the Key property is defined by the
The value of the source instance's
This method is provided as a convenience, to simplify the serialization implementation for derived classes. The default implementation does nothing.
The
This method is provided as a convenience, to simplify the serialization implementation for derived classes. The default implementation does nothing.
This method saves the data which can be loaded by the
This method saves the data which can be loaded by the
This method saves the data which can be loaded by the
This method saves the data which can be loaded by the
This method loads the data emitted by the
This method loads the data emitted by the
This method loads the data emitted by the
This method loads the data emitted by the
This method must be called after
Note: Calling this method passing in false should only be done when it is known that the changes made between
the
This method sets the
Note: Assigning a value which is greater than or equal to the number of currently visible columns will result in that value being assigned to the column's VisiblePositionInDetailsView property, but will not change the value of that property for any other columns. Calling this method on a column that is not currently visible in the user interface will produce the same result.
The
The
The ColumnResizing event fires before the width of a column is changed through user interaction, either by dragging the right edge of the header, or, in the case where the
Unlike the
Unlike the selected state, which can apply to more than one item at a time, the active state applies to only one item. The ActiveItem is bounded by a focus rectangle to provide a visual cue to the end user; the
The
When the
Checkboxes are only displayed when the control's
The
The GroupAppearance controls formatting for the
The
The control's
Item sorting is affected by grouping in that when items are sorted, they are compared only to other items in the same group. Note that the end developer has complete control over sorting of both groups and items (see
The following table lists the default key mappings for the
| KeyCode | ActionCode | StateRequired | StateDisallowed | SpecialKeysRequired | SpecialKeysDisallowed |
|---|---|---|---|---|---|
| Home | ActivateFirst | ItemActive | ItemInEditMode | None | All |
| End | ActivateLast | ItemActive | ItemInEditMode | None | All |
| Home | ActivateFirstNoSelect | ItemActive | ItemInEditMode | Ctrl | AltShift |
| End | ActivateLastNoSelect | ItemActive | ItemInEditMode | Ctrl | AltShift |
| Home | ActivateFirstRangeSelect | ItemActive, SupportsExtendedSelection | ItemInEditMode | Shift | AltCtrl |
| End | ActivateLastRangeSelect | ItemActive, SupportsExtendedSelection | ItemInEditMode | Shift | AltCtrl |
| Right | ActivateNext | ItemActive, SupportsHorizontalItemNavigation | ItemInEditMode | None | All |
| Left | ActivatePrevious | ItemActive, SupportsHorizontalItemNavigation | ItemInEditMode | None | All |
| Right | ActivateNextNoSelect | ItemActive, SupportsHorizontalItemNavigation | ItemInEditMode | Ctrl | AltShift |
| Right | ActivateNextRangeSelect | ItemActive, SupportsExtendedSelection, SupportsHorizontalItemNavigation | ItemInEditMode | Shift | AltCtrl |
| Left | ActivatePreviousNoSelect | ItemActive, SupportsHorizontalItemNavigation | ItemInEditMode | Ctrl | AltShift |
| Left | ActivatePreviousRangeSelect | ItemActive, SupportsExtendedSelection, SupportsHorizontalItemNavigation | ItemInEditMode | Shift | AltCtrl |
| Up | ActivateAbove | ItemActive | ItemInEditMode | None | All |
| Down | ActivateBelow | ItemActive | ItemInEditMode | None | All |
| Up | ActivateAboveNoSelect | ItemActive | ItemInEditMode | Ctrl | AltShift |
| Down | ActivateBelowNoSelect | ItemActive | ItemInEditMode | Ctrl | AltShift |
| Up | ActivateAboveRangeSelect | ItemActive, SupportsExtendedSelection | ItemInEditMode | Shift | AltCtrl |
| Down | ActivateBelowRangeSelect | ItemActive, SupportsExtendedSelection | ItemInEditMode | Shift | AltCtrl |
| Prior | PageUp | ItemActive | ItemInEditMode | None | All |
| Next | PageDown | ItemActive | ItemInEditMode | None | All |
| Prior | PageUpNoSelect | ItemActive | ItemInEditMode | Ctrl | AltShift |
| Next | PageDownNoSelect | ItemActive | ItemInEditMode | Ctrl | AltShift |
| Prior | PageUpRangeSelect | ItemActive, SupportsExtendedSelection | ItemInEditMode | Shift | AltCtrl |
| Next | PageDownRangeSelect | ItemActive, SupportsExtendedSelection | ItemInEditMode | Shift | AltCtrl |
| Space | SelectItem | ItemActive, SupportsSelection | ItemInEditMode, HasCheckboxes | None | All |
| A | SelectAllItems | SupportsExtendedSelection | ItemInEditMode | Ctrl | AltShift |
| Space | ToggleItemSelectedState | ItemActive, SupportsSelection | ItemInEditMode, HasCheckboxes | Ctrl | AltShift |
| Space | SetNextCheckStateForSelectedItems | HasCheckboxes | ItemInEditMode | None | All |
| F2 | EnterEditMode | ItemActive | ItemInEditMode | None | All |
| F2 | ExitEditModeSaveChanges | ItemInEditMode | None | None | All |
| Enter | ExitEditModeSaveChanges | ItemInEditMode | None | None | All |
| Escape | ExitEditModeDiscardChanges | ItemInEditMode | None | None | All |
| Left | ScrollHorizontalBySmallDecrement | NeedsHorizontalScrollbar | ItemInEditMode, SupportsHorizontalItemNavigation | None | All |
| Right | ScrollHorizontalBySmallIncrement | NeedsHorizontalScrollbar | ItemInEditMode, SupportsHorizontalItemNavigation | None | All |
The ImageTransparentColor property can be used to designate a particular color as the transparent color; this color is masked out when images are displayed, effectively making that color transparent.
The Items collection contains the items that are displayed by the
The members of the Items collection can be sorted by setting the
The ItemSettings object property exists for organizational purposes, so that properties which apply specifically to the
The MainColumn defines the header under which the item's
By default, selected items are rendered with a background color of SystemColors.Highlight and a foreground color of SystemColors.HighlightText. This provides the end user with a visual cue so that selected items can be easily identified. The
The
The column under which the item's
The SubItemColumns collection contains the
The
Since column headers only appear when the control's
The View property provides a way for the end developer to change the way items are presented to the end user.
The following table lists each setting for the View property, along with a brief description:
| Value | Description |
|---|---|
| Details | Items are displayed in a grid-like fashion; headers are displayed for the |
| List | Items are displayed as an image, along with the item's Note: The |
| Icons | Items are displayed as an image, along with the item's |
| Tiles | Items are displayed as an image, along with the item's |
| Thumbnails | Items are displayed as an image in a large bordered square, along with the item's |
The
The
The
The
The
The
ForeColor and BackColor control properties are not supported by
the UltraListView. Use the
ForeColor and BackColor control properties are not supported by
the UltraGrid. Use the
BackgroundImage property is not supported by the UltraListView.
Use the
This property is only used at design-time.
The
The
The TextAreaAlignment property dictates where the item's text (along with the sub-item text, when the
Note: Setting the ColumnWidth property to -1 will cause the control to automatically calculate the width required to fully display all visible items, and use that value as the actual width for all columns.
By default, items are displayed in multiple columns; the total number of columns is dependent on the total number of items and the height of the control.
The
The SubItemsVisibleByDefault property can be used in the case where there are a large number of columns that are not to be displayed. Typically, the end developer will set the SubItemsVisibleByDefault property to false, and then set the
When the SubItemsVisibleByDefault property is set to false, columns are not displayed unless their
The ColumnsShowSortIndicators is applicable only to columns whose
The SubItemColumnsVisibleByDefault property can be used in the case where there are a large number of columns that are not to be displayed. Typically, the end developer will set the SubItemColumnsVisibleByDefault property to false, and then set the
When the SubItemColumnsVisibleByDefault property is set to false, columns are not displayed unless their
When AutoFitColumns is set to true, no horizontal scrollbar appears, and the column widths
are negotiated so that all columns fit horizontally inside the viewable area of the control.
When a column is resized, either programmatically or by the end user, that column's actual
width is preserved whenever possible in subsequent calculations. For example, if the width of the
In the case where the
Note: The ColumnAutoSizeMode property is only applicable when the
Note: If the value of a column's
The ColumnAutoSizeMode property affects all columns displayed by the control; to set the auto-sizing mode for a particular column, use the