StatusBar.StatusBarPanelCollection.Add Metodo

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

Parametri

Restituisce

StatusBarPanel

Oggetto StatusBarPanel che rappresenta il pannello aggiunto all'insieme.

Commenti

È possibile aggiungere pannelli a un StatusBar controllo per visualizzare più di un tipo di informazioni. Questa versione del Add metodo crea un nuovo StatusBarPanel oggetto con il testo specificato nel text parametro e lo aggiunge alla raccolta. L'ordine in cui i pannelli si trovano nell'oggetto StatusBar.StatusBarPanelCollection rappresenta l'ordine in cui i pannelli vengono visualizzati all'interno del StatusBar controllo. I pannelli vengono visualizzati da sinistra a destra a partire dal primo pannello della raccolta. La RightToLeft proprietà del StatusBar controllo non modifica l'ordine in cui i pannelli vengono visualizzati in StatusBar. Per inserire un pannello in una posizione specifica nella raccolta, utilizzare il Insert metodo . Per aggiungere un set di pannelli all'insieme in una singola operazione, utilizzare il AddRange metodo .

Vedi anche

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

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

Parametri

Restituisce

Int32

Indice in base zero dell'elemento nella raccolta.

Eccezioni

Esempio

Nell'esempio di codice seguente viene creato un StatusBar controllo in una maschera e vengono aggiunti due StatusBarPanel oggetti . Uno degli StatusBarPanel oggetti, denominato panel1, visualizza il testo di stato per un'applicazione. Il secondo StatusBarPaneloggetto , denominato panel2, visualizza la data corrente e usa la ToolTipText proprietà della StatusBarPanel classe per visualizzare l'ora corrente. Nell'esempio viene utilizzata la ShowPanels proprietà per assicurarsi che i pannelli vengano visualizzati anziché un pannello standard e che usi e la Panels proprietà per accedere al Add metodo di StatusBar.StatusBarPanelCollection per aggiungere i pannelli a StatusBar. Nell'esempio vengono inoltre utilizzate le AutoSizeproprietà , BorderStyle, ToolTipTexte Text per inizializzare gli StatusBarPanel oggetti . In questo esempio si presuppone che il metodo definito nell'esempio sia definito e chiamato dal costruttore di un oggetto 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

Commenti

È possibile aggiungere pannelli a un StatusBar controllo per visualizzare più di un tipo di informazioni. Questa versione del Add metodo aggiunge l'oggetto StatusBarPanel specificato nel value parametro alla raccolta. L'ordine in cui i pannelli si trovano nell'oggetto StatusBar.StatusBarPanelCollection rappresenta l'ordine in cui i pannelli vengono visualizzati all'interno del StatusBar controllo. I pannelli vengono visualizzati da sinistra a destra a partire dal primo pannello della raccolta. La RightToLeft proprietà del StatusBar controllo non modifica l'ordine in cui i pannelli vengono visualizzati in StatusBar. Per inserire un pannello in una posizione specifica nella raccolta, utilizzare il Insert metodo . Per aggiungere un set di pannelli all'insieme in una singola operazione, utilizzare il AddRange metodo .

Vedi anche

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