StatusBar.StatusBarPanelCollection Klas

Definitie

public: ref class StatusBar::StatusBarPanelCollection : System::Collections::IList

public class StatusBar.StatusBarPanelCollection : System.Collections.IList

[System.ComponentModel.ListBindable(false)]
public class StatusBar.StatusBarPanelCollection : System.Collections.IList

type StatusBar.StatusBarPanelCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

[<System.ComponentModel.ListBindable(false)>]
type StatusBar.StatusBarPanelCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

Public Class StatusBar.StatusBarPanelCollection
Implements IList

Overname

Object

StatusBar.StatusBarPanelCollection

Kenmerken

ListBindableAttribute

Implementeringen

ICollection IEnumerable IList

Voorbeelden

In het volgende codevoorbeeld wordt een StatusBar besturingselement op een formulier gemaakt en worden twee StatusBarPanel objecten toegevoegd. Een van de StatusBarPanelbenoemde panel1statusteksten voor een toepassing wordt weergegeven. De tweede StatusBarPanel, benoemde panel2, geeft de huidige datum weer en gebruikt de ToolTipText eigenschap van de StatusBarPanel klasse om de huidige tijd weer te geven. In het voorbeeld wordt de ShowPanels eigenschap gebruikt om ervoor te zorgen dat de panelen worden weergegeven in plaats van een standaardpaneel, en de Panels eigenschap voor toegang tot de Add methode van de StatusBar.StatusBarPanelCollection deelvensters om de panelen toe te voegen aan de StatusBar. In het voorbeeld worden ook de AutoSizeeigenschappen , BorderStyleen TextToolTipTexteigenschappen gebruikt om de StatusBarPanel objecten te initialiseren. In dit voorbeeld wordt ervan uitgegaan dat de in het voorbeeld gedefinieerde methode wordt gedefinieerd en aangeroepen vanuit de constructor van een Form.

private:
   void CreateMyStatusBar()
   {
      // Create a StatusBar control.
      StatusBar^ statusBar1 = gcnew StatusBar;

      // Create two StatusBarPanel objects to display in the StatusBar.
      StatusBarPanel^ panel1 = gcnew StatusBarPanel;
      StatusBarPanel^ panel2 = gcnew StatusBarPanel;

      // Display the first panel with a sunken border style.
      panel1->BorderStyle = StatusBarPanelBorderStyle::Sunken;

      // Initialize the text of the panel.
      panel1->Text = "Ready...";

      // Set the AutoSize property to use all remaining space on the StatusBar.
      panel1->AutoSize = StatusBarPanelAutoSize::Spring;

      // Display the second panel with a raised border style.
      panel2->BorderStyle = StatusBarPanelBorderStyle::Raised;

      // Create ToolTip text that displays the time the application
      // was started.
      panel2->ToolTipText = System::DateTime::Now.ToShortTimeString();

      // Set the text of the panel to the current date.
      panel2->Text = "Started: " + System::DateTime::Today.ToLongDateString();

      // Set the AutoSize property to size the panel to the size of the contents.
      panel2->AutoSize = StatusBarPanelAutoSize::Contents;

      // Display panels in the StatusBar control.
      statusBar1->ShowPanels = true;

      // Add both panels to the StatusBarPanelCollection of the StatusBar.   
      statusBar1->Panels->Add( panel1 );
      statusBar1->Panels->Add( panel2 );

      // Add the StatusBar to the form.
      this->Controls->Add( statusBar1 );
   }

