TreeView.StateImageList Tulajdonság

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

TreeView.cs

Lekéri vagy beállítja a rendszerképlistát, amely a csomópontok állapotának TreeView jelzésére szolgál.

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

Tulajdonság értéke

ImageList

A ImageList csomópontok és a csomópontok állapotának TreeView jelzésére használt.

Példák

Az alábbi példakód a tulajdonságot StateImageList mutatja be. A példa futtatásához illessze be a kódot egy Windows űrlapba, és hívja meg InitializeCheckTreeView az űrlap konstruktorából vagy Load eseménykezelőből.

    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

Megjegyzések

Az állapot jelzéséhez TreeNodeállítsa be a StateImageList tulajdonságot, és állítsa be az StateImageKey egyes StateImageIndextulajdonságokat isTreeNode.

A megjelenített TreeView állapotképek alapértelmezés szerint 16 x 16 képpont méretűek. A ImageSize tulajdonság StateImageList beállítása nem befolyásolja a képek megjelenítését. Az állapotképek átméretezése azonban a rendszer DPI-beállításainak megfelelően történik, amikor a app.config fájl a következő bejegyzést tartalmazza:

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

Ha egy CheckBoxesTreeViewtrue tulajdonság értéke és a StateImageList tulajdonság be van állítva, az egyes TreeNodeTreeView elemek az első és a második képet jelenítik meg a StateImageList jelölőnégyzet nélküli vagy bejelöletlen állapot jelzéséhez. Mielőtt csomópontokat ad hozzá, be kell állítania a StateImageListTreeView tulajdonságot, hogy ne jelenjenek meg állapotlemezképek a tervezési időben olyan csomópontok esetében, amelyek nem rendelkeznek állapotrendszerkép-készlettel.