StatusBarPanel Klass

Definition

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

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}")]
public class StatusBarPanel : System.ComponentModel.Component, System.ComponentModel.ISupportInitialize

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

Arv

Object

MarshalByRefObject

Component

StatusBarPanel

Attribut

BrowsableAttribute ObsoleteAttribute

Implementeringar

ISupportInitialize

Exempel

I följande kodexempel skapas en StatusBar kontroll i ett formulär och två StatusBarPanel objekt läggs till. Den första StatusBarPanel, med namnet panel1, visar statustext för ett program. Den andra StatusBarPanel, med namnet panel2, visar aktuellt datum och använder ToolTipText egenskapen StatusBarPanel för klassen för att visa den aktuella tiden. Exemplet använder ShowPanels egenskapen för att se till att panelerna visas i stället för en standardpanel, och den använder Panels egenskapen för att komma åt Add metoden StatusBar.StatusBarPanelCollection för för att lägga till panelerna i StatusBar. I exemplet används AutoSizeockså egenskaperna , BorderStyle, ToolTipTextoch Text för att initiera objekten StatusBarPanel . Det här exemplet förutsätter att metoden som definieras i exemplet definieras och anropas från konstruktorn för en 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

Kommentarer

Den här klassen är inte tillgänglig i .NET 5 och senare versioner. ToolStripStatusLabel Använd kontrollen i stället.

A StatusBarPanel representerar en enskild panel i StatusBar.StatusBarPanelCollection en StatusBar kontroll. En StatusBarPanel kan innehålla text och/eller en ikon som kan användas för att återspegla status för ett program. StatusBar.StatusBarPanelCollectionAnvänd , som är tillgänglig via StatusBar.Panels egenskapen för en StatusBar kontroll, för att hämta, lägga till eller ta bort en enskild StatusBarPanel.

Innehåller StatusBarPanel egenskaper som gör att du kan ändra visningsbeteendet för en panel i en StatusBar kontroll. Du kan använda egenskapen Icon för att visa en ikon i en panel. Den här egenskapen kan användas för att tillhandahålla en grafisk representation av tillståndet i ett program. Med Alignment egenskapen kan du ange hur text och/eller en ikon ska justeras i panelen. För att säkerställa att panelen har rätt storlek för att passa panelens text kan du använda AutoSize egenskapen för att automatiskt ändra storlek på panelen så att den passar panelens text eller för att fylla det återstående utrymmet i StatusBar kontrollen. Med MinWidth egenskapen kan du ange en minsta bredd för panelen så att den inte blir mindre än de data som den är avsedd att visa.

Kontrollen StatusBar används vanligtvis för att visa hjälpinformation eller tillståndsinformation om ditt program. Ofta är det viktigt att visa ytterligare information om data som visas i en panel. Du kan använda egenskapen ToolTipText för att visa information när muspekaren vilar på en panel.

Även om kontrollen StatusBar vanligtvis används för att visa textinformation, kan du även ange din egen typ av visning till en StatusBarPanel. Med Style egenskapen kan du ange hur ska StatusBarPanel ritas. Som standard Style används egenskapen för att visa värdet för Text egenskapen (och en ikon, om den anges i egenskapen Icon ). Om egenskapen är inställd på OwnerDrawkan du rita in din egen information i panelen. Du kan använda den här funktionen för att rita en förloppsindikator eller en animerad ikon i panelen.

När du skapar en instans av StatusBarPanel klassen anges läs-/skrivegenskaperna till initiala värden. En lista över dessa värden finns i StatusBarPanel konstruktorn.

Se även

• StatusBarPanel