TreeView.StateImageList Eigenschap

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; }

public System.Windows.Forms.ImageList? StateImageList { get; set; }

member this.StateImageList : System.Windows.Forms.ImageList with get, set

Public Property StateImageList As ImageList

Waarde van eigenschap

De ImageList knooppunten die worden gebruikt om de status van de TreeView en de bijbehorende knooppunten aan te geven.

Voorbeelden

In het volgende codevoorbeeld ziet u de StateImageList eigenschap. Als u dit voorbeeld wilt uitvoeren, plakt u de code in een Windows Formulier en roept u InitializeCheckTreeView aan vanuit de constructor van het formulier of Load gebeurtenis-handler.

    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

Opmerkingen

Als u de status van een TreeNodewilt aangeven, stelt u de StateImageList eigenschap in en stelt u ook de StateImageKey of StateImageIndex eigenschap voor elke TreeNodeeigenschap in.

De statusafbeeldingen die in de TreeView status worden weergegeven, zijn standaard 16 x 16 pixels. Het instellen van de ImageSize eigenschap van de StateImageList afbeelding heeft geen effect op de weergave van de afbeeldingen. De statusafbeeldingen worden echter aangepast aan de systeem-DPI-instelling wanneer het app.config bestand de volgende vermelding bevat:

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

Wanneer de CheckBoxes eigenschap van een TreeView eigenschap is ingesteld true op en de StateImageList eigenschap is ingesteld, worden de TreeNode eerste en tweede afbeeldingen in de TreeView eerste en tweede afbeeldingen weergegeven van de StateImageList om respectievelijk een niet-ingeschakelde of gecontroleerde status aan te geven. U moet de StateImageList eigenschap instellen voordat u knooppunten toevoegt aan de TreeView knooppunten om te voorkomen dat statusafbeeldingen worden weergegeven tijdens het ontwerp voor knooppunten waarvoor geen statusinstallatiekopieën zijn ingesteld.