Better ListView Class Reference

BetterListView Members

BetterListView overview

Public Static Fields

DefaultIndent Default indentation of child items.

Public Instance Constructors

BetterListView Constructor Initializes a new instance of the BetterListView class.

Public Instance Properties

AccessibleDefaultActionDescription Gets or sets the default action description of the control for use by accessibility client applications.
AccessibleDescription Gets or sets the description of the control used by accessibility client applications.
AccessibleName Gets or sets the name of the control used by accessibility client applications.
AccessibleRole Gets or sets the accessible role of the control
Activation Gets or sets item activation mode.
AllowAutoScroll Gets or sets a value indicating whether to allow automatic scrolling of content when mouse is outside client area on some actions.
AllowAutoToolTips Gets or sets a value indicating whether to allow automatic ToolTips to be displayed on items.
AllowAutoToolTipsColumns Gets or sets a value indicating whether to allow automatic ToolTips to be displayed on column headers.
AllowAutoToolTipsGroups Gets or sets a value indicating whether to allow automatic ToolTips to be displayed on groups.
AllowAutoToolTipsSubItems Gets or sets a value indicating whether to allow automatic ToolTips to be displayed on sub-items.
AllowDrag Gets or sets a value indicating whether to allow Drag and Drop operation to be initiated.
AllowDrop Gets or sets a value indicating whether to allow dropping data on the control with Drag and Drop mechanism.
AllowedDragEffects Gets or sets allowed effects for Drag and Drop operations.
AllowMultiColumnSorting Gets or sets a value indicating whether to allow for sorting with multiple columns using Shift modifier key.
AutoExpandDelay Gets or sets time period (in milliseconds) before group or item is expanded when dragging data over it.
AutoSizeItemsInDetailsView Gets or sets a value indicating whether to automatically resize items to client width in Details view without columns.
BackgroundImageAlignment Gets or sets background image alignment. Works with BackgroundImageLayout.None.
BackgroundImageLayout Gets or sets the background image layout as defined in the ImageLayout enumeration.
BackgroundImageOpacity Gets or sets background image opacity.
BottomColumn Gets the last visible column header.
BottomColumnIndex Gets the last visible column header index.
BottomGroup Gets the last visible group.
BottomGroupIndex Gets the last visible group index.
BottomItem Gets the last visible item.
BottomItemIndex Gets the last visible item index.
CacheImages cache resized images for faster redrawing of the control
CircularSelection Allow jumping to item on another side of the list by moving selection.
CollapsedItemUnselection Determines how the collapsed items are unselected.
ColorColumnResizeLine Gets or sets color of the column resizing line.
ColorGridLines Gets or sets color of the grid lines.
ColorInsertionMark Gets or sets color of the insertion mark (column headers).
ColorSortedColumn Gets or sets color of the sorted column background.
ColumnReorderMode Gets or sets column reordering mode.
Columns Gets collection of column headers.
ColumnsDisplayMode Gets or sets display mode of the column headers.
ColumnsVisible Gets or sets a value indicating whether column headers are visible.
ContextMenuStrip Gets or sets common ContextMenuStrip.
ContextMenuStripColumns Gets or sets ContextMenuStrip available by clicking on the column header.
ContextMenuStripGroups Gets or sets ContextMenuStrip available by clicking the group area.
ContextMenuStripItems Gets or sets ContextMenuStrip available by clicking the items area.
Cursor Gets or sets the cursor that is displayed when the mouse pointer is over the control.
DataBindColumns Gets or sets a value indicating whether to synchronize columns with the bound data structure.
DataBindPosition Gets or sets a value indicating whether to synchronize selected item with the current position in bound data structure.
DataSource Gets or sets data source for this control.
DisplayMember Gets or sets property to display on list items.
DragSelectionInversion Gets or sets a value indicating whether to allow item selection inversion by holding Control key while drag selecting items.
EmptyText Gets or sets text to be shown when there are no items in BetterListView.
FocusedGroup Gets or sets currently focused group.
FocusedItem Gets or sets currently focused item.
FocusedSubItem Gets or sets currently focused sub-item.
FontColumns Gets or sets font of column headers texts.
FontGroups Gets or sets font of group texts.
FontItems Gets or sets font of item texts.
ForeColorColumns Gets or sets foreground color of column headers texts.
ForeColorGroups Gets or sets foreground color of group texts.
FullRowSelect Gets or sets a value indicating whether to allow selection across all columns (Details view).
GridLines Gets or sets whether to show grid lines (in details view).
GroupHeaderBehavior Extra behavior of group headers when interacting with keyboard and mouse.
GroupItemCheck Gets or sets a value indicating whether to check all selected items when a single selected item is checked.
Groups Gets collection of BetterListView groups.
HideSelection Gets or sets a value indicating whether to hide selection when the control loses focus.
HideSelectionMode Gets or sets the item selection display mode when control loses focus.
HScrollBarDisplayMode Gets or sets display of the horizontal scroll bar.
CheckBoxes Gets or sets display of the check boxes.
CheckBoxesAlign Keep items with hidden check box aligned the same way as items with visible check box.
CheckBoxesVisible Gets a value indicating whether check boxes are visible.
CheckedIndices Gets indices of checked items.
CheckedItems Gets collection of checked items.
ImageList Gets or sets images to be displayed on items (common for all views).
ImageListColumns Gets or sets images to be displayed on column headers.
ImageListCurrent Gets or sets images to be displayed on items and sub-items for the current view.
ImageListGroups Gets or sets images to be displayed on groups.
Indent Gets or sets indentation of child items (in pixels).
InsertionMark Gets or sets the insertion mark.
IsAnythingSelected Gets a value indicating whether there are any items selected.
IsSelectionChangedSuspended Gets a value indicating whether raising of SelectionChanged events is suspended.
IsSortSuspended Gets a value indicating whether the control does not re-sort items while updating.
ItemComparer Gets or sets comparer for item sorting.
ItemDropDisplayExternal Gets or sets item Drag and Drop display mode when dragging data from another control.
ItemDropDisplayInternal Gets or sets item Drag and Drop display mode when dragging data within control.
ItemReorderMode Gets or sets item reordering mode.
ItemReorderOptions Gets or sets item reordering options.
Items Gets collection of BetterListView items.
LabelEdit Gets or sets a value indicating whether to enable in-place item label editing.
LabelEditActivation Gets or sets label editing activation method.
LabelEditDefaultAccept Gets or sets default label editing action when label editing is ended by the control.
LabelEditModeItems Gets or sets label editing mode for items.
LabelEditModeSubItems Gets or sets label editing mode for sub-items.
LayoutColumns Gets column headers layout.
LayoutGroupsCurrent Gets group layout for the current view.
LayoutGroupsHorizontal Gets horizontal group layout.
LayoutGroupsVertical Gets vertical group layout.
LayoutItemsCurrent Gets item layout for the current view.
LayoutItemsDetails Gets item layout (Details view when columns are not visible).
LayoutItemsDetailsColumns Gets item layout (Details view when columns are visible).
LayoutItemsLargeIcon Gets item layout (LargeIcon view).
LayoutItemsList Gets item layout (List view).
LayoutItemsSmallIcon Gets item layout (SmallIcon view).
LayoutItemsThumbnails Gets item layout (Thumbnails view).
LayoutItemsTile Gets item layout (Tile view).
MaximumAutoSizeWidth Gets or sets maximum allowed automatic size of the column.
MaximumToolTipTextLength maximum allowed text length to be shown in automatic tooltip
MouseWheelScrollExtent Gets or sets relative number of items to scroll for a single mouse wheel detent.
MultiSelect Gets or sets a value indicating whether to allow multiple items to be selected.
OptimizedInvalidation Gets or sets a value indicating whether to invalidate only regions of client area where changes were made.
ReadOnly The control does not accept keyboard and mouse input.
SearchSettings Gets or sets keyboard searching options.
SearchTimeoutDelay Gets or sets period between searches after the user stopped typing (in milliseconds).
SelectedIndices Gets the collection of selected item indices.
SelectedItems Gets the collection of selected items.
SelectedValue Gets or sets selected value.
SelectedValues Gets or sets collection of selected values.
ShowDefaultGroupHeader Gets or sets a value indicating whether to show header of a default group.
ShowEmptyGroups Gets or sets a value indicating whether to show all groups (including the groups without items).
ShowGroupExpandButtons Gets or sets a value indicating whether to show expand buttons on groups.
ShowGroups Gets or sets a value indicating whether to show groups containing items.
ShowItemExpandButtons Gets or sets a value indicating whether to show expand buttons on items.
ShowToolTips Gets or sets a value indicating whether to show ToolTips on items.
ShowToolTipsColumns Gets or sets a value indicating whether show ToolTips on column headers.
ShowToolTipsGroups Gets or sets a value indicating whether to show ToolTips on groups.
ShowToolTipsSubItems Gets or sets a value indicating whether to show ToolTips on sub-items.
SortedColumnsRowsHighlight Gets or sets display mode of a sorted column. Highlight color is specified by ColorSortedColumn property.
SortList Gets or sets information about column sorting.
SortOnCollectionChange Gets or sets a value indicating whether to automatically sort items when collection is changed.
SortVirtual Gets or sets a value indicating whether to show sorted state, but do not physically sort items.
SubItemFocusBehavior Gets or sets sub-item focus rectangle behavior.
Text Gets or sets the text associated with this control.
TileSize Gets or sets size of the tiles shown in Tile view.
ToolTipInfo Gets or sets client area ToolTip settings for this control.
ToolTipOptions Gets or sets ToolTip appearance and behavior options.
TopColumn Gets the first visible column header.
TopColumnIndex Gets the first visible column header index.
TopGroup Gets the first visible group.
TopGroupIndex Gets the first visible group index.
TopItem Gets the first visible item.
TopItemIndex Gets the first visible item index.
ValueMember Gets or sets property to use as a list item value.
View Gets or sets the way of displaying BetterListView items.
VisibleColumns Get currently visible columns.
VisibleGroups Get currently visible groups.
VisibleItems Get currently visible items.
VScrollBarDisplayMode Gets or sets display of the vertical scroll bar.

