ListViewItem.UseItemStyleForSubItems ListViewItem.UseItemStyleForSubItems ListViewItem.UseItemStyleForSubItems ListViewItem.UseItemStyleForSubItems Property

定義

項目の Font プロパティ、ForeColor プロパティ、および BackColor プロパティがすべてのサブ項目に対して使用されるかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the Font, ForeColor, and BackColor properties for the item are used for all its subitems.

public:
 property bool UseItemStyleForSubItems { bool get(); void set(bool value); };
public bool UseItemStyleForSubItems { get; set; }
member this.UseItemStyleForSubItems : bool with get, set
Public Property UseItemStyleForSubItems As Boolean

プロパティ値

すべてのサブ項目で項目のフォント、前景色、背景色の設定を使用する場合は true。それ以外の場合は falsetrue if all subitems use the font, foreground color, and background color settings of the item; otherwise, false. 既定値は、true です。The default is true.

次のコード例は、 UseItemStyleForSubItemsプロパティをにfalse設定して、オブジェクトのListViewItem.ListViewSubItemカスタムスタイルを定義する方法を示しています。The following code example demonstrates how to set the UseItemStyleForSubItems property to false to define a custom style for ListViewItem.ListViewSubItem objects. この例では、プロパティForeColorFontプロパティを設定する方法も示しています。The example also demonstrates how to set the ForeColor and Font properties. この例を実行するには、フォームに次のコードを貼りInitializeListView付け、フォームのコンストラクターまたLoadはイベント処理メソッドでメソッドを呼び出します。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

注釈

ListViewコントロールのすべての項目とサブ項目に対して、均一な背景色、前景色、およびフォントを使用しない場合は、このプロパティをにfalse設定できます。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. このプロパティがtrueに設定されている場合、サブ項目のListViewItem.ListViewSubItem.FontListViewItem.ListViewSubItem.ForeColor、およびListViewItem.ListViewSubItem.BackColorの各プロパティに加えられた変更はすべて無視され、代わりに項目の値が使用されます。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. このプロパティは、 ListViewコントロールにサブ項目が表示されている場合に、サブ項目が項目を強調表示するために使用する、別のテキストの色、背景色、またはフォントを指定する必要がある場合に使用できます。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.

適用対象

こちらもご覧ください