StatusBarPanel Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

StatusBarPanel.cs

Dikkat

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

Denetimdeki bir StatusBar paneli temsil eder.

Bu sınıf .NET 5 ve sonraki sürümlerde kullanılamaz. ToolStripStatusLabel Bunun yerine denetimi kullanın. Bu denetim, denetimin yerini alır ve genişletirStatusBarPanel.

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

[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 StatusBarPanel : System.ComponentModel.Component, System.ComponentModel.ISupportInitialize

[<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 StatusBarPanel = class
    inherit Component
    interface ISupportInitialize

Public Class StatusBarPanel
Inherits Component
Implements ISupportInitialize

Devralma

Object

MarshalByRefObject

Component

StatusBarPanel

Öznitelikler

BrowsableAttribute ObsoleteAttribute

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ı panel2ikinci StatusBarPanel, geçerli tarihi görüntüler ve geçerli saati görüntülemek için sınıfın özelliğini StatusBarPanel kullanırToolTipText. Örnek, standart panel yerine panellerin görüntülendiğinden emin olmak için özelliğini, ShowPanels 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önteminin bir Formoluşturucusundan tanı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 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. özelliğini kullanarak Icon panel içinde bir simge görüntüleyebilirsiniz. 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 panelin metnine sığacak şekilde otomatik olarak yeniden boyutlandırmak veya denetimin 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 bilgiler görüntülemek önemlidir. Fare işaretçisi bir panele ToolTipText her dayanışında bilgileri görüntülemek için özelliğini kullanabilirsiniz.

Denetim genellikle metin bilgilerini görüntülemek için kullanılmış olsa StatusBar da, 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, özelliğin Style 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 ayarlandıysa OwnerDraw, panele 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 ilk değerlere ayarlanır. Bu değerlerin listesi için oluşturucuya StatusBarPanel bakın.

Oluşturucular

Name	Description
StatusBarPanel()	Geçersiz. StatusBarPanel sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
Alignment	Geçersiz. Durum çubuğu panelinde metin ve simgelerin hizalamasını alır veya ayarlar.
AutoSize	Geçersiz. Durum çubuğu panelinin otomatik olarak yeniden boyutlandırılıp boyutlandırılmadığını belirten bir değer alır veya ayarlar.
BorderStyle	Geçersiz. Durum çubuğu panelinin kenarlık stilini alır veya ayarlar.
Icon	Geçersiz. Durum çubuğu panelinde görüntülenecek simgeyi alır veya ayarlar.
MinWidth	Geçersiz. Denetim içindeki StatusBar durum çubuğu panelinin izin verilen en düşük genişliğini alır veya ayarlar.
Name	Geçersiz. adını uygulamasına uygulanacak StatusBarPanelşekilde alır veya ayarlar.
Parent	Geçersiz. StatusBar Durum çubuğu panelini barındıran denetimi alır.
Style	Geçersiz. Durum çubuğu panelinin stilini alır veya ayarlar.
Tag	Geçersiz. hakkında StatusBarPanelveri içeren bir nesne alır veya ayarlar.
Text	Geçersiz. Durum çubuğu panelinin metnini alır veya ayarlar.
ToolTipText	Geçersiz. Durum çubuğu paneliyle ilişkili Araç İpucu metnini alır veya ayarlar.
Width	Geçersiz. Denetim içindeki StatusBar durum çubuğu panelinin genişliğini alır veya ayarlar.

Yöntemler

Name	Description
BeginInit()	Geçersiz. bir StatusBarPanelbaşlatma işlemini başlatır.
EndInit()	Geçersiz. bir StatusBarPanelbaşlatma işlemini sonlandırır.

Ayrıca bkz.

• StatusBarPanel