StatusBarPanel Sınıf

Tanım

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

Devralma

Object

MarshalByRefObject

Component

StatusBarPanel

Uygulamalar

ISupportInitialize

Örnekler

Aşağıdaki kod örneği, formda bir StatusBar denetim oluşturur ve iki StatusBarPanel nesne ekler. adlı panel1ilk StatusBarPanel, 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, panellerin standart panel yerine görüntülendiğinden emin olmak için özelliğini kullanır ShowPanels ve panelleri öğesine eklemek StatusBariçin yöntemine StatusBar.StatusBarPanelCollection erişmek Add için özelliğini kullanırPanels. Ö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

Bu sınıf .NET 5 ve sonraki sürümlerde kullanılamaz. ToolStripStatusLabel Bunun yerine denetimi kullanın.

A StatusBarPanel , denetimin StatusBar.StatusBarPanelCollection içindeki tek bir StatusBar paneli temsil eder. , StatusBarPanel bir uygulamanın durumunu yansıtmak için kullanılabilecek metin ve/veya simge içerebilir. StatusBar.StatusBarPanelCollectionTek bir StatusBarStatusBarPanelöğesini almak, eklemek veya kaldırmak için bir denetimin özelliği aracılığıyla StatusBar.Panels erişilebilen öğesini kullanın.

, StatusBarPanel denetim içindeki StatusBar bir panelin görüntüleme davranışını değiştirmenizi sağlayan özellikler sağlar. Panelin Icon içinde bir simge görüntülemek için özelliğini kullanabilirsiniz. Bu özellik, bir uygulamadaki durumun grafik gösterimini sağlamak için kullanılabilir. özelliği, Alignment metnin ve/veya simgenin panel içinde nasıl hizalı olduğunu belirtmenizi sağlar. Panelinizin panel metnine sığacak şekilde düzgün boyutlandırılmasını sağlamak için, paneli panel metnine sığacak şekilde otomatik olarak yeniden boyutlandırmak veya denetim içindeki StatusBar kalan alanı doldurmak için özelliğini kullanabilirsinizAutoSize. özelliği, MinWidth panelin görüntülenmesi amaçlanan verilerden daha küçük olmamasını sağlamak için en düşük genişliği belirtmenize olanak tanır.

Denetim StatusBar genellikle uygulamanızla ilgili Yardım bilgilerini veya durum bilgilerini görüntülemek için kullanılır. Genellikle, bir panelde sunulan veriler hakkında ek bilgi görüntülemek önemlidir. Fare işaretçisi panelde ToolTipText her olduğunda bilgileri görüntülemek için özelliğini kullanabilirsiniz.

Denetim genellikle metin bilgilerini görüntülemek için kullanılabilse StatusBar de, bir StatusBarPanelöğesine kendi görüntü türünüzü de sağlayabilirsiniz. özelliği, Style öğesinin nasıl çizileceğini belirtmenizi StatusBarPanel sağlar. Varsayılan olarak, Style özelliğin değerini Text (ve özelliğinde belirtilmişse bir simgeyi Icon ) görüntülemek için özelliği kullanılır. özelliği olarak ayarlanırsa OwnerDrawpanele kendi bilgilerinizi çizebilirsiniz. Panelde ilerleme çubuğu veya animasyonlu simge çizmek için bu özelliği kullanabilirsiniz.

Sınıfının bir örneğini StatusBarPanel oluşturduğunuzda, okuma/yazma özellikleri başlangıç değerlerine ayarlanır. Bu değerlerin listesi için oluşturucuya StatusBarPanel bakın.

Oluşturucular

Özellikler

Yöntemler

Ekinlikler

Şunlara uygulanır

Ayrıca bkz.

• StatusBarPanel