StatusBar.StatusBarPanelCollection Kelas

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

StatusBar.StatusBarPanelCollection.cs

Perhatian

StatusBar is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use StatusStrip instead.

Mewakili kumpulan panel dalam StatusBar kontrol.

public: ref class StatusBar::StatusBarPanelCollection : System::Collections::IList

[System.ComponentModel.ListBindable(false)]
[System.ComponentModel.Browsable(false)]
[System.Obsolete("`StatusBar` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `StatusStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class StatusBar.StatusBarPanelCollection : System.Collections.IList

[<System.ComponentModel.ListBindable(false)>]
[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`StatusBar` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `StatusStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type StatusBar.StatusBarPanelCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

Public Class StatusBar.StatusBarPanelCollection
Implements IList

Warisan

Object

StatusBar.StatusBarPanelCollection

Atribut

ListBindableAttribute BrowsableAttribute ObsoleteAttribute

Penerapan

ICollection IEnumerable IList

Contoh

Contoh kode berikut membuat StatusBar kontrol pada formulir dan menambahkan dua StatusBarPanel objek. Salah StatusBarPanelsatu , bernama panel1, menampilkan teks status untuk aplikasi. Yang kedua StatusBarPanel, bernama panel2, menampilkan tanggal saat ini dan menggunakan ToolTipText properti StatusBarPanel kelas untuk menampilkan waktu saat ini. Contoh menggunakan ShowPanels properti untuk memastikan bahwa panel ditampilkan alih-alih panel standar, dan menggunakan dan Panels properti untuk mengakses Add metode StatusBar.StatusBarPanelCollection untuk menambahkan panel ke StatusBar. Contohnya juga menggunakan AutoSizeproperti , BorderStyle, ToolTipText, dan Text untuk menginisialisasi StatusBarPanel objek. Contoh ini mengasumsikan bahwa metode yang ditentukan dalam contoh ditentukan dan dipanggil dari konstruktor .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

Keterangan

Kelas StatusBar.StatusBarPanelCollection menyimpan panel yang ditampilkan di StatusBar. Setiap objek dalam koleksi adalah instans StatusBarPanel kelas yang menentukan karakteristik tampilan dan perilaku panel yang ditampilkan dalam StatusBar.

Ada sejumlah cara untuk menambahkan panel ke koleksi. Metode ini Add menyediakan kemampuan untuk menambahkan satu panel ke koleksi. Untuk menambahkan sejumlah panel ke koleksi, Anda membuat array StatusBarPanel objek dan menetapkannya ke AddRange metode . Jika Anda ingin menyisipkan panel di lokasi tertentu dalam koleksi, Anda dapat menggunakan metode .Insert Untuk menghapus panel, Anda dapat menggunakan Remove metode atau RemoveAt metode jika Anda tahu di mana panel berada dalam koleksi. Metode ini Clear memungkinkan Anda untuk menghapus semua panel dari koleksi alih-alih menggunakan Remove metode untuk menghapus satu panel pada satu waktu.

Selain metode dan properti untuk menambahkan dan menghapus panel, StatusBar.StatusBarPanelCollection juga menyediakan metode untuk menemukan panel dalam koleksi. Metode ini Contains memungkinkan Anda menentukan apakah panel adalah anggota koleksi. Setelah Anda tahu bahwa panel terletak di dalam koleksi, Anda dapat menggunakan IndexOf metode untuk menentukan di mana panel berada dalam koleksi.

Konstruktor

Nama	Deskripsi
StatusBar.StatusBarPanelCollection(StatusBar)	Kedaluwarsa. Menginisialisasi instans baru dari kelas StatusBar.StatusBarPanelCollection.

Properti

Nama	Deskripsi
Count	Kedaluwarsa. Mendapatkan jumlah item dalam koleksi.
IsReadOnly	Kedaluwarsa. Mendapatkan nilai yang menunjukkan apakah koleksi ini bersifat baca-saja.
Item[Int32]	Kedaluwarsa. Mendapatkan atau mengatur pada StatusBarPanel indeks yang ditentukan.
Item[String]	Kedaluwarsa. Mendapatkan item dengan kunci yang ditentukan dari koleksi.

Metode

Nama	Deskripsi
Add(StatusBarPanel)	Kedaluwarsa. StatusBarPanel Menambahkan ke koleksi.
Add(String)	Kedaluwarsa. StatusBarPanel Menambahkan dengan teks yang ditentukan ke koleksi.
AddRange(StatusBarPanel[])	Kedaluwarsa. Menambahkan array StatusBarPanel objek ke koleksi.
Clear()	Kedaluwarsa. Menghapus semua item dari koleksi.
Contains(StatusBarPanel)	Kedaluwarsa. Menentukan apakah panel yang ditentukan terletak di dalam koleksi.
ContainsKey(String)	Kedaluwarsa. Menentukan apakah koleksi berisi StatusBarPanel dengan kunci yang ditentukan.
GetEnumerator()	Kedaluwarsa. Mengembalikan enumerator yang akan digunakan untuk melakukan iterasi melalui kumpulan item.
IndexOf(StatusBarPanel)	Kedaluwarsa. Mengembalikan indeks dalam kumpulan panel yang ditentukan.
IndexOfKey(String)	Kedaluwarsa. Mengembalikan indeks kemunculan pertama dengan StatusBarPanel kunci yang ditentukan.
Insert(Int32, StatusBarPanel)	Kedaluwarsa. Menyisipkan yang ditentukan StatusBarPanel ke dalam koleksi pada indeks yang ditentukan.
Remove(StatusBarPanel)	Kedaluwarsa. Menghapus yang ditentukan StatusBarPanel dari koleksi.
RemoveAt(Int32)	Kedaluwarsa. Menghapus yang StatusBarPanel terletak di indeks yang ditentukan dalam koleksi.
RemoveByKey(String)	Kedaluwarsa. StatusBarPanel Menghapus dengan kunci yang ditentukan dari koleksi.

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
ICollection.CopyTo(Array, Int32)	Kedaluwarsa. StatusBar.StatusBarPanelCollection Menyalin ke array satu dimensi yang kompatibel, dimulai dari indeks array target yang ditentukan.
ICollection.IsSynchronized	Kedaluwarsa. Mendapatkan nilai yang menunjukkan apakah akses ke koleksi disinkronkan (utas aman).
ICollection.SyncRoot	Kedaluwarsa. Mendapatkan objek yang dapat digunakan untuk menyinkronkan akses ke koleksi.
IList.Add(Object)	API ini mendukung infrastruktur produk dan tidak dimaksudkan untuk digunakan langsung dari kode Anda. Kedaluwarsa. StatusBarPanel Menambahkan ke koleksi.
IList.Contains(Object)	Kedaluwarsa. Menentukan apakah panel yang ditentukan terletak di dalam koleksi.
IList.IndexOf(Object)	Kedaluwarsa. Mengembalikan indeks panel yang ditentukan dalam koleksi.
IList.Insert(Int32, Object)	Kedaluwarsa. Menyisipkan yang ditentukan StatusBarPanel ke dalam koleksi pada indeks yang ditentukan.
IList.IsFixedSize	Kedaluwarsa. Mendapatkan nilai yang menunjukkan apakah koleksi memiliki ukuran tetap.
IList.Item[Int32]	Kedaluwarsa. Mendapatkan atau mengatur elemen pada indeks yang ditentukan.
IList.Remove(Object)	Kedaluwarsa. Menghapus yang ditentukan StatusBarPanel dari koleksi.

Lihat juga

• StatusBarPanel