RadListViewElement

Returns null when no editing is taking place. The active editor provides access to the current edit value and allows for programmatic control over the editing process.

When enabled, each item can be sized independently based on its content. When disabled, all items share the same height for consistent layout and improved performance.

When enabled, each item can be sized independently based on its content width. When disabled, all items share the same width for consistent layout and improved performance.

When enabled, users can click and drag column headers to reposition them within the column layout. This provides a flexible way to customize the data presentation without requiring code changes.

When enabled, users can position the mouse cursor over column borders and drag to adjust column widths. This provides interactive control over the data presentation layout.

Item drag-and-drop is automatically disabled when using data sources, grouping, filtering, sorting, kinetic scrolling, or lasso selection, as these features conflict with manual item reordering.

When enabled, users can edit items by pressing F2, clicking on selected items, or programmatically calling edit methods. Editing behavior depends on the view type and current column in Details View.

When enabled, pressing the Delete key will remove the selected items from the collection. The removal can be cancelled by handling the ItemRemoving event.

Different modes provide various automatic sizing behaviors such as fitting all columns within the available width, sizing based on content, or maintaining fixed widths. The sizing behavior is handled by the appropriate ColumnResizingBehavior implementation.

The binding context provides currency management and change tracking for data binding operations. When set, it triggers the BindingContextChanged event to notify of the change.

When set to true, columns with names like "Name" and "name" will be treated as different columns. This affects data binding operations, sorting, filtering, and grouping behavior.

This property determines how checkboxes are aligned vertically within the bounds of each item, such as center, top, or bottom alignment.

Checked items are independent of selected items and allow for bulk operations on multiple items. The collection is read-only and automatically maintained as check states change.

When data binding is used and ShowCheckBoxes is enabled, this property specifies which field or property from the data source should be used to determine whether each item's checkbox is checked. The field should contain boolean values.

This property controls the relationship between item selection and checkbox state changes, allowing for different interaction patterns such as immediate toggling or requiring multiple clicks.

The column resizing behavior determines how columns respond to user resize operations and automatic sizing scenarios. Different behaviors can provide various resizing modes such as proportional resizing or fixed-width constraints.

Each column represents a data field and defines how that field is displayed, including width, header text, and formatting. Columns are only used in Details View; other view types ignore this collection.

The current column determines which column will be edited when edit operations begin. Setting this property automatically ensures the column is visible and updates the column's current state.

The current item is different from the selected item and represents the focused item for keyboard navigation. Setting this property updates the underlying data view's current position and ensures the item is visible.

This property is used when the data source contains multiple tables or lists, such as a DataSet with multiple DataTables. It specifies which specific table or list should be used for data binding.

The data source can be any object that implements IList, IListSource, or IEnumerable. When a data source is assigned, the list view automatically creates items and columns based on the data structure. Setting the data source to null clears the data binding and resets the DisplayMember, ValueMember, and CheckedMember properties.

The data view wraps the underlying data source and provides a layer for data operations without modifying the original data. It supports complex filtering expressions, multi-level sorting, and hierarchical grouping.

When data binding is used, this property specifies which field or property from the data source should be displayed as the text content of each list item. If not specified, the ToString() method of the data objects is used.

The drag drop service provides functionality for dragging items within the list view and dropping them at different positions or to external targets.

When enabled, clicking on column headers will cycle through ascending sort, descending sort, and no sort states. This provides an intuitive way for users to sort data without requiring custom code.

When enabled, grouping operations are handled through custom code rather than automatic grouping descriptors. This allows for complex grouping scenarios that cannot be expressed through simple property-based grouping.

When enabled, items can be filtered programmatically using FilterDescriptors. Filtering allows hiding items that don't match specified criteria without removing them from the data source.

When enabled, items can be grouped programmatically using GroupDescriptors. Grouping organizes items with similar values into collapsible categories for better data organization.

Kinetic scrolling provides a natural scrolling experience with momentum and deceleration effects. This property always returns false when EnableLassoSelection is enabled, as the two features are incompatible.

When enabled, users can click and drag to create a selection rectangle that selects all items within its bounds. Lasso selection automatically disables kinetic scrolling and is not compatible with certain other features.

When enabled, items can be sorted programmatically using SortDescriptors. In design mode, this property maintains the design-time setting until runtime initialization.

Filter descriptors allow creating complex filtering expressions that determine which items are visible in the list view. Filtering is only available when EnableFiltering is true.

When enabled, selection highlighting extends across the full width of the item area. When disabled, only the item content area is highlighted, which can provide a more compact appearance.

Group descriptors specify the properties used for grouping items with similar values together. Multiple group descriptors create hierarchical grouping with nested group levels.

When grouping is enabled, regular items are indented by this amount relative to group headers to provide visual hierarchy and distinction between groups and their contents.

This size applies to the visual elements that represent group headers when ShowGroups is enabled. A size of (0,0) indicates automatic sizing based on group header content.

Groups are created automatically based on GroupDescriptors or can be manually managed when EnableCustomGrouping is enabled. Groups are only visible when ShowGroups is true.

