ListViewItem.UseItemStyleForSubItems 属性
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
public:
property bool UseItemStyleForSubItems { bool get(); void set(bool value); };public bool UseItemStyleForSubItems { get; set; }member this.UseItemStyleForSubItems : bool with get, setPublic Property UseItemStyleForSubItems As Boolean属性值
如果所有子项均使用该项的字体、前景色和背景色设置，则为 true；否则，为 false。 默认值为 true。
示例
下面的代码示例演示如何将 UseItemStyleForSubItems 属性 false 设置为 以定义 ListViewItem.ListViewSubItem 对象的自定义样式。 该示例还演示如何设置 ForeColor 和 Font 属性。 若要运行该示例，请将以下代码粘贴到窗体中，并在窗体的构造函数或Load事件处理方法中调用 InitializeListView 方法。
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
注解
如果不希望为控件中的所有 ListView 项和子项使用统一的背景色、前景色和字体，可以将此属性设置为 false。 当此属性设置为 true时，将忽略对子项的 ListViewItem.ListViewSubItem.Font、 ListViewItem.ListViewSubItem.ForeColor和 ListViewItem.ListViewSubItem.BackColor 属性所做的任何更改，并改用项的值。 如果需要指定要用于子项的不同文本颜色、背景色或字体，以便在控件中 ListView 显示子项时突出显示项，则可以使用此属性。
