StatusBarPanel Kelas

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mewakili panel dalam StatusBar kontrol.

Kelas ini tidak tersedia di .NET 5 dan versi yang lebih baru. Gunakan kontrol sebagai gantinya ToolStripStatusLabel , yang menggantikan dan memperluas StatusBarPanel kontrol.

public ref class StatusBarPanel : System::ComponentModel::Component, System::ComponentModel::ISupportInitialize

public class StatusBarPanel : System.ComponentModel.Component, System.ComponentModel.ISupportInitialize

type StatusBarPanel = class
    inherit Component
    interface ISupportInitialize

Public Class StatusBarPanel
Inherits Component
Implements ISupportInitialize

Warisan: Object

MarshalByRefObject

Component
StatusBarPanel

Penerapan: ISupportInitialize

Contoh

Contoh kode berikut membuat StatusBar kontrol pada formulir dan menambahkan dua StatusBarPanel objek. Yang pertama StatusBarPanel, bernama panel1, menampilkan teks status untuk aplikasi. Yang kedua StatusBarPanel, bernama panel2, menampilkan tanggal saat ini dan menggunakan ToolTipText properti kelas StatusBarPanel untuk menampilkan waktu saat ini. Contohnya menggunakan ShowPanels properti untuk memastikan bahwa panel ditampilkan alih-alih panel standar, dan menggunakan 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 didefinisikan dan dipanggil dari konstruktor dari 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 ini tidak tersedia di .NET 5 dan versi yang lebih baru. Gunakan kontrol sebagai gantinya ToolStripStatusLabel .

StatusBarPanel mewakili panel individual dalam StatusBar.StatusBarPanelCollection StatusBar kontrol. StatusBarPanel dapat berisi teks dan/atau ikon yang dapat digunakan untuk mencerminkan status aplikasi. StatusBar.StatusBarPanelCollectionGunakan , yang dapat diakses melalui StatusBar.Panels properti StatusBar kontrol, untuk mengambil, menambahkan, atau menghapus individu StatusBarPanel.

menyediakan StatusBarPanel properti yang memungkinkan Anda mengubah perilaku tampilan panel dalam StatusBar kontrol. Anda dapat menggunakan Icon properti untuk menampilkan ikon di dalam panel. Properti ini dapat digunakan untuk memberikan representasi grafis status dalam aplikasi. Properti Alignment memungkinkan Anda menentukan bagaimana teks dan/atau ikon diratakan dalam panel. Untuk memastikan bahwa panel Anda berukuran tepat agar pas dengan teks panel, Anda dapat menggunakan AutoSize properti untuk mengubah ukuran panel secara otomatis agar sesuai dengan teks panel atau untuk mengisi ruang yang tersisa dalam StatusBar kontrol. Properti MinWidth memungkinkan Anda menentukan lebar minimum untuk panel untuk memastikan bahwa itu tidak menjadi lebih kecil dari data yang dimaksudkan untuk ditampilkan.

StatusBar Kontrol biasanya digunakan untuk menampilkan informasi Bantuan atau informasi status tentang aplikasi Anda. Seringkali, penting untuk menampilkan informasi tambahan tentang data yang disajikan di panel. Anda dapat menggunakan ToolTipText properti untuk menampilkan informasi setiap kali penunjuk mouse berada di panel.

StatusBar Meskipun kontrol biasanya digunakan untuk menampilkan informasi tekstual, Anda juga dapat memberikan jenis tampilan Anda sendiri ke StatusBarPanel. Properti Style memungkinkan Anda menentukan bagaimana StatusBarPanel akan digambar. Secara default, Style properti digunakan untuk menampilkan nilai Text properti (dan ikon, jika ditentukan dalam Icon properti ). Jika properti diatur ke OwnerDraw, Anda dapat menarik informasi Anda sendiri ke panel. Anda dapat menggunakan fitur ini untuk menggambar bilah kemajuan atau ikon animasi di panel.

Saat Anda membuat instans StatusBarPanel kelas , properti baca/tulis diatur ke nilai awal. Untuk daftar nilai-nilai ini, lihat StatusBarPanel konstruktor.

Konstruktor

StatusBarPanel()

Menginisialisasi instans baru kelas StatusBarPanel.

Properti

Alignment	Mendapatkan atau mengatur perataan teks dan ikon di dalam panel bilah status.
AutoSize	Mendapatkan atau menetapkan nilai yang menunjukkan apakah panel bilah status diubah ukurannya secara otomatis.
BorderStyle	Mendapatkan atau mengatur gaya batas panel bilah status.
CanRaiseEvents	Mendapatkan nilai yang menunjukkan apakah komponen dapat menaikkan peristiwa. (Diperoleh dari Component)
Container	IContainer Mendapatkan yang berisi Component. (Diperoleh dari Component)
DesignMode	Mendapatkan nilai yang menunjukkan apakah Component saat ini dalam mode desain. (Diperoleh dari Component)
Events	Mendapatkan daftar penanganan aktivitas yang dilampirkan ke ini Component. (Diperoleh dari Component)
Icon	Mendapatkan atau mengatur ikon untuk ditampilkan di dalam panel bilah status.
MinWidth	Mendapatkan atau mengatur lebar minimum yang diizinkan dari panel bilah status dalam StatusBar kontrol.
Name	Mendapatkan atau mengatur nama untuk diterapkan ke StatusBarPanel.
Parent	StatusBar Mendapatkan kontrol yang menghosting panel bilah status.
Site	Mendapatkan atau mengatur ISite dari Component. (Diperoleh dari Component)
Style	Mendapatkan atau mengatur gaya panel bilah status.
Tag	Mendapatkan atau mengatur objek yang berisi data tentang StatusBarPanel.
Text	Mendapatkan atau mengatur teks panel bilah status.
ToolTipText	Mendapatkan atau mengatur teks TipsAlat yang terkait dengan panel bilah status.
Width	Mendapatkan atau mengatur lebar panel bilah status dalam StatusBar kontrol.

Metode

BeginInit()	Memulai inisialisasi StatusBarPanel.
CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Merilis semua sumber daya yang Componentdigunakan oleh . (Diperoleh dari Component)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang digunakan oleh StatusBarPanel dan secara opsional merilis sumber daya terkelola.
EndInit()	Mengakhiri inisialisasi StatusBarPanel.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLifetimeService()	Kedaluwarsa. Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetService(Type)	Mengembalikan objek yang mewakili layanan yang disediakan oleh Component atau oleh Container. (Diperoleh dari Component)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
InitializeLifetimeService()	Kedaluwarsa. Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
ToString()	Mengambil string yang berisi informasi tentang panel.

Acara

Disposed

Terjadi ketika komponen dibuang oleh panggilan ke Dispose() metode .

(Diperoleh dari Component)

Berlaku untuk

Lihat juga

StatusBarPanel