StatusBarPanel Klasse

Definition

public ref class StatusBarPanel : System::ComponentModel::Component, System::ComponentModel::ISupportInitialize

public class StatusBarPanel : System.ComponentModel.Component, System.ComponentModel.ISupportInitialize

type StatusBarPanel = class
    inherit Component
    interface ISupportInitialize

Public Class StatusBarPanel
Inherits Component
Implements ISupportInitialize

Vererbung

Object

MarshalByRefObject

Component

StatusBarPanel

Implementiert

ISupportInitialize

Beispiele

Im folgenden Codebeispiel wird ein StatusBar -Steuerelement auf einem Formular erstellt StatusBarPanel und zwei-Objekte hinzugefügt.The following code example creates a StatusBar control on a form and adds two StatusBarPanel objects. Der erste StatusBarPanel, benannte panel1, zeigt den Status Text für eine Anwendung an.The first StatusBarPanel, named panel1, displays status text for an application. Der zweite StatusBarPanelmit dem panel2Namen zeigt das aktuelle Datum an und StatusBarPanel verwendet ToolTipText die-Eigenschaft der-Klasse, um die aktuelle Uhrzeit anzuzeigen.The second StatusBarPanel, named panel2, displays the current date and uses the ToolTipText property of the StatusBarPanel class to display the current time. Im Beispiel wird die ShowPanels -Eigenschaft verwendet, um sicherzustellen, dass die Panels anstelle eines Standard Bereichs angezeigt werden, Panels und die-Eigenschaft Add wird verwendet, StatusBar.StatusBarPanelCollection um auf die-Methode StatusBarder zuzugreifen, um die Panels hinzuzufügen.The example uses the ShowPanels property to ensure that the panels are displayed instead of a standard panel, and it uses the Panels property to access the Add method of the StatusBar.StatusBarPanelCollection to add the panels to the StatusBar. Im Beispiel werden auch die AutoSizeEigenschaften BorderStyle, ToolTipText, und Text verwendet, um die StatusBarPanel -Objekte zu initialisieren.The example also uses the AutoSize, BorderStyle, ToolTipText, and Text properties to initialize the StatusBarPanel objects. In diesem Beispiel wird davon ausgegangen, dass die im Beispiel definierte Methode definiert und vom Konstruktor einer Formaufgerufen wird.This example assumes that the method defined in the example is defined and called from the constructor of a 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

Ein StatusBarPanel stellt einen einzelnen Bereich in der StatusBar.StatusBarPanelCollection eines StatusBar -Steuer Elements dar.A StatusBarPanel represents an individual panel in the StatusBar.StatusBarPanelCollection of a StatusBar control. Ein StatusBarPanel kann Text und/oder ein Symbol enthalten, das verwendet werden kann, um den Status einer Anwendung widerzuspiegeln.A StatusBarPanel can contain text and/or an icon that can be used to reflect the status of an application. Verwenden Sie StatusBar.Panels StatusBar StatusBarPanel, auf die über die-Eigenschaft eines-Steuer Elements zugegriffen werden kann, um eine Einzelperson abzurufen, hinzuzufügen oder zu entfernen. StatusBar.StatusBarPanelCollectionUse the StatusBar.StatusBarPanelCollection, accessible through the StatusBar.Panels property of a StatusBar control, to retrieve, add, or remove an individual StatusBarPanel.

Stellt Eigenschaften bereit, mit denen Sie das Anzeigeverhalten eines Panels innerhalb eines StatusBar -Steuer Elements ändern können. StatusBarPanelThe StatusBarPanel provides properties that enable you to modify the display behavior of a panel within a StatusBar control. Sie können die Icon -Eigenschaft verwenden, um ein Symbol innerhalb eines Panels anzuzeigen.You can use the Icon property to display an icon within a panel. Diese Eigenschaft kann verwendet werden, um eine grafische Darstellung des Zustands in einer Anwendung bereitzustellen.This property can be used to provide a graphical representation of state in an application. Mithilfe Alignment der-Eigenschaft können Sie angeben, wie Text und/oder ein Symbol innerhalb des Panels ausgerichtet werden.The Alignment property enables you to specify how text and/or an icon is aligned within the panel. Um sicherzustellen, dass der Bereich ordnungsgemäß an den Text des Panels angepasst ist, können Sie die AutoSize -Eigenschaft verwenden, um die Größe des Panels automatisch an den Text des Panels anzupassen oder den verbleibenden Platz StatusBar im Steuerelement auszufüllen.To ensure that your panel is sized properly to fit the text of the panel, you can use the AutoSize property to automatically resize the panel to fit the text of the panel or to fill the remaining space within the StatusBar control. Mit MinWidth der-Eigenschaft können Sie eine minimale Breite für den Bereich angeben, um sicherzustellen, dass er nicht kleiner ist als die Daten, die er anzeigen soll.The MinWidth property enables you to specify a minimum width for the panel to ensure that it does not get smaller than the data it is intended to display.

Das StatusBar -Steuerelement wird normalerweise verwendet, um Hilfe Informationen oder Zustandsinformationen zu Ihrer Anwendung anzuzeigen.The StatusBar control is typically used to display Help information or state information about your application. Häufig ist es wichtig, dass zusätzliche Informationen zu den in einem Panel dargestellten Daten angezeigt werden.Often, it is important to display additional information about data that is presented in a panel. Mit der ToolTipText -Eigenschaft können Sie Informationen anzeigen, wenn sich der Mauszeiger auf einem Panel befindet.You can use the ToolTipText property to display information whenever the mouse pointer rests on a panel.

Obwohl das StatusBar -Steuerelement normalerweise zum Anzeigen von Textinformationen verwendet wird, können Sie auch einen eigenen Anzeigetyp für einen StatusBarPanelbereitstellen.Although the StatusBar control is typically used to display textual information, you can also provide your own type of display to a StatusBarPanel. Mit Style der-Eigenschaft können Sie angeben, StatusBarPanel wie der gezeichnet werden soll.The Style property enables you to specify how the StatusBarPanel will be drawn. Standardmäßig wird die Style -Eigenschaft verwendet, um den Wert Text der-Eigenschaft anzuzeigen (und ein-Symbol, wenn Sie Icon in der-Eigenschaft angegeben ist).By default, the Style property is used to display the value of the Text property (and an icon, if specified in the Icon property). Wenn die-Eigenschaft auf OwnerDrawfestgelegt ist, können Sie eigene Informationen in das Panel zeichnen.If the property is set to OwnerDraw, you can draw your own information into the panel. Mit dieser Funktion können Sie eine Statusanzeige oder ein animiertes Symbol im Panel zeichnen.You can use this feature to draw a progress bar or an animated icon in the panel.

Wenn Sie eine Instanz der StatusBarPanel -Klasse erstellen, werden die Lese-/Schreibeigenschaften auf Anfangswerte festgelegt.When you create an instance of the StatusBarPanel class, the read/write properties are set to initial values. Eine Liste dieser Werte finden Sie unter dem StatusBarPanel -Konstruktor.For a list of these values, see the StatusBarPanel constructor.

Konstruktoren

Eigenschaften

Methoden

Ereignisse

Gilt für:

Siehe auch

• StatusBarPanel