Share via

StatusBar.StatusBarPanelCollection.Add Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Forms
Bütünleştirilmiş Kod:
System.Windows.Forms.dll

Koleksiyona bir StatusBarPanel ekler.

Aşırı Yüklemeler

Add(String)

Koleksiyona belirtilen metinle bir StatusBarPanel ekler.
Add(StatusBarPanel)

Koleksiyona bir StatusBarPanel ekler.

Add(String)

Koleksiyona belirtilen metinle bir StatusBarPanel ekler.

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

Parametreler

text
String

Eklenmekte olan metin StatusBarPanel .

Döndürülenler

StatusBarPanel

StatusBarPanel Koleksiyona eklenen paneli temsil eden bir.

Açıklamalar

Birden fazla bilgi türünü görüntülemek için denetime StatusBar paneller ekleyebilirsiniz. Yöntemin Add bu sürümü, parametresinde text belirtilen metinle yeni StatusBarPanel bir oluşturur ve bunu koleksiyona ekler. Panellerin içinde bulunduğu StatusBar.StatusBarPanelCollection sıra, panellerin denetim içinde StatusBar görüntülenme sırasını temsil eder. Paneller, koleksiyondaki ilk panelden başlayarak soldan sağa doğru görüntülenir. Denetimin RightToLeft StatusBar özelliği, içinde panellerin görüntülenme StatusBarsırasını değiştirmez. Koleksiyonda belirli bir konuma panel eklemek için yöntemini kullanın Insert . Tek bir işlemde koleksiyona bir dizi panel eklemek için yöntemini kullanın AddRange .

Ayrıca bkz.

Şunlara uygulanır

Add(StatusBarPanel)

Koleksiyona bir StatusBarPanel ekler.

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

Parametreler

value
StatusBarPanel

StatusBarPanel Koleksiyona eklenecek paneli temsil eden bir.

Döndürülenler

Int32

Koleksiyondaki öğenin sıfır tabanlı dizini.

Özel durumlar

ArgumentNullException

StatusBarPanel koleksiyonuna eklenen öğesinin olması.null

ArgumentException

parametresinde belirtilen öğesinin StatusBarPanel üst öğesi value değil null.

Örnekler

Aşağıdaki kod örneği, formda bir StatusBar denetim oluşturur ve iki StatusBarPanel nesne ekler. adlı panel1nesnelerden StatusBarPanel biri, bir uygulamanın durum metnini görüntüler. adlı ikinci StatusBarPanel, geçerli tarihi görüntüler ve geçerli saati görüntülemek için sınıfın StatusBarPanel özelliğini kullanırToolTipText.panel2 Örnek, standart panel yerine panellerin görüntülendiğinden emin olmak için özelliğini kullanır ShowPanels ve ve özelliğini kullanarak Panels panelleri StatusBaröğesine ekleme yöntemine StatusBar.StatusBarPanelCollection erişmektedirAdd. Örnek ayrıca, nesneleri başlatmak StatusBarPanel için , BorderStyle, ToolTipTextve Text özelliklerini kullanırAutoSize. Bu örnekte tanımlanan yöntemin bir oluşturucusundan Formtanımlandığı ve çağrıldığı varsayılır.

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

Açıklamalar

Birden fazla bilgi türünü görüntülemek için denetime StatusBar paneller ekleyebilirsiniz. Yönteminin Add bu sürümü, parametresinde belirtilen öğesini value koleksiyonuna eklerStatusBarPanel. Panellerin içinde bulunduğu StatusBar.StatusBarPanelCollection sıra, panellerin denetim içinde StatusBar görüntülenme sırasını temsil eder. Paneller, koleksiyondaki ilk panelden başlayarak soldan sağa doğru görüntülenir. Denetimin RightToLeft StatusBar özelliği, içinde panellerin görüntülenme StatusBarsırasını değiştirmez. Koleksiyonda belirli bir konuma panel eklemek için yöntemini kullanın Insert . Tek bir işlemde koleksiyona bir dizi panel eklemek için yöntemini kullanın AddRange .

Ayrıca bkz.

Şunlara uygulanır