Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

ListViewItem.ListViewSubItem.Font Property

Gets or sets the font of the text displayed by the subitem.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

[LocalizableAttribute(true)] 
public Font Font { get; set; }
/** @property */
public Font get_Font ()

/** @property */
public void set_Font (Font value)

public function get Font () : Font

public function set Font (value : Font)

Property Value

The Font to apply to the text displayed by the control.

You can use this property to change the font styles applied to the text of the subitem. If the UseItemStyleForSubItems property of the ListViewItem is set to true, changing this property will have no effect. Because the Font is immutable (meaning that you cannot adjust any of its properties), you can only assign the Font property a new Font. However, you can base the new font on the existing font.

The following is an example of how to adjust the existing font to make it bold:

listViewItem1.SubItems[1].Font = new Font(listViewItem1.SubItems[1].Font, 
       listViewItem1.SubItems[1].Font.Style | FontStyle.Bold);

If the UseItemStyleForSubItems property of the ListViewItem that owns the subitem is set to true, setting this property has no effect.

The following code example demonstrates how to set the UseItemStyleForSubItems property to false to define a custom style for ListViewItem.ListViewSubItem objects. The example 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.


// 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);
}

// Declare the Listview object.
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.set_Location(new System.Drawing.Point(20, 20));
    myListView.set_Width(250);
    // The View property must be set to Details for the 
    // subitems to be visible.
    myListView.set_View(View.Details);
    // Each SubItem object requires a column, so add three columns.
    this.myListView.get_Columns().Add("Key", 50, HorizontalAlignment.Left);
    this.myListView.get_Columns().Add("A", 100, HorizontalAlignment.Left);
    this.myListView.get_Columns().Add("B", 100, HorizontalAlignment.Left);
    // Add a ListItem object to the ListView.
    ListViewItem entryListItem = myListView.get_Items().Add("Items");
    // Set UseItemStyleForSubItems property to false to change 
    // look of subitems.
    entryListItem.set_UseItemStyleForSubItems(false);
    // Add the expense subitem.
    ListViewItem.ListViewSubItem expenseItem =
        entryListItem.get_SubItems().Add("Expense");
    // Change the expenseItem object's color and font.
    expenseItem.set_ForeColor(System.Drawing.Color.get_Red());
    expenseItem.set_Font(new System.Drawing.Font("Arial", 10,
        System.Drawing.FontStyle.Italic));
    // Add a subitem called revenueItem 
    ListViewItem.ListViewSubItem revenueItem =
        entryListItem.get_SubItems().Add("Revenue");
    // Change the revenueItem object's color and font.
    revenueItem.set_ForeColor(System.Drawing.Color.get_Blue());
    revenueItem.set_Font(new System.Drawing.Font("Times New Roman", 10,
        System.Drawing.FontStyle.Bold));
    // Add the ListView to the form.
    this.get_Controls().Add(this.myListView);
} //InitializeListView

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.