TreeView.StateImageList Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit la liste d'images utilisée pour indiquer l'état de TreeView et de ses nœuds.

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

Valeur de propriété

ImageList

ImageList utilisé pour indiquer l'état de TreeView et de ses nœuds.

Exemples

L’exemple de code suivant illustre la StateImageList propriété . Pour exécuter cet exemple, collez le code dans un Windows Form et appelez InitializeCheckTreeView à partir du constructeur ou Load du gestionnaire d’événements du formulaire.

    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

Remarques

Pour indiquer l’état d’un TreeNode, définissez la StateImageList propriété et définissez également la StateImageKey propriété ou StateImageIndex pour chaque TreeNode.

Les images d’état affichées dans le TreeView sont de 16 x 16 pixels par défaut. La définition de la ImageSize propriété de n’aura StateImageList aucun effet sur la façon dont les images sont affichées. Toutefois, les images d’état sont redimensionnées en fonction du paramètre DPI système lorsque le fichier app.config contient l’entrée suivante :

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

Lorsque la CheckBoxes propriété d’un TreeView est définie true sur et que la StateImageList propriété est définie, chacune TreeNode d’elles contenue dans affiche TreeView les première et deuxième images du StateImageList pour indiquer un état non coché ou coché, respectivement. Vous devez définir la StateImageList propriété avant d’ajouter des nœuds à pour empêcher l’affichage des images d’état au moment de la TreeView conception pour les nœuds qui n’ont pas d’image d’état.