# RibbonListView Class

> The RibbonListView class is a list view control, which displays a collection of items that can be displayed using one of three different views. The RibbonListView class is inherited from the System.Windows.Forms.Control class and implements the System.ComponentModel.INotifyPropertyChanged interface. The following describes only the properties, methods and events defined through the RibbonListView class. For a list of properties, methods and events inherited from the System.Windows.Forms.Control class and the System.ComponentModel.INotifyPropertyChanged interface see the .NET Framework reference.

- **Product:** TX Text Control .NET for Windows Forms
- **Section:** Reference
- **Kind:** Class
- **Introduced:** 24.0
- **Namespace:** `TXTextControl.Windows.Forms.Ribbon`
- **Package:** `TXTextControl.TextControl.WinForms.SDK` (assembly `TXTextControl.Windows.Forms.dll`, from the private NuGet feed or Text Control Offline Packages)
- **.NET Framework:** reference `TXTextControl.Windows.Forms.dll` from the setup
- **Inherits:** `System.Windows.Forms.ScrollableControl`
- **Implements:** `System.ComponentModel.INotifyPropertyChanged`
- **Path:** TX Text Control .NET for Windows Forms > Reference > TXTextControl.Windows.Forms.Ribbon > RibbonListView Class
- **3647 words**
- **Web URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/
- **LLMs URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/llms-full.txt

---

### Description

The RibbonListView class is a list view control, which displays a [collection of items](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/ribbonlistviewitems-property/llms-full.txt) that can be displayed using one of three different [views](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/viewmode-property/llms-full.txt). The RibbonListView class is inherited from the `System.Windows.Forms.Control` class and implements the `System.ComponentModel.INotifyPropertyChanged` interface. The following describes only the properties, methods and events defined through the RibbonListView class. For a list of properties, methods and events inherited from the `System.Windows.Forms.Control` class and the `System.ComponentModel.INotifyPropertyChanged` interface see the .NET Framework reference.

### Syntax

```csharp
public class RibbonListView : ScrollableControl, INotifyPropertyChanged
```

```vbnet
Public Class RibbonListView
    Inherits ScrollableControl
    Implements INotifyPropertyChanged
```

### Examples

The following example creates a Ribbon List View instance and configures its deselectable setting for a document workflow.

```csharp
using TXTextControl.Windows.Forms.Ribbon.RibbonListView ribbonListView = new();
ribbonListView.Deselectable = true;
```

```vbnet
Dim ribbonListView As New TXTextControl.Windows.Forms.Ribbon.RibbonListView()
ribbonListView.Deselectable = True
```

---

## In This Section

