StatusBar.StatusBarPanelCollection Klasse

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt die Auflistung von Bereichen in einem StatusBar-Steuerelement dar.

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

Vererbung: Object
StatusBar.StatusBarPanelCollection

Attribute: ListBindableAttribute

Implementiert: ICollection IEnumerable IList

Beispiele

Im folgenden Codebeispiel wird ein StatusBar Steuerelement auf einem Formular erstellt und zwei StatusBarPanel Objekte hinzugefügt. Einer der benannten StatusBarPanelpanel1, zeigt Statustext für eine Anwendung an. Der zweite StatusBarPanel, benannte panel2, zeigt das aktuelle Datum an und verwendet die ToolTipText Eigenschaft der StatusBarPanel Klasse, um die aktuelle Uhrzeit anzuzeigen. Im Beispiel wird die ShowPanels Eigenschaft verwendet, um sicherzustellen, dass die Panels anstelle eines Standardbereichs angezeigt werden, und die Eigenschaft wird verwendet und die Panels Eigenschaft verwendet, um auf die Add Methode der StatusBar.StatusBarPanelCollection Zugänge zuzugreifen, um die Panels dem Bereich StatusBarhinzuzufügen. Das Beispiel verwendet auch die Eigenschaften , ToolTipText BorderStyle, um Text die AutoSize StatusBarPanel Objekte zu initialisieren. In diesem Beispiel wird davon ausgegangen, dass die in dem Beispiel definierte Methode definiert und vom Konstruktor einer 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

Hinweise

Die StatusBar.StatusBarPanelCollection Klasse speichert die im Bereich angezeigten Panels.StatusBar Jedes Objekt in der Auflistung ist eine Instanz der StatusBarPanel Klasse, die die Anzeigeeigenschaften und Verhaltensweisen eines In einem StatusBarPanel definiert.

Es gibt eine Reihe von Möglichkeiten zum Hinzufügen von Panels zur Auflistung. Die Add Methode bietet die Möglichkeit, der Auflistung ein einzelnes Panel hinzuzufügen. Um der Auflistung eine Reihe von Panels hinzuzufügen, erstellen Sie ein Array von StatusBarPanel Objekten und weisen sie der AddRange Methode zu. Wenn Sie ein Panel an einem bestimmten Speicherort in der Auflistung einfügen möchten, können Sie die Insert Methode verwenden. Um Panels zu entfernen, können Sie entweder die Remove Methode oder die RemoveAt Methode verwenden, wenn Sie wissen, wo sich das Panel in der Auflistung befindet. Mit Clear der Methode können Sie alle Panels aus der Auflistung entfernen, anstatt die Remove Methode zum Entfernen eines einzelnen Bereichs gleichzeitig zu verwenden.

Zusätzlich zu Methoden und Eigenschaften zum Hinzufügen und Entfernen von Panels bietet die StatusBar.StatusBarPanelCollection Methode auch Methoden zum Suchen von Panels innerhalb der Auflistung. Mit der Contains Methode können Sie bestimmen, ob ein Panel Mitglied der Auflistung ist. Nachdem Sie wissen, dass sich das Panel innerhalb der Auflistung befindet, können Sie die IndexOf Methode verwenden, um zu bestimmen, wo sich das Panel in der Auflistung befindet.

Konstruktoren

StatusBar.StatusBarPanelCollection(StatusBar)

Initialisiert eine neue Instanz der StatusBar.StatusBarPanelCollection-Klasse.

Eigenschaften

Count	Ruft die Anzahl der Elemente in der Auflistung ab.
IsReadOnly	Ruft einen Wert ab, der angibt, ob diese Auflistung schreibgeschützt ist.
Item[Int32]	Ruft die StatusBarPanel-Klasse am angegebenen Index ab oder legt diese fest.
Item[String]	Ruft ein Element mit dem angegebenen Schlüssel aus der Auflistung ab.

Methoden

Add(StatusBarPanel)	Fügt der Auflistung eine StatusBarPanel hinzu.
Add(String)	Fügt der Auflistung ein StatusBarPanel mit dem angegebenen Text hinzu.
AddRange(StatusBarPanel[])	Fügt der Auflistung ein Array von StatusBarPanel-Objekten hinzu.
Clear()	Entfernt alle Elemente aus der Auflistung.
Contains(StatusBarPanel)	Bestimmt, ob der angegebene Bereich in der Auflistung enthalten ist.
ContainsKey(String)	Bestimmt, ob die Auflistung ein StatusBarPanel mit dem angegebenen Schlüssel enthält.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetEnumerator()	Gibt einen Enumerator zurück, mit dem die Elementauflistung durchlaufen werden soll.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IndexOf(StatusBarPanel)	Gibt den Index des angegebenen Bereichs in der Auflistung zurück.
IndexOfKey(String)	Gibt den Index des ersten Vorkommens eines StatusBarPanel mit dem angegebenen Schlüssel zurück.
Insert(Int32, StatusBarPanel)	Fügt die angegebene StatusBarPanel-Klasse am angegebenen Index in die Auflistung ein.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Remove(StatusBarPanel)	Entfernt den angegebenen StatusBarPanel aus der Auflistung.
RemoveAt(Int32)	Entfernt das StatusBarPanel, das sich am angegebenen Index in der Auflistung befindet.
RemoveByKey(String)	Entfernt das StatusBarPanel mit dem angegebenen Schlüssel aus der Auflistung.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

ICollection.CopyTo(Array, Int32)	Kopiert die StatusBar.StatusBarPanelCollection in ein kompatibles eindimensionales Array, beginnend am angegebenen Index des Zielarrays.
ICollection.IsSynchronized	Ruft einen Wert ab, der angibt, ob der Zugriff auf die Auflistung synchronisiert ist (threadsicher).
ICollection.SyncRoot	Ruft ein Objekt ab, mit dem der Zugriff auf die Auflistung synchronisiert werden kann.
IList.Add(Object)	Diese API unterstützt die Produktinfrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code gedacht. Fügt der Auflistung eine StatusBarPanel hinzu.
IList.Contains(Object)	Bestimmt, ob der angegebene Bereich in der Auflistung enthalten ist.
IList.IndexOf(Object)	Gibt den Index des angegebenen Bereichs in der Auflistung zurück.
IList.Insert(Int32, Object)	Fügt die angegebene StatusBarPanel-Klasse am angegebenen Index in die Auflistung ein.
IList.IsFixedSize	Ruft einen Wert ab, der angibt, ob die Auflistung eine feste Größe aufweist.
IList.Item[Int32]	Ruft das Element am angegebenen Index ab oder legt dieses fest.
IList.Remove(Object)	Entfernt den angegebenen StatusBarPanel aus der Auflistung.

Erweiterungsmethoden

Cast<TResult>(IEnumerable)	Wandelt die Elemente eines IEnumerable in den angegebenen Typ um
OfType<TResult>(IEnumerable)	Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs
AsParallel(IEnumerable)	Ermöglicht die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Konvertiert einen IEnumerable in einen IQueryable.

Gilt für

Siehe auch

StatusBarPanel

Teilen über