ListViewItem.Group 屬性

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

來源:

ListViewItem.cs

取得或設定該項目所分配的群組。

public:
 property System::Windows::Forms::ListViewGroup ^ Group { System::Windows::Forms::ListViewGroup ^ get(); void set(System::Windows::Forms::ListViewGroup ^ value); };

public System.Windows.Forms.ListViewGroup? Group { get; set; }

member this.Group : System.Windows.Forms.ListViewGroup with get, set

Public Property Group As ListViewGroup

屬性值

ListViewGroup

該項目被分配給的對象 ListViewGroup 。

範例

以下程式碼範例示範如何在 Group 應用程式中依子項目值組織 ListView 細節檢視。 這種分組方式類似於 Windows 檔案總管中使用的分組方式。 在範例中，群組是動態建立的。 每個子項目欄位，為每個獨特子項目值建立一個群組。 對於父項目欄位，每個唯一字母首字母會建立一個群組。 每欄建立的群組會與子項目文字或首字母一同儲存在雜湊表中。 當點擊欄位標頭時，會取得該欄位對應的雜湊表。 接著，該欄位的子項目文字值作為雜湊表鍵，以取得每個項目的正確群組。 然後，該項目會被分配給使用該 Group 屬性的群組。

此程式碼範例是該物業更大 ListView.Groups 範例的一部分。

   // Sets myListView to the groups created for the specified column.
private:
   void SetGroups(int column)
   {
      // Remove the current groups.
      myListView->Groups->Clear();

      // Retrieve the hash table corresponding to the column.
      Hashtable^ groups = dynamic_cast<Hashtable^>(groupTables[column]);

      // Copy the groups for the column to an array.
      array<ListViewGroup^>^ groupsArray = gcnew array<ListViewGroup^>(groups->Count);
      groups->Values->CopyTo(groupsArray, 0);

      // Sort the groups and add them to myListView.
      Array::Sort(groupsArray, gcnew ListViewGroupSorter(myListView->Sorting));
      myListView->Groups->AddRange(groupsArray);

      // Iterate through the items in myListView, assigning each 
      // one to the appropriate group.
      IEnumerator^ myEnum = myListView->Items->GetEnumerator();
      while (myEnum->MoveNext())
      {
         ListViewItem^ item = safe_cast<ListViewItem^>(myEnum->Current);
         // Retrieve the subitem text corresponding to the column.
         String^ subItemText = item->SubItems[column]->Text;

         // For the Title column, use only the first letter.
         if (column == 0) 
         {
            subItemText = subItemText->Substring(0, 1);
         }

         // Assign the item to the matching group.
         item->Group = dynamic_cast<ListViewGroup^>(groups[subItemText]);
      }
   }

// Sets myListView to the groups created for the specified column.
private void SetGroups(int column)
{
    // Remove the current groups.
    myListView.Groups.Clear();

    // Retrieve the hash table corresponding to the column.
    Hashtable groups = (Hashtable)groupTables[column];

    // Copy the groups for the column to an array.
    ListViewGroup[] groupsArray = new ListViewGroup[groups.Count];
    groups.Values.CopyTo(groupsArray, 0);

    // Sort the groups and add them to myListView.
    Array.Sort(groupsArray, new ListViewGroupSorter(myListView.Sorting));
    myListView.Groups.AddRange(groupsArray);

    // Iterate through the items in myListView, assigning each 
    // one to the appropriate group.
    foreach (ListViewItem item in myListView.Items)
    {
        // Retrieve the subitem text corresponding to the column.
        string subItemText = item.SubItems[column].Text;

        // For the Title column, use only the first letter.
        if (column == 0) 
        {
            subItemText = subItemText.Substring(0, 1);
        }

        // Assign the item to the matching group.
        item.Group = (ListViewGroup)groups[subItemText];
    }
}

' Sets myListView to the groups created for the specified column.
Private Sub SetGroups(column As Integer)
    ' Remove the current groups.
    myListView.Groups.Clear()
    
    ' Retrieve the hash table corresponding to the column.
    Dim groups As Hashtable = CType(groupTables(column), Hashtable)
    
    ' Copy the groups for the column to an array.
    Dim groupsArray(groups.Count - 1) As ListViewGroup
    groups.Values.CopyTo(groupsArray, 0)
    
    ' Sort the groups and add them to myListView.
    Array.Sort(groupsArray, New ListViewGroupSorter(myListView.Sorting))
    myListView.Groups.AddRange(groupsArray)
    
    ' Iterate through the items in myListView, assigning each 
    ' one to the appropriate group.
    Dim item As ListViewItem
    For Each item In myListView.Items
        ' Retrieve the subitem text corresponding to the column.
        Dim subItemText As String = item.SubItems(column).Text
        
        ' For the Title column, use only the first letter.
        If column = 0 Then
            subItemText = subItemText.Substring(0, 1)
        End If 

        ' Assign the item to the matching group.
        item.Group = CType(groups(subItemText), ListViewGroup)
    Next item
End Sub

備註

利用此屬性設定該項目所屬的群組。 你也可以在建構子中 ListViewItem 設定群組，或利用此特性在執行時修改群組成員資格。 如果你將此屬性設為 ， null 且集合中有 ListView.Groups 群組，該項目會出現在預設群組中，該群組的標頭標籤為「DefaultGroupSystem.Windows.Forms」。 預設群組不包含在集合 ListView.Groups 中，且無法更改。 它主要用於除錯，確保所有項目都已正確加入群組。

備註

ListView 群組僅在 Windows XP 及 Windows Server 2003 家族（Windows XP 家庭版、Windows XP 專業版、Windows Server 2003）上提供。 欲了解更多資訊，請參閱 ListViewGroup 概述主題。

另請參閱

• ListViewGroup