Public Instance Methods

AutoResizeColumnOverloaded. Set width of the specified column so that it shows whole items. This applies only do Details view.
AutoResizeColumnsOverloaded. Set width of all columns so that it shows whole items. This applies only do Details view.
BeginEditOverloaded. Edit the currently focused item.
ClearOverloaded. Remove all elements from the list.
ContainsOverloaded. Check whether this control contains the specified element.
EndEditOverloaded. Terminate label editing operation.
EnsureVisibleOverloaded. Scroll control to make the item with the specified index visible.
FindItemsWithTextOverloaded. Search for items within the control.
FindItemWithTextOverloaded. Search for item within the control.
FindNearestItem Find the next item from the specified item item, searching in the specified direction.
GetAddressFromLocation Get element address from element location.
GetColumnHeaderAtOverloaded. Get column header at the specified location in client coordinates.
GetColumnHeaderBounds Get boundaries of the specified column header.
GetColumnHeaderRect Get column header bounding rectangle.
GetDropInfo Get insertion location for the specified screen coordinates.
GetEnumerator Returns an enumerator that iterates through the collection.
GetGroupAtOverloaded. Get group at the specified location in client coordinates.
GetGroupBounds Get boundaries of the specified group.
GetGroupFromAddress Get BetterListViewGroup instance within this control from group address.
GetGroupRect Get group bounding rectangle.
GetItemAtOverloaded. Get item at the specified location in client coordinates.
GetItemAtNearestOverloaded. Get item nearest to the specified location in client coordinates.
GetItemBounds Get boundaries of the specified item.
GetItemFromAddress Get BetterListViewItem instance within this control from item address.
GetItemRectOverloaded. Get item bounding rectangle.
GetSubItemAtOverloaded. Get sub-item at the specified location in client coordinates.
GetSubItemBounds Get boundaries of the specified sub-item.
GetSubItemRect Get sub-item bounding rectangle.
HitTestOverloaded. Get information about mouse location with respect to control state.
LoadContentBinaryOverloaded. Load content to the control from the specified binary file.
LoadContentXmlOverloaded. Load content to the control from the specified XML file.
RedrawItems Redraw all items.
ReorderColumnsOverloaded. Switch order of the specified columns.
ResetCursor Resets the Cursor property to its default value.
ResetFocusRectangleDisplay Reset state of focus rectangle display to its initial value. Focus rectangle will not be displayed until focused item is changed through keyboard input.
ResumeSelectionChanged Resume raising SelectionChanged events.
ResumeSortOverloaded. Resume sorting items while control content changes.
SaveContentBinaryOverloaded. Save content of the control to the specified binary file.
SaveContentXmlOverloaded. Load content of the control to the specified XML file.
SetImageListItems Set images to be displayed on items and sub-items.
SortOverloaded. Sort items in the list.
SuspendSelectionChanged Suspend raising SelectionChanged events.
SuspendSort Suspend sorting items while control content changes.
Unsort Reset sorting.

