UseItemStyleForSubItems Property

ListViewItem::UseItemStyleForSubItems Property

 

Gets or sets a value indicating whether the Font, ForeColor, and BackColor properties for the item are used for all its subitems.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public:
property bool UseItemStyleForSubItems {
	bool get();
	void set(bool value);
}

Property Value

Type: System::Boolean

true if all subitems use the font, foreground color, and background color settings of the item; otherwise, false. The default is true.

If you do not want to have a uniform background color, foreground color, and font used for all items and subitems in your ListView control, you can set this property to false. When this property is set to true, any changes made to the subitem's ListViewItem::ListViewSubItem::Font, ListViewItem::ListViewSubItem::ForeColor, and ListViewItem::ListViewSubItem::BackColor properties are ignored, and the values of the item are used instead. You can use this property if you need to specify a different text color, background color, or font to be used for a subitem to highlight the item when subitems are displayed in the ListView control.

The following code example demonstrates how to set the UseItemStyleForSubItems property to false to define a custom style for ListViewItem::ListViewSubItem objects. The example also demonstrates how to set the ForeColor and Font properties. To run the example, paste the following code into a form and call the InitializeListView method in form's constructor or Load event-handling method.

internal:
   // Declare the Listview object.
   System::Windows::Forms::ListView^ myListView;

private:

   // Initialize the ListView object with subitems of a different
   // style than the default styles for the ListView.
   void InitializeListView()
   {
      // Set the Location, View and Width properties for the 
      // ListView object. 
      myListView = gcnew ListView;
      myListView->Location = System::Drawing::Point( 20, 20 );
      myListView->Width = 250;

      // The View property must be set to Details for the 
      // subitems to be visible.
      myListView->View = View::Details;

      // Each SubItem object requires a column, so add three columns.
      this->myListView->Columns->Add( "Key", 50, HorizontalAlignment::Left );
      this->myListView->Columns->Add( "A", 100, HorizontalAlignment::Left );
      this->myListView->Columns->Add( "B", 100, HorizontalAlignment::Left );

      // Add a ListItem object to the ListView.
      ListViewItem^ entryListItem = myListView->Items->Add( "Items" );

      // Set UseItemStyleForSubItems property to false to change 
      // look of subitems.
      entryListItem->UseItemStyleForSubItems = false;

      // Add the expense subitem.
      ListViewItem::ListViewSubItem ^ expenseItem = entryListItem->SubItems->Add( "Expense" );

      // Change the expenseItem object's color and font.
      expenseItem->ForeColor = System::Drawing::Color::Red;
      expenseItem->Font = gcnew System::Drawing::Font( "Arial",10,System::Drawing::FontStyle::Italic );

      // Add a subitem called revenueItem 
      ListViewItem::ListViewSubItem ^ revenueItem = entryListItem->SubItems->Add( "Revenue" );

      // Change the revenueItem object's color and font.
      revenueItem->ForeColor = System::Drawing::Color::Blue;
      revenueItem->Font = gcnew System::Drawing::Font( "Times New Roman",10,System::Drawing::FontStyle::Bold );

      // Add the ListView to the form.
      this->Controls->Add( this->myListView );
   }

.NET Framework
Available since 1.1
Return to top
Show:
© 2016 Microsoft