StatusBarPanel Clase

Definición

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

Herencia

Object

MarshalByRefObject

Component

StatusBarPanel

Implementaciones

ISupportInitialize

Ejemplos

En el ejemplo de código siguiente se crea un StatusBar control en un formulario y se agregan dos StatusBarPanel objetos. El primer StatusBarPanel, denominado panel1, muestra el texto de estado de una aplicación. El segundo StatusBarPanel, denominado panel2, muestra la fecha actual y usa la ToolTipText propiedad de la StatusBarPanel clase para mostrar la hora actual. En el ejemplo se usa la ShowPanels propiedad para asegurarse de que los paneles se muestran en lugar de un panel estándar y usa la Panels propiedad para tener acceso al Add método de StatusBar.StatusBarPanelCollection para agregar los paneles a StatusBar. En el ejemplo también se usan las AutoSizepropiedades , BorderStyle, ToolTipTexty Text para inicializar los StatusBarPanel objetos . En este ejemplo se supone que el método definido en el ejemplo se define y se llama desde el constructor de .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

Comentarios

Esta clase no está disponible en .NET 5 y versiones posteriores. En su lugar, use el ToolStripStatusLabel control .

StatusBarPanel Un objeto representa un panel individual en el StatusBar.StatusBarPanelCollection de un StatusBar control . StatusBarPanel Puede contener texto o un icono que se puede usar para reflejar el estado de una aplicación. Use , StatusBar.StatusBarPanelCollectionaccesible a través de la StatusBar.Panels propiedad de un StatusBar control, para recuperar, agregar o quitar un elemento individual StatusBarPanel.

StatusBarPanel proporciona propiedades que permiten modificar el comportamiento de visualización de un panel dentro de un StatusBar control. Puede usar la Icon propiedad para mostrar un icono dentro de un panel. Esta propiedad se puede usar para proporcionar una representación gráfica del estado en una aplicación. La Alignment propiedad permite especificar cómo se alinea el texto o un icono en el panel. Para asegurarse de que el panel tiene el tamaño adecuado para ajustarse al texto del panel, puede usar la propiedad para cambiar automáticamente el AutoSize tamaño del panel para ajustar el texto del panel o rellenar el espacio restante dentro del StatusBar control. La MinWidth propiedad le permite especificar un ancho mínimo para el panel para asegurarse de que no obtiene un tamaño menor que los datos que pretende mostrar.

El StatusBar control se usa normalmente para mostrar información de ayuda o información de estado sobre la aplicación. A menudo, es importante mostrar información adicional sobre los datos que se presentan en un panel. Puede usar la ToolTipText propiedad para mostrar información cada vez que el puntero del mouse descansa en un panel.

Aunque el StatusBar control se usa normalmente para mostrar información textual, también puede proporcionar su propio tipo de presentación a .StatusBarPanel La Style propiedad permite especificar cómo se dibujará.StatusBarPanel De forma predeterminada, la Style propiedad se usa para mostrar el valor de la Text propiedad (y un icono, si se especifica en la Icon propiedad ). Si la propiedad está establecida OwnerDrawen , puede dibujar su propia información en el panel. Puede usar esta característica para dibujar una barra de progreso o un icono animado en el panel.

Al crear una instancia de la StatusBarPanel clase , las propiedades de lectura y escritura se establecen en valores iniciales. Para obtener una lista de estos valores, consulte el StatusBarPanel constructor .

Constructores

Propiedades

Métodos

Eventos

Se aplica a

Consulte también

• StatusBarPanel