TreeView.StateImageList Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

TreeView.cs

Ottiene o imposta l'elenco di immagini utilizzato per indicare lo stato di e i TreeView 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 dell'oggetto e dei TreeView 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 TreeNodeoggetto , impostare la StateImageList proprietà e impostare anche la StateImageKey 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à di 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 di app.config contiene la voce seguente:

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

Quando la CheckBoxes proprietà di un TreeView oggetto è impostata su e la StateImageList proprietà è impostatatrue, ogni TreeNode oggetto contenuto in TreeView visualizza le prime e le seconde immagini da StateImageList per indicare rispettivamente uno stato deselezionato o selezionato. È necessario impostare la StateImageList proprietà prima di aggiungere nodi a TreeView 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.