Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

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.

[Visual Basic]
Public Property UseItemStyleForSubItems As Boolean
[C#]
public bool UseItemStyleForSubItems {get; set;}
[C++]
public: __property bool get_UseItemStyleForSubItems();
public: __property void set_UseItemStyleForSubItems(bool);
[JScript]
public function get UseItemStyleForSubItems() : Boolean;
public function set UseItemStyleForSubItems(Boolean);

Property Value

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

Remarks

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 ListViewSubItem.Font, ListViewSubItem.ForeColor, and 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.

Example

[Visual Basic, C#] The following code example demonstrates setting the UseItemStyleForSubItems property to false to define custom style for ListViewSubItem objects. To run the example, paste the following code in a form and call the InitializeListView method in form's constructor or Load method.

[Visual Basic] 

    ' Declare the Listview object.
    Friend WithEvents myListView As System.Windows.Forms.ListView

    ' Initialize the ListView object with subitems of a different
    ' style than the default styles for the ListView.
    Private Sub InitializeListView()

        ' Set the Location, View and Width properties for the 
        ' ListView object. 
        myListView = New ListView
        With (myListView)
            .Location = New System.Drawing.Point(20, 20)

            ' The View property must be set to Details for the 
            ' subitems to be visible.
            .View = View.Details
            .Width = 250
        End With

        ' Each SubItem object requires a column, so add three columns.
        Me.myListView.Columns.Add("Key", 50, HorizontalAlignment.Left)
        Me.myListView.Columns.Add("A", 100, HorizontalAlignment.Left)
        Me.myListView.Columns.Add("B", 100, HorizontalAlignment.Left)

        ' Add a ListItem object to the ListView.
        Dim entryListItem As ListViewItem = myListView.Items.Add("Items")

        ' Set UseItemStyleForSubItems property to false to change 
        ' look of subitems.
        entryListItem.UseItemStyleForSubItems = False

        ' Add the expense subitem.
        Dim expenseItem As ListViewItem.ListViewSubItem = _
            entryListItem.SubItems.Add("Expense")

        ' Change the expenseItem object's color and font.
        expenseItem.ForeColor = System.Drawing.Color.Red
        expenseItem.Font = New System.Drawing.Font _
            ("Arial", 10, System.Drawing.FontStyle.Italic)

        ' Add a subitem called revenueItem 
        Dim revenueItem As ListViewItem.ListViewSubItem = _
            entryListItem.SubItems.Add("Revenue")

        ' Change the revenueItem object's color and font.
        revenueItem.ForeColor = System.Drawing.Color.Blue
        revenueItem.Font = New System.Drawing.Font _
            ("Times New Roman", 10, System.Drawing.FontStyle.Bold)

        ' Add the ListView to the form.
        Me.Controls.Add(Me.myListView)
    End Sub

[C#] 

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

    // Initialize the ListView object with subitems of a different
    // style than the default styles for the ListView.
    private void InitializeListView()
    {

        // Set the Location, View and Width properties for the 
        // ListView object. 
        myListView = new ListView();
        myListView.Location = new 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 = new 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 = new System.Drawing.Font(
            "Times New Roman", 10, System.Drawing.FontStyle.Bold);

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

[C++, JScript] No example is available for C++ or JScript. To view a Visual Basic or C# example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

ListViewItem Class | ListViewItem Members | System.Windows.Forms Namespace | ForeColor | BackColor | Font

Show:
© 2015 Microsoft