TreeView.StateImageList Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft die Bildliste ab, mit der der Zustand der TreeView und ihrer Knoten angegeben wird.

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

Eigenschaftswert

ImageList

Die ImageList, die zum Angeben des Zustands der TreeView und ihrer Knoten verwendet wird.

Beispiele

Im folgenden Codebeispiel wird die StateImageList -Eigenschaft veranschaulicht. Fügen Sie zum Ausführen dieses Beispiels den Code in eine Windows Form ein, und rufen Sie InitializeCheckTreeView den Konstruktor oder Load Ereignishandler des Formulars auf.

    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

Hinweise

Um den Zustand eines TreeNodeanzugeben, legen Sie die StateImageList -Eigenschaft und auch die - oder StateImageIndex -StateImageKeyEigenschaft für jeden TreeNodefest.

Die in angezeigten Zustandsbilder TreeView sind standardmäßig 16 x 16 Pixel. Das Festlegen der ImageSize -Eigenschaft von StateImageList hat keine Auswirkungen auf die Darstellung der Bilder. Die Größe der Zustandsbilder wird jedoch entsprechend der DPI-Einstellung des Systems geändert, wenn die app.config Datei den folgenden Eintrag enthält:

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

Wenn die CheckBoxes Eigenschaft von auf TreeView festgelegt true ist und die StateImageList -Eigenschaft festgelegt ist, zeigt jedes TreeNode in enthaltene TreeView die ersten und zweiten Bilder von aus StateImageList an, um einen deaktivierten oder überprüften Zustand anzugeben. Sie sollten die StateImageList -Eigenschaft festlegen, bevor Sie Knoten TreeView hinzufügen, um zu verhindern, dass Zustandsbilder zur Entwurfszeit für Knoten angezeigt werden, für die kein Zustandsbild festgelegt ist.