StatusBar.Panels Propiedad

public:
 property System::Windows::Forms::StatusBar::StatusBarPanelCollection ^ Panels { System::Windows::Forms::StatusBar::StatusBarPanelCollection ^ get(); };

public System.Windows.Forms.StatusBar.StatusBarPanelCollection Panels { get; }

member this.Panels : System.Windows.Forms.StatusBar.StatusBarPanelCollection

Public ReadOnly Property Panels As StatusBar.StatusBarPanelCollection

Valor de propiedad

Colección StatusBar.StatusBarPanelCollection que contiene los objetos StatusBarPanel del control StatusBar.

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 StatusBarPanel objetos, denominados panel1, muestra el texto de estado de una aplicación. El segundo StatusBarPanel objeto, 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 requiere que el método definido en el ejemplo se defina y se llame 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

El StatusBar control puede mostrar una serie de paneles para proporcionar información al usuario de la aplicación. Por ejemplo, un panel podría mostrar la hora actual o el progreso de una descarga de archivos. Cada panel mostrado por el StatusBar control es una instancia de la StatusBarPanel clase . La Panels propiedad permite obtener una referencia a la colección de StatusBarPanel objetos almacenados actualmente en el StatusBar control . Con esta referencia, puede agregar paneles, quitar paneles, acceder a un panel específico dentro de la colección y obtener un recuento de los paneles del StatusBar control. Para obtener más información sobre las tareas que se pueden realizar con la colección de paneles, vea los StatusBar.StatusBarPanelCollection temas de referencia de clase.

Se aplica a

Consulte también

• StatusBar.StatusBarPanelCollection
• StatusBarPanel