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

AutoResizeColumn | Overloaded. Set width of the specified column so that it shows whole items. This applies only do Details view.
AutoResizeColumns | Overloaded. Set width of all columns so that it shows whole items. This applies only do Details view.
BeginEdit | Overloaded. Edit the currently focused item.
Clear | Overloaded. Remove all elements from the list.
Contains | Overloaded. Check whether this control contains the specified element.
EndEdit | Overloaded. Terminate label editing operation.
EnsureVisible | Overloaded. Scroll control to make the item with the specified index visible.
FindItemsWithText | Overloaded. Search for items within the control.
FindItemWithText | Overloaded. 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.
GetColumnHeaderAt | Overloaded. 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.
GetGroupAt | Overloaded. 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.
GetItemAt | Overloaded. Get item at the specified location in client coordinates.
GetItemAtNearest | Overloaded. 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.
GetItemRect | Overloaded. Get item bounding rectangle.
GetSubItemAt | Overloaded. Get sub-item at the specified location in client coordinates.
GetSubItemBounds | Get boundaries of the specified sub-item.
GetSubItemRect | Get sub-item bounding rectangle.
HitTest | Overloaded. Get information about mouse location with respect to control state.
LoadContentBinary | Overloaded. Load content to the control from the specified binary file.
LoadContentXml | Overloaded. Load content to the control from the specified XML file.
RedrawItems | Redraw all items.
ReorderColumns | Overloaded. 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.
ResumeSort | Overloaded. Resume sorting items while control content changes.
SaveContentBinary | Overloaded. Save content of the control to the specified binary file.
SaveContentXml | Overloaded. Load content of the control to the specified XML file.
SetImageListItems | Set images to be displayed on items and sub-items.
Sort | Overloaded. 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.
Dispose | Overloaded. Releases the unmanaged resources used by the Control and its child controls and optionally releases the managed resources.
DoDefaultAction | Overloaded. 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