Udostępnij za pośrednictwem

StatusBar.StatusBarPanelCollection.Add Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Dodaje element StatusBarPanel do kolekcji.

Przeciążenia

Add(String)

Dodaje obiekt StatusBarPanel z określonym tekstem do kolekcji.
Add(StatusBarPanel)

Dodaje element StatusBarPanel do kolekcji.

Add(String)

Dodaje obiekt StatusBarPanel z określonym tekstem do kolekcji.

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

Parametry

text
String

Tekst, StatusBarPanel który jest dodawany.

Zwraca

StatusBarPanel

Obiekt StatusBarPanel reprezentujący panel, który został dodany do kolekcji.

Uwagi

Możesz dodać panele do kontrolki StatusBar , aby wyświetlić więcej niż jeden typ informacji. Ta wersja Add metody tworzy nowy StatusBarPanel tekst określony w parametrze text i dodaje go do kolekcji. Kolejność, w jakiej panele znajdują się w obiekcie StatusBar.StatusBarPanelCollection , reprezentuje kolejność wyświetlania paneli w kontrolce StatusBar . Panele są wyświetlane od lewej do prawej od pierwszego panelu w kolekcji. Właściwość RightToLeft kontrolki StatusBar nie zmienia kolejności wyświetlania paneli w obiekcie StatusBar. Aby wstawić panel w określonej pozycji w kolekcji, użyj Insert metody . Aby dodać zestaw paneli do kolekcji w ramach jednej operacji, użyj AddRange metody .

Zobacz też

Dotyczy

Add(StatusBarPanel)

Dodaje element StatusBarPanel do kolekcji.

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

Parametry

value
StatusBarPanel

Obiekt StatusBarPanel reprezentujący panel do dodania do kolekcji.

Zwraca

Int32

Indeks elementu w kolekcji oparty na zera.

Wyjątki

ArgumentNullException

Element StatusBarPanel dodawany do kolekcji to null.

ArgumentException

Element nadrzędny określonego StatusBarPanel w parametrze value nie nulljest .

Przykłady

Poniższy przykład kodu tworzy kontrolkę StatusBar w formularzu i dodaje dwa StatusBarPanel obiekty. StatusBarPanel Jeden z obiektów o nazwie panel1wyświetla tekst stanu aplikacji. Drugi StatusBarPanel, o nazwie panel2, wyświetla bieżącą datę i używa ToolTipText właściwości StatusBarPanel klasy do wyświetlenia bieżącej godziny. W przykładzie użyto ShowPanels właściwości , aby upewnić się, że panele są wyświetlane zamiast panelu standardowego i używa właściwości oraz Panels właściwości w celu uzyskania dostępu do Add metody StatusBar.StatusBarPanelCollection w celu dodania paneli do obiektu StatusBar. W przykładzie użyto AutoSizerównież właściwości , BorderStyle, ToolTipTexti Text w celu zainicjowania StatusBarPanel obiektów. W tym przykładzie przyjęto założenie, że metoda zdefiniowana w przykładzie jest zdefiniowana i wywoływana z konstruktora Formklasy .

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

Uwagi

Możesz dodać panele do kontrolki StatusBar , aby wyświetlić więcej niż jeden typ informacji. Ta wersja Add metody dodaje StatusBarPanel parametr określony w parametrze value do kolekcji. Kolejność, w jakiej panele znajdują się w obiekcie StatusBar.StatusBarPanelCollection , reprezentuje kolejność wyświetlania paneli w kontrolce StatusBar . Panele są wyświetlane od lewej do prawej od pierwszego panelu w kolekcji. Właściwość RightToLeft kontrolki StatusBar nie zmienia kolejności wyświetlania paneli w obiekcie StatusBar. Aby wstawić panel w określonej pozycji w kolekcji, użyj Insert metody . Aby dodać zestaw paneli do kolekcji w ramach jednej operacji, użyj AddRange metody .

Zobacz też

Dotyczy