StatusBar.StatusBarPanelCollection.Add Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Agrega un elemento StatusBarPanel a la colección.

Sobrecargas

Add(String)	Agrega StatusBarPanel con el texto especificado a la colección.
Add(StatusBarPanel)	Agrega un elemento StatusBarPanel a la colección.

Add(String)

Agrega StatusBarPanel con el texto especificado a la colección.

public:
 virtual System::Windows::Forms::StatusBarPanel ^ Add(System::String ^ text);

public virtual System.Windows.Forms.StatusBarPanel Add (string text);

abstract member Add : string -> System.Windows.Forms.StatusBarPanel
override this.Add : string -> System.Windows.Forms.StatusBarPanel

Public Overridable Function Add (text As String) As StatusBarPanel

Parámetros

text

String

Texto para el StatusBarPanel que se ha agregado.

Devoluciones

StatusBarPanel

StatusBarPanel que representa el panel que se agregó a la colección.

Comentarios

Puede agregar paneles a un StatusBar control para mostrar más de un tipo de información. Esta versión del Add método crea un nuevo StatusBarPanel con el texto especificado en el text parámetro y lo agrega a la colección. El orden en el que se encuentran los paneles representa StatusBar.StatusBarPanelCollection el orden en que se muestran los paneles dentro del StatusBar control. Los paneles se muestran de izquierda a derecha a partir del primer panel de la colección. La RightToLeft propiedad del StatusBar control no cambia el orden en el que se muestran los paneles en .StatusBar Para insertar un panel en una posición específica de la colección, use el Insert método . Para agregar un conjunto de paneles a la colección en una sola operación, use el AddRange método .

Consulte también

• StatusBarPanel
• AddRange(StatusBarPanel[])
• Insert(Int32, StatusBarPanel)

Add(StatusBarPanel)

Agrega un elemento StatusBarPanel a la colección.

public:
 virtual int Add(System::Windows::Forms::StatusBarPanel ^ value);

public virtual int Add (System.Windows.Forms.StatusBarPanel value);

abstract member Add : System.Windows.Forms.StatusBarPanel -> int
override this.Add : System.Windows.Forms.StatusBarPanel -> int

Public Overridable Function Add (value As StatusBarPanel) As Integer

Parámetros

value

StatusBarPanel

StatusBarPanel que representa el panel que se va a agregar a la colección.

Devoluciones

Int32

El índice de base cero del elemento de la colección.

Excepciones

ArgumentNullException

El StatusBarPanel que se agregó a la colección era null.

ArgumentException

El panel primario del StatusBarPanel especificado en el parámetro value no es null.

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, 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

Puede agregar paneles a un StatusBar control para mostrar más de un tipo de información. Esta versión del Add método agrega el StatusBarPanel especificado en el value parámetro a la colección. El orden en el que se encuentran los paneles representa StatusBar.StatusBarPanelCollection el orden en que se muestran los paneles dentro del StatusBar control. Los paneles se muestran de izquierda a derecha a partir del primer panel de la colección. La RightToLeft propiedad del StatusBar control no cambia el orden en el que se muestran los paneles en .StatusBar Para insertar un panel en una posición específica de la colección, use el Insert método . Para agregar un conjunto de paneles a la colección en una sola operación, use el AddRange método .

Consulte también

• StatusBarPanel
• AddRange(StatusBarPanel[])
• Insert(Int32, StatusBarPanel)