StatusBar.StatusBarPanelCollection.Add Método

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Adiciona um StatusBarPanel à coleção.

Sobrecargas

Add(String)	Adiciona um StatusBarPanel com o texto especificado na coleção.
Add(StatusBarPanel)	Adiciona um StatusBarPanel à coleção.

Add(String)

Adiciona um StatusBarPanel com o texto especificado na coleção.

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

O texto para o StatusBarPanel que está sendo adicionado.

Retornos

StatusBarPanel

Um StatusBarPanel que representa o painel que foi adicionado à coleção.

Comentários

Você pode adicionar painéis a um StatusBar controle para exibir mais de um tipo de informação. Esta versão do Add método cria um novo StatusBarPanel com o texto especificado no parâmetro e o text adiciona à coleção. A ordem na qual os StatusBar.StatusBarPanelCollection painéis estão localizados na ordem em que os painéis são exibidos dentro do StatusBar controle. Os painéis são exibidos da esquerda para a direita, começando pelo primeiro painel da coleção. A RightToLeft propriedade do StatusBar controle não altera a ordem na qual os StatusBarpainéis são exibidos no . Para inserir um painel em uma posição específica na coleção, use o Insert método. Para adicionar um conjunto de painéis à coleção em uma única operação, use o AddRange método.

Confira também

Aplica-se a

Add(StatusBarPanel)

Adiciona um StatusBarPanel à coleção.

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

Um StatusBarPanel que representa o painel a ser adicionado à coleção.

Retornos

Int32

O índice de base zero do item na coleção.

Exceções

ArgumentNullException

O StatusBarPanel que está sendo adicionado à coleção era null.

ArgumentException

O pai do StatusBarPanel especificado no parâmetro value não é null.

Exemplos

O exemplo de código a seguir cria um StatusBar controle em um formulário e adiciona dois StatusBarPanel objetos. Um dos StatusBarPanel objetos, nomeado panel1, exibe o texto de status de um aplicativo. O segundo StatusBarPanel, nomeado panel2, exibe a data atual e usa a ToolTipText propriedade da StatusBarPanel classe para exibir a hora atual. O exemplo usa a ShowPanels propriedade para garantir que os painéis sejam exibidos em vez de um painel padrão, e ele usa e a Panels propriedade para acessar o Add método do StatusBar.StatusBarPanelCollection para adicionar os painéis ao StatusBar. O exemplo também usa as AutoSizepropriedades , BorderStyle ToolTipTexte Text , para inicializar os StatusBarPanel objetos. Este exemplo pressupõe que o método definido no exemplo seja definido e chamado do construtor de um 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

Comentários

Você pode adicionar painéis a um StatusBar controle para exibir mais de um tipo de informação. Essa versão do Add método adiciona o StatusBarPanel especificado no value parâmetro à coleção. A ordem na qual os StatusBar.StatusBarPanelCollection painéis estão localizados na ordem em que os painéis são exibidos dentro do StatusBar controle. Os painéis são exibidos da esquerda para a direita, começando pelo primeiro painel da coleção. A RightToLeft propriedade do StatusBar controle não altera a ordem na qual os StatusBarpainéis são exibidos no . Para inserir um painel em uma posição específica na coleção, use o Insert método. Para adicionar um conjunto de painéis à coleção em uma única operação, use o AddRange método.

Confira também

Aplica-se a

Compartilhar via

StatusBar.StatusBarPanelCollection.Add Método

Definição

Sobrecargas

Add(String)

Parâmetros

Retornos

Comentários

Confira também

Aplica-se a

Add(StatusBarPanel)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Recursos adicionais