private void CreateMyStatusBar()
{
    // Create a StatusBar control.
    StatusBar statusBar1 = new StatusBar();
    // Create two StatusBarPanel objects to display in the StatusBar.
    StatusBarPanel panel1 = new StatusBarPanel();
    StatusBarPanel panel2 = new StatusBarPanel();

    // Display the first panel with a sunken border style.
    panel1.BorderStyle = StatusBarPanelBorderStyle.Sunken;
    // Initialize the text of the panel.
    panel1.Text = "Ready...";
    // Set the AutoSize property to use all remaining space on the StatusBar.
    panel1.AutoSize = StatusBarPanelAutoSize.Spring;
    
    // Display the second panel with a raised border style.
    panel2.BorderStyle = StatusBarPanelBorderStyle.Raised;
    
    // Create ToolTip text that displays time the application was started.
    panel2.ToolTipText = "Started: " + System.DateTime.Now.ToShortTimeString();
    // Set the text of the panel to the current date.
    panel2.Text = System.DateTime.Today.ToLongDateString();
    // Set the AutoSize property to size the panel to the size of the contents.
    panel2.AutoSize = StatusBarPanelAutoSize.Contents;
                
    // Display panels in the StatusBar control.
    statusBar1.ShowPanels = true;

    // Add both panels to the StatusBarPanelCollection of the StatusBar.			
    statusBar1.Panels.Add(panel1);
    statusBar1.Panels.Add(panel2);

    // Add the StatusBar to the form.
    this.Controls.Add(statusBar1);
}

Private Sub CreateMyStatusBar()
   ' Create a StatusBar control.
   Dim statusBar1 As New StatusBar()

   ' Create two StatusBarPanel objects to display in the StatusBar.
   Dim panel1 As New StatusBarPanel()
   Dim panel2 As New StatusBarPanel()

   ' Display the first panel with a sunken border style.
   panel1.BorderStyle = StatusBarPanelBorderStyle.Sunken

   ' Initialize the text of the panel.
   panel1.Text = "Ready..."

   ' Set the AutoSize property to use all remaining space on the StatusBar.
   panel1.AutoSize = StatusBarPanelAutoSize.Spring
   
   ' Display the second panel with a raised border style.
   panel2.BorderStyle = StatusBarPanelBorderStyle.Raised
   
   ' Create ToolTip text that displays the time the application was started.
   panel2.ToolTipText = "Started: " & System.DateTime.Now.ToShortTimeString()

   ' Set the text of the panel to the current date.
   panel2.Text = System.DateTime.Today.ToLongDateString()

   ' Set the AutoSize property to size the panel to the size of the contents.
   panel2.AutoSize = StatusBarPanelAutoSize.Contents

   ' Display panels in the StatusBar control.
   statusBar1.ShowPanels = True

   ' Add both panels to the StatusBarPanelCollection of the StatusBar.			
   statusBar1.Panels.Add(panel1)
   statusBar1.Panels.Add(panel2)

   ' Add the StatusBar to the form.
   Me.Controls.Add(statusBar1)
End Sub

Opmerkingen

De StatusBar.StatusBarPanelCollection klasse slaat de panelen op die worden weergegeven in de StatusBar. Elk object in de verzameling is een exemplaar van de StatusBarPanel klasse die de weergavekenmerken en het gedrag van een paneel definieert dat wordt weergegeven in een StatusBar.

Er zijn verschillende manieren om panelen toe te voegen aan de verzameling. De Add methode biedt de mogelijkheid om één paneel toe te voegen aan de verzameling. Als u een aantal panelen wilt toevoegen aan de verzameling, maakt u een matrix met StatusBarPanel objecten en wijst u deze toe aan de AddRange methode. Als u een paneel wilt invoegen op een specifieke locatie binnen de verzameling, kunt u de Insert methode gebruiken. Als u panelen wilt verwijderen, kunt u de Remove methode of de RemoveAt methode gebruiken als u weet waar het paneel zich in de verzameling bevindt. Met Clear de methode kunt u alle panelen uit de verzameling verwijderen in plaats van de Remove methode te gebruiken om één paneel tegelijk te verwijderen.

Naast methoden en eigenschappen voor het toevoegen en verwijderen van panelen, biedt het StatusBar.StatusBarPanelCollection ook methoden om panelen in de verzameling te vinden. Met de Contains methode kunt u bepalen of een paneel lid is van de verzameling. Zodra u weet dat het deelvenster zich in de verzameling bevindt, kunt u de IndexOf methode gebruiken om te bepalen waar het paneel zich in de verzameling bevindt.

Zie ook

• StatusBarPanel