StatusBarPanel Clase

Definición

Representa un panel de un control StatusBar.Represents a panel in a StatusBar control. Aunque el control StatusStrip reemplaza al control StatusBar de las versiones anteriores y su funcionalidad es mayor, el control StatusBar se ha mantenido para preservar la compatibilidad con las versiones anteriores y para que pueda utilizarse en el futuro, si así se decide.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
Herencia
Implementaciones

Ejemplos

En el ejemplo de código siguiente StatusBar se crea un control en un formulario StatusBarPanel y se agregan dos objetos.The following code example creates a StatusBar control on a form and adds two StatusBarPanel objects. La primera StatusBarPanel, denominada panel1, muestra el texto de estado de una aplicación.The first StatusBarPanel, named panel1, displays status text for an application. En el StatusBarPanelsegundo, panel2denominado, se muestra la fecha actual y ToolTipText se usa la StatusBarPanel propiedad de la clase para mostrar la hora actual.The second StatusBarPanel, named panel2, displays the current date and uses the ToolTipText property of the StatusBarPanel class to display the current time. En el ejemplo se ShowPanels usa la propiedad para asegurarse de que los paneles se muestran en lugar de un panel estándar, y Panels usa la propiedad para Add StatusBar.StatusBarPanelCollection tener acceso al método StatusBarde para agregar los paneles a.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. En el ejemplo también se AutoSizeusan BorderStylelas ToolTipTextpropiedades, Text , y para inicializar los StatusBarPanel objetos.The example also uses the AutoSize, BorderStyle, ToolTipText, and Text properties to initialize the StatusBarPanel objects. En este ejemplo se da por supuesto que el método definido en el ejemplo se define y se llama Formdesde el constructor de un.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

Comentarios

Un StatusBarPanel representa un panel individual en el StatusBar.StatusBarPanelCollection de un StatusBar control.A StatusBarPanel represents an individual panel in the StatusBar.StatusBarPanelCollection of a StatusBar control. Un StatusBarPanel puede contener texto o un icono que se puede usar para reflejar el estado de una aplicación.A StatusBarPanel can contain text and/or an icon that can be used to reflect the status of an application. Use, accesible a través de StatusBar.Panels la propiedad de StatusBar un control, para recuperar, agregar o quitar un individuo StatusBarPanel. StatusBar.StatusBarPanelCollectionUse the StatusBar.StatusBarPanelCollection, accessible through the StatusBar.Panels property of a StatusBar control, to retrieve, add, or remove an individual StatusBarPanel.

Proporciona propiedades que permiten modificar el comportamiento de presentación de un panel dentro de un StatusBar control. StatusBarPanelThe StatusBarPanel provides properties that enable you to modify the display behavior of a panel within a StatusBar control. Puede usar la Icon propiedad para mostrar un icono dentro de un panel.You can use the Icon property to display an icon within a panel. Esta propiedad se puede utilizar para proporcionar una representación gráfica del estado en una aplicación.This property can be used to provide a graphical representation of state in an application. La Alignment propiedad permite especificar cómo se alinea el texto y/o un icono dentro del panel.The Alignment property enables you to specify how text and/or an icon is aligned within the panel. Para asegurarse de que el tamaño del panel sea correcto para ajustarse al texto del panel, puede usar AutoSize la propiedad para cambiar automáticamente el tamaño del panel para ajustarse al texto del panel o para rellenar el StatusBar espacio restante en el control.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. La MinWidth propiedad permite especificar un ancho mínimo para el panel con el fin de asegurarse de que no es más pequeño que los datos que se van a mostrar.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.

Normalmente StatusBar , el control se usa para mostrar información de ayuda o información de estado sobre la aplicación.The StatusBar control is typically used to display Help information or state information about your application. A menudo, es importante Mostrar información adicional sobre los datos que se presentan en un panel.Often, it is important to display additional information about data that is presented in a panel. Puede usar la ToolTipText propiedad para mostrar información cada vez que el puntero del mouse se sitúe sobre un panel.You can use the ToolTipText property to display information whenever the mouse pointer rests on a panel.

