StatusBar.StatusBarPanelCollection Clase

Definición

Representa la colección de paneles dentro de un control StatusBar.Represents the collection of panels in a StatusBar control.

public: ref 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
Public Class StatusBar.StatusBarPanelCollection
Implements IList
Herencia
StatusBar.StatusBarPanelCollection
Atributos
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. Uno de los StatusBarPanel, denominado panel1, muestra el texto de estado de una aplicación.One of the 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 utiliza Panels y la propiedad para Add StatusBar.StatusBarPanelCollection tener acceso al método StatusBarde para agregar los paneles al.The example uses the ShowPanels property to ensure that the panels are displayed instead of a standard panel, and it uses and 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

La StatusBar.StatusBarPanelCollection clase almacena los paneles que se muestran StatusBaren el.The StatusBar.StatusBarPanelCollection class stores the panels displayed in the StatusBar. Cada objeto de la colección es una instancia de la StatusBarPanel clase que define las características de presentación y los comportamientos de un panel mostrado StatusBaren.Each object in the collection is an instance of the StatusBarPanel class which defines the display characteristics and behaviors of a panel displayed in a StatusBar.

Hay varias maneras de agregar paneles a la colección.There are a number of ways to add panels to the collection. El Add método proporciona la capacidad de agregar un solo panel a la colección.The Add method provides the ability to add a single panel to the collection. Para agregar un número de paneles a la colección, cree una matriz de StatusBarPanel objetos y asígnela AddRange al método.To add a number of panels to the collection, you create an array of StatusBarPanel objects and assign it to the AddRange method. Si desea insertar un panel en una ubicación específica dentro de la colección, puede utilizar el Insert método.If you want to insert a panel at a specific location within the collection, you can use the Insert method. Para quitar los 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.To remove panels, you can use either the Remove method or the RemoveAt method if you know where the panel is located within the collection. El Clear método permite quitar todos los paneles de la colección en lugar de utilizar el Remove método para quitar un solo panel cada vez.The Clear method enables you to remove all panels from the collection instead of using the Remove method to remove a single panel at a time.

Además de los métodos y las propiedades para agregar y quitar paneles, StatusBar.StatusBarPanelCollection también proporciona métodos para buscar paneles dentro de la colección.In addition to methods and properties for adding and removing panels, the StatusBar.StatusBarPanelCollection also provides methods to find panels within the collection. El Contains método le permite determinar si un panel es un miembro de la colección.The Contains method enables you to determine whether a panel is a member of the collection. Una vez que sepa que el panel se encuentra en la colección, puede utilizar el IndexOf método para determinar dónde se encuentra el panel dentro de la colección.Once you know that the panel is located within the collection, you can use the IndexOf method to determine where the panel is located within the collection.

Constructores

StatusBar.StatusBarPanelCollection(StatusBar)

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

Propiedades

Count

Obtiene el número de elementos de la colección.Gets the number of items in the collection.

IsReadOnly

Obtiene un valor que indica si esta colección es de solo lectura.Gets a value indicating whether this collection is read-only.

Item[Int32]

Obtiene o establece la clase StatusBarPanel en el índice especificado.Gets or sets the StatusBarPanel at the specified index.

Item[String]

Obtiene un elemento de la colección que tiene la clave especificada.Gets an item with the specified key from the collection.

Métodos

Add(StatusBarPanel)

Agrega un elemento StatusBarPanel a la colección.Adds a StatusBarPanel to the collection.

Add(String)

Agrega StatusBarPanel con el texto especificado a la colección.Adds a StatusBarPanel with the specified text to the collection.

AddRange(StatusBarPanel[])

Agrega una matriz de objetos StatusBarPanel a la colección.Adds an array of StatusBarPanel objects to the collection.

Clear()

Quita todos los elementos de la colección.Removes all items from the collection.

Contains(StatusBarPanel)

Determina si el panel especificado está ubicado en la colección.Determines whether the specified panel is located within the collection.

ContainsKey(String)

Determina si la colección contiene un StatusBarPanel con la clave especificada.Determines whether the collection contains a StatusBarPanel with the specified key.

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)
GetEnumerator()

Devuelve un enumerador que se va a utilizar para recorrer en iteración la colección de elementos.Returns an enumerator to use to iterate through the item collection.

GetHashCode()

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

(Heredado de Object)
GetType()

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

(Heredado de Object)
IndexOf(StatusBarPanel)

Devuelve el índice en la colección del panel especificado.Returns the index within the collection of the specified panel.

IndexOfKey(String)

Devuelve el índice de la primera aparición de un StatusBarPanel con la clave especificada.Returns the index of the first occurrence of a StatusBarPanel with the specified key.

Insert(Int32, StatusBarPanel)

Inserta la clase StatusBarPanel especificada en el índice especificado de la colección.Inserts the specified StatusBarPanel into the collection at the specified index.

MemberwiseClone()

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

(Heredado de Object)
Remove(StatusBarPanel)

Quita el objeto StatusBarPanel especificado de la colección.Removes the specified StatusBarPanel from the collection.

RemoveAt(Int32)

Quita el StatusBarPanel ubicado en el índice especificado de la colección.Removes the StatusBarPanel located at the specified index within the collection.

RemoveByKey(String)

Quita de la colección el objeto StatusBarPanel con la clave especificada.Removes the StatusBarPanel with the specified key from the collection.

ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(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.Copies the StatusBar.StatusBarPanelCollection to a compatible one-dimensional array, starting at the specified index of the target array.

ICollection.IsSynchronized

Obtiene un valor que indica si el acceso a la colección está sincronizado (es seguro para la ejecución de subprocesos).Gets a value indicating whether access to the collection is synchronized (thread safe).

ICollection.SyncRoot

Obtiene un objeto que se puede utilizar para sincronizar el acceso a la colección.Gets an object that can be used to synchronize access to the collection.

IList.Add(Object)

Agrega un elemento StatusBarPanel a la colección.Adds a StatusBarPanel to the collection.

IList.Contains(Object)

Determina si el panel especificado está ubicado en la colección.Determines whether the specified panel is located within the collection.

IList.IndexOf(Object)

Devuelve el índice del panel especificado en la colección.Returns the index of the specified panel within the collection.

IList.Insert(Int32, Object)

Inserta la clase StatusBarPanel especificada en el índice especificado de la colección.Inserts the specified StatusBarPanel into the collection at the specified index.

IList.IsFixedSize

Obtiene un valor que indica si la colección tiene un tamaño fijo.Gets a value indicating whether the collection has a fixed size.

IList.Item[Int32]

Obtiene o establece el elemento en el índice especificado.Gets or sets the element at the specified index.

IList.Remove(Object)

Quita el objeto StatusBarPanel especificado de la colección.Removes the specified StatusBarPanel from the collection.

Métodos de extensión

Cast<TResult>(IEnumerable)

Convierte los elementos de IEnumerable en el tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra los elementos de IEnumerable en función de un tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita la paralelización de una consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Se aplica a

Consulte también: