ListViewItem.UseItemStyleForSubItems 속성

정의

항목에 대한 Font, ForeColorBackColor 속성을 해당 항목의 모든 하위 항목에 대해 사용할 것인지를 나타내는 값을 가져오거나 설정합니다.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이고, 그렇지 않으면 false입니다.true if all subitems use the font, foreground color, and background color settings of the item; otherwise, false. 기본값은 true입니다.The default is true.

예제

다음 코드 예제에서는 falseUseItemStyleForSubItems 속성을 설정 하 여 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. 예제를 실행 하려면 다음 코드를 폼에 붙여넣고 폼의 생성자 또는 Load 이벤트 처리 메서드에서 InitializeListView 메서드를 호출 합니다.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.Font, ListViewItem.ListViewSubItem.ForeColorListViewItem.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.

적용 대상

추가 정보