StatusBarPanel Klasse

Definition

Stellt ein Panel in einem StatusBar-Steuerelement dar.Represents a panel in a StatusBar control. 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.Although the StatusStrip control replaces and adds functionality to the StatusBar control of previous versions, StatusBar is retained for both backward compatibility and future use if you choose.

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
Implementiert

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

StatusBarPanel()

Initialisiert eine neue Instanz der StatusBarPanel-Klasse.Initializes a new instance of the StatusBarPanel class.

Eigenschaften

Alignment

Ruft die Ausrichtung von Text und Symbole innerhalb des Statusleistenbereichs ab oder legt diese fest.Gets or sets the alignment of text and icons within the status bar panel.

AutoSize

Ruft einen Wert ab, der angibt, ob die Größe des Statusleistenbereichs automatisch angepasst wird, oder legt diesen Wert fest.Gets or sets a value indicating whether the status bar panel is automatically resized.

BorderStyle

Ruft die Rahmenart des Statusleistenbereichs ab oder legt diese fest.Gets or sets the border style of the status bar panel.

CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.Gets a value indicating whether the component can raise an event.

(Geerbt von Component)
Container

Ruft den IContainer ab, der die Component enthält.Gets the IContainer that contains the Component.

(Geerbt von Component)
DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.Gets a value that indicates whether the Component is currently in design mode.

(Geerbt von Component)
Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.Gets the list of event handlers that are attached to this Component.

(Geerbt von Component)
Icon

Ruft das im Statusleistenbereich anzuzeigende Symbol ab oder legt dieses fest.Gets or sets the icon to display within the status bar panel.

MinWidth

Ruft die minimal zulässige Breite des Statusleistenbereichs innerhalb des StatusBar-Steuerelements ab oder legt diese fest.Gets or sets the minimum allowed width of the status bar panel within the StatusBar control.

Name

Ruft den auf das StatusBarPanel anzuwendenden Namen ab oder legt diesen fest.Gets or sets the name to apply to the StatusBarPanel.

Parent

Ruft das StatusBar-Steuerelement ab, das als Host für den Statusleistenbereich fungiert.Gets the StatusBar control that hosts the status bar panel.

Site

Ruft den ISite von Component ab oder legt ihn fest.Gets or sets the ISite of the Component.

(Geerbt von Component)
Style

Ruft den Stil des Statusleistenbereichs ab oder legt diesen fest.Gets or sets the style of the status bar panel.

Tag

Ruft ein Objekt ab, das Daten über das StatusBarPanel enthält, oder legt dieses fest.Gets or sets an object that contains data about the StatusBarPanel.

Text

Ruft den Text des Statusleistenbereichs ab oder legt diesen fest.Gets or sets the text of the status bar panel.

ToolTipText

Ruft den QuickInfo-Text ab, der dem Statusleistenbereich zugeordnet ist, oder legt diesen fest.Gets or sets ToolTip text associated with the status bar panel.

Width

Ruft die Breite des Statusleistenbereichs innerhalb des StatusBar-Steuerelements ab oder legt diese fest.Gets or sets the width of the status bar panel within the StatusBar control.

Methoden

BeginInit()

Startet die Initialisierung eines StatusBarPanel.Begins the initialization of a StatusBarPanel.

CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Geerbt von MarshalByRefObject)
Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.Releases all resources used by the Component.

(Geerbt von Component)
Dispose(Boolean)

Gibt die von StatusBarPanel verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the StatusBarPanel and optionally releases the managed resources.

EndInit()

Beendet die Initialisierung eines StatusBarPanel.Ends the initialization of a StatusBarPanel.

Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.Returns an object that represents a service provided by the Component or by its Container.

(Geerbt von Component)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Geerbt von MarshalByRefObject)
ToString()

Ruft eine Zeichenfolge ab, die Informationen über den Bereich enthält.Retrieves a string that contains information about the panel.

Ereignisse

Disposed

Tritt ein, wenn die Komponente durch einen Aufruf der Dispose()-Methode freigegeben wird.Occurs when the component is disposed by a call to the Dispose() method.

(Geerbt von Component)

Gilt für:

Siehe auch