StatusBarPanel Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Representa un panel de un control StatusBar.

Esta clase no está disponible en .NET 5 y versiones posteriores. Use el ToolStripStatusLabel control en su lugar, que reemplaza y extiende el StatusBarPanel control.

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

StatusBarPanel()

Inicializa una nueva instancia de la clase StatusBarPanel.

Propiedades

Alignment	Obtiene o establece la alineación del texto y los iconos en el panel de la barra de estado.
AutoSize	Obtiene o establece un valor que indica si el panel de la barra de estado se cambia automáticamente de tamaño.
BorderStyle	Obtiene o establece el estilo del borde del panel de la barra de estado.
CanRaiseEvents	Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component)
Container	Obtiene la interfaz IContainer que contiene la clase Component. (Heredado de Component)
DesignMode	Obtiene un valor que indica si Component está actualmente en modo de diseño. (Heredado de Component)
Events	Obtiene la lista de controladores de eventos asociados a Component. (Heredado de Component)
Icon	Obtiene o establece el icono que se va mostrar en el panel de la barra de estado.
MinWidth	Obtiene o establece el ancho mínimo permitido del panel de la barra de estado en el control StatusBar.
Name	Obtiene o establece el nombre que se va a asignar al objeto StatusBarPanel.
Parent	Obtiene el control StatusBar que hospeda el panel de la barra de estado.
Site	Obtiene o establece ISite de Component. (Heredado de Component)
Style	Obtiene o establece el estilo del panel de la barra de estado.
Tag	Obtiene o establece un objeto que contiene datos sobre el StatusBarPanel.
Text	Obtiene o establece el texto del panel de la barra de estado.
ToolTipText	Obtiene o establece el texto de la información sobre herramientas asociada al panel de la barra de estado.
Width	Obtiene o establece el ancho del panel de la barra de estado en el control StatusBar.

Métodos

BeginInit()	Comienza la inicialización de un panel StatusBarPanel.
CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Dispose()	Libera todos los recursos que usa Component. (Heredado de Component)
Dispose(Boolean)	Libera los recursos no administrados que usa StatusBarPanel y, de forma opcional, libera los recursos administrados.
EndInit()	Finaliza la inicialización de un objeto StatusBarPanel.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetService(Type)	Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Heredado de Component)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
InitializeLifetimeService()	Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
ToString()	Recupera una cadena que contiene información sobre el panel.

Eventos

Disposed

Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose(). (Heredado de Component)

Consulte también

• StatusBarPanel