StatusBarPanel Sınıf

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

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

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Denetimdeki bir StatusBar paneli temsil eder.

Bu sınıf .NET 5 ve sonraki sürümlerde kullanılamaz. ToolStripStatusLabel Bunun yerine denetimin yerini alan ve genişleten StatusBarPanel denetimi kullanın.

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 StatusBar StatusBarPanelöğ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

StatusBarPanel()

StatusBarPanel sınıfının yeni bir örneğini başlatır.

Özellikler

Alignment	Durum çubuğu panelinde metin ve simgelerin hizalamasını alır veya ayarlar.
AutoSize	Durum çubuğu panelinin otomatik olarak yeniden boyutlandırılıp boyutlandırılmadığını belirten bir değer alır veya ayarlar.
BorderStyle	Durum çubuğu panelinin kenarlık stilini alır veya ayarlar.
CanRaiseEvents	Bileşenin olay oluşturup oluşturamayacağını belirten bir değer alır. (Devralındığı yer: Component)
Container	öğesini IContainer içeren öğesini Componentalır. (Devralındığı yer: Component)
DesignMode	öğesinin şu anda tasarım modunda olup olmadığını Component gösteren bir değer alır. (Devralındığı yer: Component)
Events	Bu Componentöğesine eklenen olay işleyicilerinin listesini alır. (Devralındığı yer: Component)
Icon	Durum çubuğu panelinde görüntülenecek simgeyi alır veya ayarlar.
MinWidth	Denetim içindeki StatusBar durum çubuğu panelinin izin verilen en düşük genişliğini alır veya ayarlar.
Name	adına uygulanacak StatusBarPaneladı alır veya ayarlar.
Parent	StatusBar Durum çubuğu panelini barındıran denetimi alır.
Site	öğesini alır veya ayarlar ISite Component. (Devralındığı yer: Component)
Style	Durum çubuğu panelinin stilini alır veya ayarlar.
Tag	hakkında StatusBarPanelveri içeren bir nesneyi alır veya ayarlar.
Text	Durum çubuğu panelinin metnini alır veya ayarlar.
ToolTipText	Durum çubuğu paneliyle ilişkili Araç İpucu metnini alır veya ayarlar.
Width	Denetim içindeki durum çubuğu panelinin StatusBar genişliğini alır veya ayarlar.

Yöntemler

BeginInit()	Bir StatusBarPanelbaşlatmayı başlatır.
CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
Dispose()	Component tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Component)
Dispose(Boolean)	StatusBarPanel tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır.
EndInit()	bir StatusBarPanelbaşlatmasını sonlandırır.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Geçersiz. Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetService(Type)	veya tarafından Component Containersağlanan bir hizmeti temsil eden bir nesnesi döndürür. (Devralındığı yer: Component)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
InitializeLifetimeService()	Geçersiz. Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
ToString()	Panel hakkında bilgi içeren bir dize alır.

Ekinlikler

Disposed

Bileşen yöntemine Dispose() yapılan bir çağrı tarafından atıldığında gerçekleşir.

(Devralındığı yer: Component)

Şunlara uygulanır

Ayrıca bkz.

StatusBarPanel