StatusBarPanel-Klasse

Artikel
08/20/2007

Stellt einen Bereich in einem StatusBar-Steuerelement dar. Das StatusStrip-Steuerelement ersetzt Funktionen von früheren Versionen des StatusBar-Steuerelements und erweitert es um neue Funktionen. Sie können das StatusBar jedoch aus Gründen der Abwärtskompatibilität und zur künftigen Verwendung beibehalten.

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

Syntax

'Declaration
Public Class StatusBarPanel
    Inherits Component
    Implements ISupportInitialize
'Usage
Dim instance As StatusBarPanel

public class StatusBarPanel : Component, ISupportInitialize

public ref class StatusBarPanel : public Component, ISupportInitialize

public class StatusBarPanel extends Component implements ISupportInitialize

public class StatusBarPanel extends Component implements ISupportInitialize

Hinweise

Ein StatusBarPanel stellt einen einzelnen Bereich in der StatusBar.StatusBarPanelCollection eines StatusBar-Steuerelements dar. Ein StatusBarPanel kann Text und/oder ein Symbol enthalten, mit dem der Status einer Anwendung angezeigt werden kann. Mit der StatusBar.StatusBarPanelCollection, auf die über die StatusBar.Panels-Eigenschaft eines StatusBar-Steuerelements zugegriffen werden kann, können Sie ein einzelnes StatusBarPanel abrufen, hinzufügen oder entfernen.

Das StatusBarPanel stellt eine Reihe von Eigenschaften bereit, mit deren Hilfe Sie das Anzeigeverhalten eines Bereichs innerhalb eines StatusBar-Steuerelements ändern können. Sie können die Icon-Eigenschaft verwenden, um ein Symbol innerhalb eines Bereichs anzuzeigen. Mit dieser Eigenschaft kann ein Zustand durch eine grafische Darstellung in einer Anwendung verdeutlicht werden. Mithilfe der Alignment-Eigenschaft können Sie angeben, wie ein Text bzw. ein Symbol in dem Bereich ausgerichtet werden soll. Um die Größe des Bereichs so zu wählen, dass der darin aufzunehmende Text hineinpasst, können Sie mithilfe der AutoSize-Eigenschaft die Größe des Bereichs automatisch an den Text anpassen oder den verbleibenden Platz innerhalb des StatusBar-Steuerelements ausfüllen lassen. Mit der MinWidth-Eigenschaft können Sie eine minimale Breite für den Bereich angeben und so sicherstellen, dass er in keinem Fall kleiner ist als die anzuzeigenden Daten.

Das StatusBar-Steuerelement wird i. d. R. zum Anzeigen von Hilfeinformationen oder Zustandsinformationen über die Anwendung verwendet. Oft ist es wichtig, zusätzliche Informationen über die in einem Bereich dargestellten Daten anzuzeigen. Sie können mithilfe der ToolTipText-Eigenschaft immer dann Information anzeigen, wenn sich der Mauszeiger in einem Bereich befindet.

Das StatusBar-Steuerelement wird zwar i. d. R. zum Anzeigen von Textinformationen verwendet, Sie können jedoch auch eine eigene Anzeigeart für ein StatusBarPanel bereitstellen. Mithilfe der Style-Eigenschaft können Sie angeben, wie das StatusBarPanel gezeichnet wird. Standardmäßig wird die Style-Eigenschaft zum Anzeigen des Werts der Text-Eigenschaft verwendet (und ein Symbol, sofern dies in der Icon-Eigenschaft angegeben ist). Wenn die Eigenschaft auf OwnerDraw festgelegt ist, können Sie eigene Informationen in dem Bereich zeichnen. Mithilfe dieses Features können Sie eine Statusanzeige oder ein animiertes Symbol in den Bereich zeichnen.

Wenn Sie eine Instanz der StatusBarPanel-Klasse erstellen, werden die Lese-/Schreibeigenschaften auf die Anfangswerte festgelegt. Eine Liste dieser Werte finden Sie unter dem StatusBarPanel-Konstruktor.

Beispiel

Im folgenden Codebeispiel werden ein StatusBar-Steuerelement in einem Formular erstellt und zwei StatusBarPanel-Objekte hinzugefügt. Das erste StatusBarPanel (panel1) zeigt den 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 von StatusBar.StatusBarPanelCollection zuzugreifen und so die Bereiche zu StatusBar hinzuzufügen. Außerdem werden in dem Beispiel die Eigenschaften AutoSize, BorderStyle, ToolTipText und Text 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.MarshalByRefObject
     System.ComponentModel.Component
      System.Windows.Forms.StatusBarPanel

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.

Freigeben über

StatusBarPanel-Klasse

Syntax

Hinweise

Beispiel

Vererbungshierarchie

Threadsicherheit

Plattformen

Versionsinformationen

.NET Framework

Siehe auch

Referenz

Zusätzliche Ressourcen