Public Instance Events

AfterItemSort Occurs when items has been sorted.
AfterLabelEdit Occurs after item/sub-item label is edited by the user.
AfterLabelEditCancel Occurs after item/sub-item label is edited by the user; label edit still can be cancelled.
AfterLabelEditEmbeddedControl Occurs after item/sub-item label is edited by the user with embedded control.
BeforeDrag Occurs before Drag and Drop operation is initiated.
BeforeItemSort Occurs before items are sorted.
BeforeLabelEdit Occurs when the user starts editing the label of an item.
ColumnClick Occurs before column header is clicked.
ColumnClicked Occurs after a column is clicked.
ColumnReordered Occurs when a column header is being reordered.
ColumnWidthChanged Occurs when column header width has been changed.
ColumnWidthChanging Occurs when column header width is being changed.
DataSourceChanged Occurs when DataSource property changes.
DisplayMemberChanged Occurs when DisplayMember property changed.
DragDropEffectSetting Occurs when Drag and Drop effect is being set.
DragDropException Occurs when an exception is thrown during Drag and Drop operation.
DrawBackground Occurs when background is drawn.
DrawColumnHeader Occurs when column header is drawn.
DrawColumnHeaderBackground Occurs when column header background is drawn.
DrawGroup Occurs when group is drawn.
DrawGroupBackground Occurs when group background is drawn.
DrawInsertionMark Occurs when insertion mark is drawn.
DrawItem Occurs when item is drawn.
DrawItemBackground Occurs when item background is drawn.
DrawToolTip Occurs when owner-drawn ToolTip is being drawn.
FocusedItemChanged Occurs when selection focused element has been changed.
FormatItem Occurs when item text needs to be formatted for display.
GroupCollapse Occurs when a group is collapsed.
GroupExpand Occurs when a group is expanded.
HitTestChanged Occurs when HitTest result has changed.
CheckAutoExpand Occurs on decision whether a group or item should be auto-expanded.
CheckedItemsChanged Occurs when the CheckedItems collection changes.
CheckItemReorder Occurs on decision whether item can be reordered to a specific location.
ItemActivate Occurs when an item has been activated.
ItemCollapse Occurs when an item with children is collapsed.
ItemDrag Occurs when an item is being dragged.
ItemDrop Occurs when an item is dropped on the control.
ItemExpand Occurs when an item with children is expanded.
ItemCheck Occurs before items are checked.
ItemChecked Occurs when an item check state has changed.
ItemMouseHover Occurs when mouse hovers over an item.
ItemReorder Occurs when item(s) have been reordered.
ItemSearch Occurs when item searching has been performed.
ItemSelectionChanged Occurs when selection state of an item changes.
PopupToolTip Occurs when ToolTip pops up.
RequestEmbeddedControl Occurs when a custom editing control is requested.
SelectedIndexChanged Occurs when selected item index has changed.
SelectedItemsChanged Occurs when SelectedItems collection changes.
ViewChanged Occurs when View property value has been changed.

