Class

RadListViewElement

object

IInputEditor

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.

bool

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.

bool

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.

bool

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.

bool

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.

bool

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.

bool

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.

bool

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

ListViewAutoSizeColumnsMode

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.

BindingContext

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.

bool

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.

CheckBoxesAlignment

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

CheckBoxesPosition

CheckOnClickMode

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.

ListViewCheckedItemCollection

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.

string

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.

BaseColumnResizingBehavior

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.

ListViewColumnCollection

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.

ListViewDetailColumn

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.

ListViewDataItem

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.

string

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.

object

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.

RadCollectionView<ListViewDataItem>

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.

string

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.

ListViewDragDropService

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

bool

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.

bool

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.

bool

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.

bool

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

bool

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.

bool

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.

bool

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

ListViewFilterDescriptorCollection

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.

bool

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.

GroupDescriptorCollection

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

int

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.

Size

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.

ListViewDataItemGroupCollection

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

float

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.

ScrollState

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

bool

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.

bool

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.

bool

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.

Size

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.

int

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.

ListViewDataItemCollection

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.

bool

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.

int

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.

RadListSource<ListViewDataItem>

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

bool

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.

bool

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.

int

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.

ListViewDataItem

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.

ListViewSelectedItemCollection

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

Color

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

Color

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.

bool

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.

bool

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.

bool

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.

bool

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.

SortDescriptorCollection

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.

bool

string

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.

ScrollState

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

BaseListViewElement

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.

ListViewType

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).

bool

True if the edit operation was successfully started; otherwise, false.

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.

mode

ListViewBestFitColumnMode

The ListViewBestFitColumnMode that determines how columns should be sized.

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.

bool

True if the edit operation was successfully cancelled; otherwise, false.

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.

BindingContext

A new BindingContext instance.

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.

BaseListViewElement

A new BaseListViewElement instance configured for the current 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.

bool

True if the edit operation was successfully completed; otherwise, false.

This method commits any changes made during the edit operation and properly cleans up the editor. If validation fails or other issues occur, the edit operation may not complete successfully.

commitChanges

bool

True to save changes; false to discard them.

bool

True if the operation completed successfully; otherwise, false.

This method handles the complete lifecycle of ending an edit operation, including validation, value saving, editor cleanup, and event notification. It includes protection against re-entrant calls and ensures proper state management.