Esta documentación está archivada y no tiene mantenimiento.

StatusBar.StatusBarPanelCollection (Clase)

Representa la colección de paneles de un control StatusBar.

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

public class StatusBarPanelCollection : IList, ICollection, IEnumerable
public class StatusBarPanelCollection implements IList, ICollection, 
	IEnumerable
public class StatusBarPanelCollection implements IList, ICollection, 
	IEnumerable
No aplicable.

La clase StatusBar.StatusBarPanelCollection almacena los paneles que se muestran en StatusBar. Cada objeto de la colección es una instancia de la clase StatusBarPanel, que define los comportamientos y las características de presentación de un panel que se muestra en StatusBar.

Hay varias maneras de agregar paneles a la colección. El método Add permite agregar un solo panel a la colección. Para agregar varios paneles a la colección, hay que crear una matriz de objetos StatusBarPanel y asignarla al método AddRange. Si se desea insertar un panel en una ubicación específica de la colección, utilice el método Insert. Para quitar paneles, se puede utilizar el método Remove o el método RemoveAt si se conoce la posición del panel en la colección. El método Clear permite quitar todos los paneles de la colección en lugar de utilizar el método Remove para quitarlos de uno en uno.

Además de métodos y propiedades para agregar y quitar paneles, StatusBar.StatusBarPanelCollection también proporciona métodos para buscar paneles en la colección. El método Contains permite determinar si un panel es un miembro de la colección. Cuando se tenga conocimiento de que el panel está ubicado en la colección, se podrá utilizar el método IndexOf para determinar dónde está ubicado el panel en la colección.

En el siguiente ejemplo de código, se crea un control StatusBar en un formulario y se agregan dos objetos StatusBarPanel. Uno de los objetos StatusBarPanel, denominado panel1, muestra el texto de estado de una aplicación. El segundo objeto 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 los paneles se muestran en lugar de un panel estándar, y se utiliza la propiedad Panels para obtener acceso al método Add de StatusBar.StatusBarPanelCollection para agregar los paneles a 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.Windows.Forms.StatusBar.StatusBarPanelCollection

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: