Exportar (0) Imprimir
Expandir todo

StatusBarPanel (Clase)

Representa un panel de un control StatusBar. 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.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

public class StatusBarPanel : Component, ISupportInitialize
public class StatusBarPanel extends Component implements ISupportInitialize
public class StatusBarPanel extends Component implements ISupportInitialize
No aplicable.

Un objeto StatusBarPanel representa un panel individual de la colección StatusBar.StatusBarPanelCollection de un control StatusBar. Un objeto StatusBarPanel puede contener texto o un icono que se puede utilizar para reflejar el estado de una aplicación. Utilice la colección StatusBar.StatusBarPanelCollection, a la que se puede obtener acceso a través de la propiedad StatusBar.Panels de un control StatusBar, para recuperar, agregar o quitar un objeto StatusBarPanel individual.

El objeto StatusBarPanel proporciona propiedades que permiten modificar el comportamiento de la presentación de un panel en un control StatusBar. Se puede utilizar la propiedad Icon para mostrar un icono en un panel. Esta propiedad se puede utilizar para proporcionar una representación gráfica del estado en una aplicación. La propiedad Alignment permite especificar cómo se alineará el texto o un icono en el panel. Para asegurarse de que el tamaño del panel se ajusta correctamente al texto, se puede utilizar la propiedad AutoSize para que el tamaño del panel se ajuste automáticamente al texto del panel o para rellenar el espacio restante del control StatusBar. La propiedad MinWidth permite especificar el ancho mínimo del panel para garantizar que no sea más pequeño que los datos que va a mostrar.

Normalmente, el control StatusBar se utiliza para mostrar información de ayuda o información sobre el estado de la aplicación. A menudo, es importante mostrar información adicional sobre los datos que se presentan en un panel. Puede utilizar la propiedad ToolTipText para mostrar información siempre que el puntero del mouse (ratón) se sitúe sobre un panel.

Aunque el control StatusBar se utiliza normalmente para mostrar información de texto, también puede proporcionar su propio tipo de presentación a un StatusBarPanel. La propiedad Style permite especificar cómo se dibujará el StatusBarPanel. De manera predeterminada, la propiedad Style se utiliza para mostrar el valor de la propiedad Text (y un icono, si así se especificó en la propiedad Icon). Si la propiedad se establece en OwnerDraw, puede dibujar su propia información en el panel. Esta característica se puede utilizar para dibujar una barra de progreso o un icono animado en el panel.

Cuando se crea una instancia de la clase StatusBarPanel, se establecen las propiedades de lectura y escritura en sus valores iniciales. Para obtener una lista de estos valores, vea el constructor StatusBarPanel.

En el siguiente ejemplo de código, se crea un control StatusBar en un formulario y se agregan dos controles StatusBarPanel. El primer control StatusBarPanel, denominado panel1, muestra el texto del estado de una aplicación. El segundo control StatusBarPanel, denominado panel2, muestra la fecha actual y utiliza la propiedad ToolTipText de la clase StatusBarPanel para mostrar la hora actual. En el ejemplo, se utiliza la propiedad ShowPanels para garantizar que se muestran los paneles en lugar de un panel estándar, y la propiedad Panels para tener acceso al método Add de StatusBar.StatusBarPanelCollection para agregar los paneles al control StatusBar. En el ejemplo, se utilizan también las propiedades AutoSize, BorderStyle, ToolTipText y Text para inicializar los objetos StatusBarPanel. En este ejemplo, se asume que el método definido en el ejemplo se define y se llama desde un constructor de un Form.

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 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.set_BorderStyle(StatusBarPanelBorderStyle.Sunken);

    // Initialize the text of the panel.
    panel1.set_Text("Ready...");

    // Set the AutoSize property to use all remaining space on the StatusBar.
    panel1.set_AutoSize(StatusBarPanelAutoSize.Spring);

    // Display the second panel with a raised border style.
    panel2.set_BorderStyle(StatusBarPanelBorderStyle.Raised);

    // Create ToolTip text that displays the time the application was started.
    panel2.set_ToolTipText("Started: " + System.DateTime.get_Now().ToShortTimeString());
    
// Set the text of the panel to the current date.
    panel2.set_Text(System.DateTime.get_Today().ToLongDateString());
    
// Set the AutoSize property to size the panel to the size of the 
    // contents.
    panel2.set_AutoSize(StatusBarPanelAutoSize.Contents);
    // Display panels in the StatusBar control.
    statusBar1.set_ShowPanels(true);
    // Add both panels to the StatusBarPanelCollection of the StatusBar.    
    statusBar1.get_Panels().Add(panel1);
    statusBar1.get_Panels().Add(panel2);
    // Add the StatusBar to the form.
    this.get_Controls().Add(statusBar1);
} //CreateMyStatusBar

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
      System.Windows.Forms.StatusBarPanel

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0
Mostrar:
© 2014 Microsoft