StatusBar.StatusBarPanelCollection-Klasse

Stellt die Auflistung der Bereiche in einem StatusBar-Steuerelement dar.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Class StatusBarPanelCollection
    Implements IList, ICollection, IEnumerable
'Usage
Dim instance As StatusBarPanelCollection

public class StatusBarPanelCollection : IList, ICollection, IEnumerable

public ref class StatusBarPanelCollection : IList, ICollection, IEnumerable

public class StatusBarPanelCollection implements IList, ICollection, 
    IEnumerable

public class StatusBarPanelCollection implements IList, ICollection, 
    IEnumerable

Hinweise

Die StatusBar.StatusBarPanelCollection-Klasse enthält die in der StatusBar angezeigten Bereiche. Jedes Objekt in der Auflistung ist eine Instanz der StatusBarPanel-Klasse, die die Anzeigemerkmale und das Verhalten eines in einer StatusBar angezeigten Bereichs definiert.

Es gibt mehrere Möglichkeiten, der Auflistung Bereiche hinzuzufügen: Mit der Add-Methode kann der Auflistung ein einzelner Bereich hinzugefügt werden. Um der Auflistung mehrere Bereiche hinzuzufügen, erstellen Sie ein Array von StatusBarPanel-Objekten und weisen dieses der AddRange-Methode zu. Wenn Sie einen Bereich an einer bestimmten Position in der Auflistung einfügen möchten, können Sie die Insert-Methode verwenden. Zum Entfernen von Bereichen können Sie entweder die Remove-Methode verwenden oder die RemoveAt-Methode, wenn Sie wissen, wo sich der entsprechende Bereich in der Auflistung befindet. Mit der Clear-Methode können Sie alle Bereiche gleichzeitig aus der Auflistung entfernen, anstatt Bereiche mit der Remove-Methode einzeln zu entfernen.

Zusätzlich zu den Methoden und Eigenschaften zum Hinzufügen und Entfernen von Bereichen enthält die StatusBar.StatusBarPanelCollection auch Methoden zum Suchen von Bereichen in der Auflistung. Mit der Contains-Methode können Sie bestimmen, ob ein Bereich ein Member der Auflistung ist. Sobald Sie festgestellt haben, dass der Bereich in der Auflistung vorhanden ist, können Sie die Position des Bereichs in der Auflistung mit der IndexOf-Methode ermitteln.

Beispiel

Im folgenden Codebeispiel werden ein StatusBar-Steuerelement in einem Formular erstellt und zwei StatusBarPanel-Objekte hinzugefügt. Das erste StatusBarPanel (panel1) zeigt Statustext für eine Anwendung an. Das zweite StatusBarPanel (panel2) zeigt das aktuelle Datum und mithilfe der ToolTipText-Eigenschaft der StatusBarPanel-Klasse die aktuelle Uhrzeit an. Im Beispiel wird die ShowPanels-Eigenschaft verwendet, um sicherzustellen, dass die Bereiche anstelle eines Standardbereichs angezeigt werden, und die Panels-Eigenschaft wird verwendet, um auf die Add-Methode der StatusBar.StatusBarPanelCollection zuzugreifen und so die Bereiche der StatusBar hinzuzufügen. Außerdem werden in dem Beispiel die AutoSize-Eigenschaft, die BorderStyle-Eigenschaft, die ToolTipText-Eigenschaft und die Text-Eigenschaft zum Initialisieren der StatusBarPanel-Objekte verwendet. In diesem Beispiel wird davon ausgegangen, dass die im Beispiel verwendete Methode im Konstruktor eines Form definiert und aufgerufen wird.

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

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:
   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.set_BorderStyle(StatusBarPanelBorderStyle.Sunken);

    // Initialize the text of the panel.
    panel1.set_Text("Ready...");

    // Set the AutoSize property to use all remaining space on the StatusBar.
    panel1.set_AutoSize(StatusBarPanelAutoSize.Spring);

    // Display the second panel with a raised border style.
    panel2.set_BorderStyle(StatusBarPanelBorderStyle.Raised);

    // Create ToolTip text that displays the time the application was started.
    panel2.set_ToolTipText("Started: " + System.DateTime.get_Now().ToShortTimeString());
    
// Set the text of the panel to the current date.
    panel2.set_Text(System.DateTime.get_Today().ToLongDateString());
    
// Set the AutoSize property to size the panel to the size of the 
    // contents.
    panel2.set_AutoSize(StatusBarPanelAutoSize.Contents);
    // Display panels in the StatusBar control.
    statusBar1.set_ShowPanels(true);
    // Add both panels to the StatusBarPanelCollection of the StatusBar.    
    statusBar1.get_Panels().Add(panel1);
    statusBar1.get_Panels().Add(panel2);
    // Add the StatusBar to the form.
    this.get_Controls().Add(statusBar1);
} //CreateMyStatusBar

Vererbungshierarchie

System.Object
  System.Windows.Forms.StatusBar.StatusBarPanelCollection

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

StatusBar.StatusBarPanelCollection-Member
System.Windows.Forms-Namespace
StatusBarPanel