- [RibbonListView.ActivateEditItemTextBox Method](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/activateedititemtextbox-method/llms-full.txt): Displays a text box to edit the specified RibbonListViewItem.
- [RibbonListView.CellPadding Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/cellpadding-property/llms-full.txt): Gets or sets the amount of space between the cell's item and the cell's border.
- [RibbonListView.ColumnCount Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/columncount-property/llms-full.txt): Gets the number of columns in this RibbonListView. This value is the larger of the RibbonListView.MinColumnCount property value and the maximum number of columns which can be displayed inside the control.
- [RibbonListView.ColumnWidth Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/columnwidth-property/llms-full.txt): Gets the width, in 1/96 inch, for each column in this RibbonListView. This value equals to the width of the RibbonListView's broadest RibbonListViewItem plus the horizontal cell padding value.
- [RibbonListView Constructor](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/constructor/llms-full.txt): Initializes a new instance of the RibbonListView class.
- [RibbonListView.DeactivateEditItemTextBox Method](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/deactivateedititemtextbox-method/llms-full.txt): Closes the text box that is displayed to edit an item.
- [RibbonListView.Deselectable Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/deselectable-property/llms-full.txt): Gets or sets a value whether a selected RibbonListViewItem can be deselected by clicking into a cell that does not contain a RibbonListViewItem or clicking on it in combination with the pressed Ctrl key.
- [RibbonListView.DropDownClosed Event](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/dropdownclosed-event/llms-full.txt): Occurs as the RibbonListView's drop-down menu is closed.
- [RibbonListView.DropDownItems Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/dropdownitems-property/llms-full.txt): Gets the collection of controls in the drop-down menu that is associated with this RibbonListView. These controls can be objects of type RibbonButton, RibbonComboBox, RibbonLabel, RibbonListView, RibbonTextBox or RibbonSeperator.
- [RibbonListView.DropDownOpening Event](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/dropdownopening-event/llms-full.txt): Occurs as the RibbonListView's drop-down menu is opening.
- [RibbonListView.EditItemTextBoxActivated Event](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/edititemtextboxactivated-event/llms-full.txt): Occurs when the edit item text box is displayed.
- [RibbonListView.EditItemTextBoxDeactivated Event](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/edititemtextboxdeactivated-event/llms-full.txt): Occurs when the edit item text box is closed.
- [RibbonListView.EditItemTextBoxEmptyWidth Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/edititemtextboxemptywidth-property/llms-full.txt): Gets or sets a value, in 1/96 inch, specifying the width of the edit item text box for an item where no text is set. The default value is 0.
- [RibbonListView.HideItems Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/hideitems-property/llms-full.txt): Gets or sets a value indicating whether the RibbonListViewItems are displayed inside the RibbonListView or not. The default value is false.
- [RibbonListView.HideSelectedItems Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/hideselecteditems-property/llms-full.txt): Gets or sets a value indicating whether the selected RibbonListViewItems are highlighted inside the RibbonListView or not. The default value is false.
- [RibbonListView.ItemClick Event](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/itemclick-event/llms-full.txt): Occurs when an RibbonListViewItem is clicked.
- [RibbonListView.ItemDropDownClosed Event](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/itemdropdownclosed-event/llms-full.txt): Occurs as a RibbonListViewItem's drop-down menu is closed.
- [RibbonListView.ItemDropDownOpening Event](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/itemdropdownopening-event/llms-full.txt): Occurs as a RibbonListViewItem's drop-down menu is opening.
- [RibbonListView.ItemMouseDown Event](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/itemmousedown-event/llms-full.txt): Occurs when the mouse pointer is over a RibbonListViewItem and the mouse button is pressed.
- [RibbonListView.ItemMouseEnter Event](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/itemmouseenter-event/llms-full.txt): Occurs when the mouse pointer enters a RibbonListViewItem.
- [RibbonListView.ItemMouseLeave Event](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/itemmouseleave-event/llms-full.txt): Occurs when the mouse pointer leaves a RibbonListViewItem.
- [RibbonListView.ItemMouseUp Event](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/itemmouseup-event/llms-full.txt): Occurs when the mouse pointer is over a RibbonListViewItem and the mouse button is released.
- [RibbonListView.ItemsSource Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/itemssource-property/llms-full.txt): Gets or sets an array of RibbonListViewItems used to generate the content of this RibbonListView. The default value is null.
- [RibbonListView.KeyTip Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/keytip-property/llms-full.txt): Gets or sets the keyboard shortcut of the RibbonListView.
- [RibbonListView.MaxColumnCount Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/maxcolumncount-property/llms-full.txt): Gets or sets a value specifying the maximum number of columns in this RibbonListView. If the value is set to null, the number of columns is the maximum number of columns which can be displayed inside the control. The default value is null.
- [RibbonListView.MaxColumnWidth Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/maxcolumnwidth-property/llms-full.txt): Gets or sets a value, in 1/96 inch, specifying the maximum column width in this RibbonListView. The default value is int.MaxValue.
- [RibbonListView.MaxVisibleRows Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/maxvisiblerows-property/llms-full.txt): Gets or sets a value specifying the maximum number of rows that are displayed by the RibbonListView. If the value is set to null, the number of rows is not limited and the RibbonListView's height bounds to the actual number of rows. The default value is null.
- [RibbonListView.MinColumnCount Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/mincolumncount-property/llms-full.txt): Gets or sets the minimum number of columns in this RibbonListView.
- [RibbonListView.MinColumnWidth Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/mincolumnwidth-property/llms-full.txt): Gets or sets the minimum width, in 1/96 inch, of a column. The default value is 0.
- [RibbonListView.MinimumWidth Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/minimumwidth-property/llms-full.txt): Gets or sets the minimum width, in 1/96 inch, of the RibbonListView. The default value is 0.
- [RibbonListView.MinRowCount Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/minrowcount-property/llms-full.txt): Gets or sets the minimum number of rows in this RibbonListView.
- [RibbonListView.MultiSelect Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/multiselect-property/llms-full.txt): Gets or sets a value indicating whether multiple items can be selected.
- [RibbonListView.ParentCollection Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/parentcollection-property/llms-full.txt): Gets the RibbonItemCollection that contains this RibbonListView.
- [RibbonListView.RibbonListViewItems Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/ribbonlistviewitems-property/llms-full.txt): Gets a collection containing all items in this RibbonListView.
- [RibbonListView.RowCount Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/rowcount-property/llms-full.txt): Gets the number of rows in this RibbonListView.
- [RibbonListView.RowHeight Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/rowheight-property/llms-full.txt): Gets the height, in 1/96 inch, for each row in this RibbonListView. This value equals to the height of the RibbonListView's highest RibbonListViewItem plus the vertical cell padding value.
- [RibbonListView.ScrollButtonsVisible Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/scrollbuttonsvisible-property/llms-full.txt): Gets or sets a value whether the scroll bars buttons should be displayed or not. The default value is true.
- [RibbonListView.ScrollTo Method](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/scrollto-method/llms-full.txt): Scrolls the contents of the RibbonListView to a specified RibbonListViewItem.
- [RibbonListView.SelectedIndices Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/selectedindices-property/llms-full.txt): Gets or sets the indexes of the selected items in this RibbonListView.
- [RibbonListView.SelectedItems Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/selecteditems-property/llms-full.txt): Gets or sets the items that are selected in this RibbonListView.
- [RibbonListView.SelectWithArrowKeys Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/selectwitharrowkeys-property/llms-full.txt): Gets or sets a value indicating whether an item is set to selected after choosing it by using arrow keys. If the property is set to false, pressing an arrow key moves the selector to the corresponding item, but does not select the item. The default value is false.
- [RibbonListView.ShowBorder Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/showborder-property/llms-full.txt): Gets or sets a value indicating whether this RibbonListView is surrounded by a border or not. The default value is false.
- [RibbonListView.ShowItemsInDropDown Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/showitemsindropdown-property/llms-full.txt): Gets or sets a value indicating whether this RibbonListView's drop down menu displays additionally to the drop down items the control's RibbonListViewItems or not. The default value is false.
- [RibbonListView.ToolTip Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/tooltip-property/llms-full.txt): Gets an object of type RibbonToolTip that displays text when the mouse pointer hovers over RibbonListView's scroll bar or drop-down button.
- [RibbonListView.ViewMode Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/viewmode-property/llms-full.txt): Gets or sets the mode in which this RibbonListView displays its items. All values can be combined with each other. The default value is ListViewMode.Icon.

---

## Nearby

- **Previous:** [RibbonLabel.ToolTip Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlabel/tooltip-property/llms-full.txt)
- **Next:** [RibbonListView.ActivateEditItemTextBox Method](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol-windows-forms-ribbon/ribbonlistview/activateedititemtextbox-method/llms-full.txt)