This property controls the vertical space allocated for column headers when ShowColumnHeaders is enabled. The value is automatically scaled based on the current DPI settings for high-DPI scenarios.

Controls when the horizontal scrollbar appears: always visible, always hidden, or automatically shown only when the content width exceeds the available display area.

When enabled, items will change their appearance (typically highlighting) when the mouse pointer moves over them, providing immediate visual feedback to users about which item they can interact with.

Returns true when a data source has been assigned to the DataSource property. Data binding automatically creates items and columns based on the structure of the bound data.

Returns true when an editor is active and the user is currently editing an item's value. This property is read-only and reflects the editing state managed by the ActiveEditor property.

When data binding is used, this collection is automatically populated from the data source. When not data bound, items can be added and removed directly from this collection.

This size is used as a starting point for item layout. Individual items may be sized differently if AllowArbitraryItemHeight or AllowArbitraryItemWidth are enabled. A size of (0,0) indicates automatic sizing based on content.

This property controls the gap between items, providing visual separation and improving readability. The spacing applies to both horizontal and vertical gaps depending on the current view type and layout direction.

When enabled, typing characters will search for and select the first item that starts with those characters. This provides quick keyboard navigation for large lists. The default value is false.

After this interval without typing, the next keystroke will start a new search from the beginning rather than continuing the current search. The default value is 300 milliseconds.

The list source acts as an intermediary between the list view and the data source, handling data binding, change notifications, and data transformation operations.

When enabled, users can select multiple items using Ctrl+Click, Shift+Click, or lasso selection. When disabled, selecting a new item automatically deselects any previously selected items.

Returns -1 when no item is selected. Setting this property to a valid index selects the corresponding item, while setting it to an invalid index (negative or beyond the collection size) clears the selection.

Only one item can be selected at a time unless MultiSelect is enabled. Setting this property triggers selection change events and updates the visual appearance of items.

When MultiSelect is disabled, this collection contains at most one item. The collection is read-only and automatically maintained as selection changes occur.

This color defines the outline of the selection rectangle when EnableLassoSelection is enabled. The border provides clear visual feedback about the selection area boundaries.

This color is used to fill the selection rectangle when EnableLassoSelection is enabled and users drag to select multiple items. The fill is typically semi-transparent to allow underlying content to show through.

When set to true, adding new items to the data source will automatically select the most recently added item. This is useful for scenarios where immediate user attention should be drawn to newly created items.

When enabled, each item displays a checkbox that can be checked independently of item selection. This allows for bulk operations on checked items and multi-state selection scenarios.

Column headers display column names and provide click targets for sorting operations. Hiding headers can save vertical space but removes sorting functionality and column identification.

Grid lines provide visual separation between items and columns in Details View, making it easier to read tabular data. This property only affects Details View; other view types do not display grid lines.

When enabled, items with the same group value are visually grouped together under expandable/collapsible group headers. Grouping works in conjunction with GroupDescriptors to define grouping criteria.

Sort descriptors specify the properties and directions used for sorting items. Multiple sort descriptors create multi-level sorting where items are sorted by the first descriptor, then by the second descriptor within equal groups, and so on.

When data binding is used, this property specifies which field or property from the data source should be used as the value for each list item. This is important for scenarios where the displayed text differs from the underlying value.

Controls when the vertical scrollbar appears: always visible, always hidden, or automatically shown only when the content height exceeds the available display area.

The view element is automatically created based on the view type and manages item layout, scrolling, virtualization, and user interaction for the specific view mode.

Changing the view type recreates the view element and can significantly alter the appearance and behavior of the list view. Available types include ListView (simple list), IconsView (icon grid), and DetailsView (table format).

The edit operation will fail if editing is disabled, an editor is already active, multiple items are selected, no item is selected, or in Details View when no current column is set. The method ensures the item is visible and properly initializes the appropriate editor for the current view type.

This method is useful when adding, removing, or modifying multiple items at once. It prevents individual change notifications from being fired for each operation, which can significantly improve performance during bulk operations.

This method only has an effect in Details View. It analyzes the content of columns and adjusts their widths to optimally display the data according to the specified mode, such as fitting headers, content, or both.

This method is called when the data binding initialization process has finished successfully. It allows subscribers to perform any post-binding operations or UI updates.

This method abandons any changes made during the edit operation and restores the item to its previous state. The editor is properly cleaned up and removed from the visual tree.

This method is only effective when ShowCheckBoxes is enabled. It provides a convenient way to check all items in the list view regardless of their selection state.

This method is only effective when ShowCheckBoxes is enabled. It provides a convenient way to check all selected items in a single operation.

This method sets the Expanded property to false for all groups in the Groups collection. It only has an effect when ShowGroups is enabled and groups are present.

This method creates the binding context, list source, data collections, view element, and other essential components. It also establishes event handlers and creates the initial view element based on the default view type.

This method acts as a factory for creating view-specific elements. It creates different element types for ListView, IconsView, and DetailsView, with ListView as the default fallback option.

This method performs cleanup of managed resources, including unwiring events, disposing cached editors and their elements, clearing the editor cache, and disposing the list source. It ensures proper resource cleanup to prevent memory leaks.