ListViewItem.ListViewSubItem.ForeColor Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets the foreground color of the subitem's text.
public:
property System::Drawing::Color ForeColor { System::Drawing::Color get(); void set(System::Drawing::Color value); };
public System.Drawing.Color ForeColor { get; set; }
member this.ForeColor : System.Drawing.Color with get, set
Public Property ForeColor As Color
Property Value
A Color that represents the foreground color of the subitem's text.
Examples
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.
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 );
}
// 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.
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
Remarks
You can use the ForeColor property to change the color of the subitem text. This property can be used if you want to use different background and foreground color combinations (using the BackColor property to set the background color) to differentiate one item from another. For example, you could set the ForeColor property to Red to identify items that have a negative number associated with them.
If the UseItemStyleForSubItems property of the ListViewItem that owns the subitem is set to true
, setting this property has no effect.