StatusBar.StatusBarPanelCollection Clase

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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

public: ref class StatusBar::StatusBarPanelCollection : System::Collections::IList

public class StatusBar.StatusBarPanelCollection : System.Collections.IList

[System.ComponentModel.ListBindable(false)]
public class StatusBar.StatusBarPanelCollection : System.Collections.IList

type StatusBar.StatusBarPanelCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

[<System.ComponentModel.ListBindable(false)>]
type StatusBar.StatusBarPanelCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

Public Class StatusBar.StatusBarPanelCollection
Implements IList

Herencia: Object
StatusBar.StatusBarPanelCollection

Atributos: ListBindableAttribute

Implementaciones: ICollection IEnumerable IList

Ejemplos

En el ejemplo de código siguiente se crea un StatusBar control en un formulario y se agregan dos StatusBarPanel objetos. Uno de los StatusBarPanelelementos , denominados 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 y 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

La StatusBar.StatusBarPanelCollection clase almacena los paneles mostrados en .StatusBar Cada objeto de la colección es una instancia de la StatusBarPanel clase que define las características de visualización y los comportamientos de un panel mostrado en .StatusBar

Hay varias maneras de agregar paneles a la colección. El Add método proporciona la capacidad de agregar un único panel a la colección. Para agregar una serie de paneles a la colección, cree una matriz de StatusBarPanel objetos y asígnela al AddRange método . Si desea insertar un panel en una ubicación específica dentro de la colección, puede usar el Insert método . Para quitar paneles, puede usar el Remove método o el RemoveAt método si sabe dónde se encuentra el panel dentro de la colección. El Clear método permite quitar todos los paneles de la colección en lugar de usar el Remove método para quitar un único panel a la vez.

Además de métodos y propiedades para agregar y quitar paneles, StatusBar.StatusBarPanelCollection también proporciona métodos para buscar paneles dentro de la colección. El Contains método permite determinar si un panel es miembro de la colección. Una vez que sepa que el panel se encuentra dentro de la colección, puede usar el IndexOf método para determinar dónde se encuentra el panel dentro de la colección.

Constructores

StatusBar.StatusBarPanelCollection(StatusBar)

Inicializa una nueva instancia de la clase StatusBar.StatusBarPanelCollection.

Propiedades

Count	Obtiene el número de elementos de la colección.
IsReadOnly	Obtiene un valor que indica si esta colección es de solo lectura.
Item[Int32]	Obtiene o establece la clase StatusBarPanel en el índice especificado.
Item[String]	Obtiene un elemento de la colección que tiene la clave especificada.

Métodos

Add(StatusBarPanel)	Agrega un elemento StatusBarPanel a la colección.
Add(String)	Agrega StatusBarPanel con el texto especificado a la colección.
AddRange(StatusBarPanel[])	Agrega una matriz de objetos StatusBarPanel a la colección.
Clear()	Quita todos los elementos de la colección.
Contains(StatusBarPanel)	Determina si el panel especificado está ubicado en la colección.
ContainsKey(String)	Determina si la colección contiene un StatusBarPanel con la clave especificada.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetEnumerator()	Devuelve un enumerador que se va a utilizar para recorrer en iteración la colección de elementos.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IndexOf(StatusBarPanel)	Devuelve el índice en la colección del panel especificado.
IndexOfKey(String)	Devuelve el índice de la primera aparición de un StatusBarPanel con la clave especificada.
Insert(Int32, StatusBarPanel)	Inserta la clase StatusBarPanel especificada en el índice especificado de la colección.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Remove(StatusBarPanel)	Quita el objeto StatusBarPanel especificado de la colección.
RemoveAt(Int32)	Quita el StatusBarPanel ubicado en el índice especificado de la colección.
RemoveByKey(String)	Quita de la colección el objeto StatusBarPanel con la clave especificada.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

ICollection.CopyTo(Array, Int32)	Copia la StatusBar.StatusBarPanelCollection en una matriz unidimensional compatible, empezando en el índice especificado de la matriz de destino.
ICollection.IsSynchronized	Obtiene un valor que indica si el acceso a la colección está sincronizado (es seguro para la ejecución de subprocesos).
ICollection.SyncRoot	Obtiene un objeto que se puede utilizar para sincronizar el acceso a la colección.
IList.Add(Object)	Esta API admite la infraestructura de producto y no está pensada para usarse directamente en el código. Agrega un elemento StatusBarPanel a la colección.
IList.Contains(Object)	Determina si el panel especificado está ubicado en la colección.
IList.IndexOf(Object)	Devuelve el índice del panel especificado en la colección.
IList.Insert(Int32, Object)	Inserta la clase StatusBarPanel especificada en el índice especificado de la colección.
IList.IsFixedSize	Obtiene un valor que indica si la colección tiene un tamaño fijo.
IList.Item[Int32]	Obtiene o establece el elemento en el índice especificado.
IList.Remove(Object)	Quita el objeto StatusBarPanel especificado de la colección.

Métodos de extensión

Cast<TResult>(IEnumerable)	Convierte los elementos de IEnumerable en el tipo especificado.
OfType<TResult>(IEnumerable)	Filtra los elementos de IEnumerable en función de un tipo especificado.
AsParallel(IEnumerable)	Habilita la paralelización de una consulta.
AsQueryable(IEnumerable)	Convierte una interfaz IEnumerable en IQueryable.

Se aplica a

Consulte también

StatusBarPanel

Compartir vía