TreeView.StateImageList Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta l'elenco delle immagini utilizzato per indicare lo stato di TreeView e dei relativi nodi.

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

Valore della proprietà

ImageList

Oggetto ImageList utilizzato per indicare lo stato di TreeView e dei relativi nodi.

Esempio

Nell'esempio di codice seguente viene illustrata la StateImageList proprietà . Per eseguire questo esempio, incollare il codice in un Windows Form e chiamare InitializeCheckTreeView dal costruttore o Load dal gestore eventi del modulo.

    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

Commenti

Per indicare lo stato di un TreeNode, impostare la proprietà e impostare anche la StateImageListStateImageKey proprietà o StateImageIndex per ogni TreeNodeoggetto .

Le immagini di stato visualizzate in TreeView sono 16 x 16 pixel per impostazione predefinita. L'impostazione della ImageSize proprietà dell'oggetto StateImageList non avrà alcun effetto sulla modalità di visualizzazione delle immagini. Tuttavia, le immagini di stato vengono ridimensionate in base all'impostazione DPI di sistema quando il file app.config contiene la voce seguente:

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

Quando la proprietà di un TreeView oggetto è impostata su true e la CheckBoxesStateImageList proprietà è impostata, ognuna TreeNode contenuta nell'oggetto TreeView visualizza rispettivamente la prima e la seconda immagine da StateImageList per indicare uno stato deselezionato o controllato. È necessario impostare la proprietà prima di aggiungere nodi all'oggetto StateImageListTreeView per evitare che le immagini di stato vengano visualizzate in fase di progettazione per i nodi che non dispongono di un set di immagini di stato.