StatusBar.StatusBarPanelCollection.Add Metod

Källa:

StatusBar.StatusBarPanelCollection.cs

Källa:

StatusBar.StatusBarPanelCollection.cs

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

Parametrar

Returer

En StatusBarPanel som representerar panelen som lades till i samlingen.

Kommentarer

Du kan lägga till paneler i en StatusBar kontroll för att visa mer än en typ av information. Den här versionen av Add metoden skapar en ny StatusBarPanel med texten som anges i parametern text och lägger till den i samlingen. Ordningen i vilken paneler finns i StatusBar.StatusBarPanelCollection representerar den ordning som paneler visas i StatusBar kontrollen. Paneler visas från vänster till höger från den första panelen i samlingen. Kontrollens RightToLeftStatusBar egenskap ändrar inte i vilken ordning panelerna visas i StatusBar. Om du vill infoga en panel på en specifik plats i samlingen använder du Insert metoden . Om du vill lägga till en uppsättning paneler i samlingen i en enda åtgärd använder du AddRange metoden .

Se även

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

Källa:

StatusBar.StatusBarPanelCollection.cs

Källa:

StatusBar.StatusBarPanelCollection.cs

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

Parametrar

Returer

Det nollbaserade indexet för objektet i samlingen.

Undantag

Exempel

I följande kodexempel skapas en StatusBar kontroll i ett formulär och två StatusBarPanel objekt läggs till. Ett av objekten StatusBarPanel , med namnet panel1, visar statustext för ett program. Den andra StatusBarPanel, med namnet panel2, visar aktuellt datum och använder ToolTipText egenskapen StatusBarPanel för klassen för att visa den aktuella tiden. Exemplet använder ShowPanels egenskapen för att se till att panelerna visas i stället för en standardpanel, och den Panels använder och egenskapen för att komma åt Add metoden StatusBar.StatusBarPanelCollection för att lägga till panelerna i StatusBar. I exemplet används AutoSizeockså egenskaperna , BorderStyle, ToolTipTextoch Text för att initiera objekten StatusBarPanel . Det här exemplet förutsätter att metoden som definieras i exemplet definieras och anropas från konstruktorn för en 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

Kommentarer

Du kan lägga till paneler i en StatusBar kontroll för att visa mer än en typ av information. Den här versionen av Add metoden lägger till den StatusBarPanel angivna i parametern value i samlingen. Ordningen i vilken paneler finns i StatusBar.StatusBarPanelCollection representerar den ordning som paneler visas i StatusBar kontrollen. Paneler visas från vänster till höger från den första panelen i samlingen. Kontrollens RightToLeftStatusBar egenskap ändrar inte i vilken ordning panelerna visas i StatusBar. Om du vill infoga en panel på en specifik plats i samlingen använder du Insert metoden . Om du vill lägga till en uppsättning paneler i samlingen i en enda åtgärd använder du AddRange metoden .

Se även

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