Aunque el StatusBar control se usa normalmente para mostrar información de texto, también puede proporcionar su propio tipo de presentación StatusBarPanela.Although the StatusBar control is typically used to display textual information, you can also provide your own type of display to a StatusBarPanel. La Style propiedad le permite especificar cómo se dibujará el StatusBarPanel .The Style property enables you to specify how the StatusBarPanel will be drawn. De forma predeterminada, Style la propiedad se usa para mostrar el valor de Text la propiedad (y un icono, si se especifica Icon en la propiedad).By default, the Style property is used to display the value of the Text property (and an icon, if specified in the Icon property). Si la propiedad está establecida en OwnerDraw, puede dibujar su propia información en el panel.If the property is set to OwnerDraw, you can draw your own information into the panel. Puede usar esta característica para dibujar una barra de progreso o un Icono animado en el panel.You can use this feature to draw a progress bar or an animated icon in the panel.

Cuando se crea una instancia de la StatusBarPanel clase, las propiedades de lectura y escritura se establecen en valores iniciales.When you create an instance of the StatusBarPanel class, the read/write properties are set to initial values. Para obtener una lista de estos valores, vea StatusBarPanel el constructor.For a list of these values, see the StatusBarPanel constructor.

Constructores

StatusBarPanel()

Inicializa una nueva instancia de la clase StatusBarPanel.Initializes a new instance of the StatusBarPanel class.

Propiedades

Alignment

Obtiene o establece la alineación del texto y los iconos en el panel de la barra de estado.Gets or sets the alignment of text and icons within the status bar panel.

AutoSize

Obtiene o establece un valor que indica si el panel de la barra de estado se cambia automáticamente de tamaño.Gets or sets a value indicating whether the status bar panel is automatically resized.

BorderStyle

Obtiene o establece el estilo del borde del panel de la barra de estado.Gets or sets the border style of the status bar panel.

CanRaiseEvents

Obtiene un valor que indica si el componente puede generar un evento.Gets a value indicating whether the component can raise an event.

(Heredado de Component)
Container

Obtiene IContainer que contiene Component.Gets the IContainer that contains the Component.

(Heredado de Component)
DesignMode

Obtiene un valor que indica si Component está actualmente en modo de diseño.Gets a value that indicates whether the Component is currently in design mode.

(Heredado de Component)
Events

Obtiene la lista de controladores de eventos asociados a Component.Gets the list of event handlers that are attached to this Component.

(Heredado de Component)
Icon

Obtiene o establece el icono que se va mostrar en el panel de la barra de estado.Gets or sets the icon to display within the status bar panel.

MinWidth

Obtiene o establece el ancho mínimo permitido del panel de la barra de estado en el control StatusBar.Gets or sets the minimum allowed width of the status bar panel within the StatusBar control.

Name

Obtiene o establece el nombre que se va a asignar al objeto StatusBarPanel.Gets or sets the name to apply to the StatusBarPanel.

Parent

Obtiene el control StatusBar que hospeda el panel de la barra de estado.Gets the StatusBar control that hosts the status bar panel.

Site

Obtiene o establece el ISite de Component.Gets or sets the ISite of the Component.

(Heredado de Component)
Style

Obtiene o establece el estilo del panel de la barra de estado.Gets or sets the style of the status bar panel.

Tag

Obtiene o establece un objeto que contiene datos sobre el control StatusBarPanel.Gets or sets an object that contains data about the StatusBarPanel.

Text

Obtiene o establece el texto del panel de la barra de estado.Gets or sets the text of the status bar panel.

ToolTipText

Obtiene o establece el texto de la información sobre herramientas asociada al panel de la barra de estado.Gets or sets ToolTip text associated with the status bar panel.

Width

Obtiene o establece el ancho del panel de la barra de estado en el control StatusBar.Gets or sets the width of the status bar panel within the StatusBar control.

Métodos

BeginInit()

Comienza la inicialización de un panel StatusBarPanel.Begins the initialization of a 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Heredado de MarshalByRefObject)
Dispose()

Libera todos los recursos que usa Component.Releases all resources used by the Component.

(Heredado de Component)
Dispose(Boolean)

Libera los recursos no administrados que usa StatusBarPanel y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the StatusBarPanel and optionally releases the managed resources.

EndInit()

Finaliza la inicialización de un objeto StatusBarPanel.Ends the initialization of a StatusBarPanel.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
GetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.Returns an object that represents a service provided by the Component or by its Container.

(Heredado de Component)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Heredado de MarshalByRefObject)
ToString()

Recupera una cadena que contiene información sobre el panel.Retrieves a string that contains information about the panel.

Eventos

Disposed

Se produce cuando el componente se elimina mediante una llamada al método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Heredado de Component)

Se aplica a

Consulte también: