TreeView.StateImageList 屬性

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

來源:

TreeView.cs

取得或設定用於表示 TreeView 和其節點之狀態的影像清單。

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

public System.Windows.Forms.ImageList? StateImageList { get; set; }

member this.StateImageList : System.Windows.Forms.ImageList with get, set

Public Property StateImageList As ImageList

屬性值

ImageList

用於指示 ImageList 和其節點之狀態的 TreeView。

範例

下列程式碼範例示範 StateImageList 屬性。 若要執行此範例，請將程式碼貼到 Windows Form，並從表單的建構函式或 Load 事件處理常式呼叫 InitializeCheckTreeView 。

    TreeView^ checkTreeView;
private:
    void InitializeCheckTreeView()
    {
        checkTreeView = gcnew TreeView();

        // Show check boxes for the TreeView. This
        // will cause the StateImageList to be used.
        checkTreeView->CheckBoxes = true;

        // Create the StateImageList and add two images.
        checkTreeView->StateImageList = gcnew ImageList();
        checkTreeView->StateImageList->Images->Add(SystemIcons::Question);
        checkTreeView->StateImageList->Images->Add(SystemIcons::Exclamation);

        // Add some nodes to the TreeView and the TreeView to the form.
        checkTreeView->Nodes->Add("Node1");
        checkTreeView->Nodes->Add("Node2");
        this->Controls->Add(checkTreeView);
    }

TreeView checkTreeView;
private void InitializeCheckTreeView()
{
    checkTreeView = new TreeView();
    
    // Show check boxes for the TreeView. This
    // will cause the StateImageList to be used.
    checkTreeView.CheckBoxes = true;

    // Create the StateImageList and add two images.
    checkTreeView.StateImageList = new ImageList();
    checkTreeView.StateImageList.Images.Add(SystemIcons.Question);
    checkTreeView.StateImageList.Images.Add(SystemIcons.Exclamation);
    
    // Add some nodes to the TreeView and the TreeView to the form.
    checkTreeView.Nodes.Add("Node1");
    checkTreeView.Nodes.Add("Node2");
    this.Controls.Add(checkTreeView);
}

Private checkTreeView As TreeView

Private Sub InitializeCheckTreeView() 
    checkTreeView = New TreeView()
    
    ' Show check boxes for the TreeView.
    checkTreeView.CheckBoxes = True
    
    ' Create the StateImageList and add two images.
    checkTreeView.StateImageList = New ImageList()
    checkTreeView.StateImageList.Images.Add(SystemIcons.Question)
    checkTreeView.StateImageList.Images.Add(SystemIcons.Exclamation)
    
    ' Add some nodes to the TreeView and the TreeView to the form.
    checkTreeView.Nodes.Add("Node1")
    checkTreeView.Nodes.Add("Node2")
    Me.Controls.Add(checkTreeView)

End Sub

備註

若要指出 的狀態 TreeNode ，請設定 StateImageList 屬性，同時設定 StateImageKey 每個 TreeNode 的 或 StateImageIndex 屬性。

中 TreeView 顯示的狀態影像預設為 16 x 16 圖元。 ImageSize設定 的 StateImageList 屬性不會影響影像的顯示方式。 不過，當app.config檔案包含下列專案時，狀態影像會根據系統 DPI 設定來調整大小：

<appSettings>
  <add key="EnableWindowsFormsHighDpiAutoResizing" value="true" />
</appSettings>

CheckBoxes當 的 TreeView 屬性設定為 true 且 StateImageList 屬性已設定時，每個包含在 中的 TreeView 影像 TreeNode 都會分別顯示 的第一個和第二個影像 StateImageList ，以指出未核取或已檢查的狀態。 您應該先設定 屬性， StateImageList 再將節點新增至 ， TreeView 以防止在設計階段顯示沒有狀態映射集的節點顯示狀態影像。