Protected Instance Properties

DefaultSize Gets the default size of the control.
ViewInternal Gets the view corresponding to a specific layout (depending on current settings).

Protected Instance Methods

AccessibilityInitialize Initialize accessibility support.
CreateAccessibilityInstance Creates a new accessibility object for the control.
DisposeOverloaded. Releases the unmanaged resources used by the Control and its child controls and optionally releases the managed resources.
DoDefaultActionOverloaded. Perform default action on the specified item.
DrawingRedrawCore Internal method for redrawing doing the actual drawing.
GetAccessibilityObjectById Retrieves the specified AccessibleObject.
GetContentBounds Get content area boundaries.
IsInputChar Determines if a character is an input character that the control recognizes.
OnAfterItemSort Raises the AfterItemSort event.
OnAfterLabelEdit Raises the AfterLabelEdit event.
OnAfterLabelEditCancel Raises the AfterLabelEditCancel event.
OnAfterLabelEditEmbeddedControl Raises the AfterLabelEditEmbeddedControl event.
OnBackColorChanged Raises the BackColorChanged event.
OnBeforeDrag Raises the BeforeDrag event.
OnBeforeItemSort Raises the BeforeItemSort event.
OnBeforeLabelEdit Raises the BeforeLabelEdit event.
OnBindingContextChanged Raises the BindingContextChanged event.
OnColumnClick Raises the ColumnClick event.
OnColumnClicked Raises the ColumnClicked event.
OnColumnReordered Raises the ColumnReordered event.
OnColumnWidthChanged Raises the ColumnWidthChanged event.
OnColumnWidthChanging Raises the ColumnWidthChanging event.
OnDataSourceChanged Raises the DataSourceChanged event.
OnDisplayMemberChanged Raises the DisplayMemberChanged event.
OnDoubleClick Raises the DoubleClick event.
OnDragDrop Raises the DragDrop event.
OnDragDropEffectSetting Raises the DragDropEffectSetting event.
OnDragDropException Raises the DragDropException event.
OnDragEnter Raises the DragEnter event.
OnDragLeave Raises the DragLeave event.
OnDragOver Raises the DragOver event.
OnDrawBackground Raises the DrawBackground event.
OnDrawColumnHeader Raises the DrawColumnHeader event.
OnDrawColumnHeaderBackground Raises the DrawColumnHeaderBackground event.
OnDrawGroup Raises the DrawGroup event.
OnDrawGroupBackground Raises the DrawGroupBackground event.
OnDrawInsertionMark Raises the DrawInsertionMark event.
OnDrawItem Raises the DrawItem event.
OnDrawItemBackground Raises the DrawItemBackground event.
OnDrawToolTip Raises the DrawToolTip event.
OnEnabledChanged Raises the EnabledChanged event.
OnFocusedItemChanged Raises the FocusedItemChanged event.
OnFontChanged Raises the FontChanged event.
OnForeColorChanged Raises the ForeColorChanged event.
OnFormatItem Raises the FormatItem event.
OnGotFocus Raises the GotFocus event.
OnGroupCollapse Raises the GroupCollapse event.
OnGroupExpand Raises the GroupExpand event.
OnHandleCreated Raises the HandleCreated event.
OnHitTestChanged Raises the HitTestChanged event.
OnCheckAutoExpand Raises the CheckAutoExpand event.
OnCheckedItemsChanged Raises the CheckedItemsChanged event.
OnCheckItemReorder Raises the CheckItemReorder event.
OnItemActivate Raises the ItemActivate event.
OnItemCollapse Raises the ItemCollapse event.
OnItemDrag Raises the ItemDrag event.
OnItemDrop Raises the ItemDrop event.
OnItemExpand Raises the ItemExpand event.
OnItemCheck Raises the ItemCheck event.
OnItemChecked Raises the ItemChecked event.
OnItemMouseHover Raises the ItemMouseHover event.
OnItemReorder Raises the ItemReorder event.
OnItemSearch Raises the ItemSearch event.
OnItemSelectionChanged Raises the BeforeLabelEdit event.
OnKeyDown Raises the KeyDown event.
OnKeyPress Raises the KeyPress event.
OnKeyUp Raises the KeyUp event.
OnLostFocus Raises the LostFocus event.
OnMouseCaptureChanged Raises the MouseCaptureChanged event.
OnMouseDown Raises the MouseDown event.
OnMouseEnter Raises the MouseEnter event.
OnMouseHover Raises the MouseHover event.
OnMouseLeave Raises the MouseLeave event.
OnMouseMove Raises the MouseMove event.
OnMouseUp Raises the MouseUp event.
OnMouseWheel Raises the MouseWheel event.
OnPaint Raises the Paint event.
OnPopupToolTip Raises the PopupToolTip event.
OnQueryContinueDrag Raises the QueryContinueDrag event.
OnRequestEmbeddedControl Raises the RequestEmbeddedControl event.
OnResize Raises the Resize event.
OnScrollBarValueChanged Called when [scroll bar value changed].
OnSelectedIndexChanged Raises the SelectedIndexChanged event.
OnSelectedItemsChanged Raises the SelectedItemsChanged event.
OnViewChanged Raises the ViewChanged event.
OnVisibleChanged Raises the VisibleChanged event.
ProcessCmdKey Processes a command key.

See Also

BetterListView Class | ComponentOwl.BetterListView Namespace