StatusBarPanel Třída

Definice

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

Dědičnost

Object

MarshalByRefObject

Component

StatusBarPanel

Implementuje

ISupportInitialize

Příklady

Následující příklad kódu vytvoří ovládací prvek StatusBar ve formuláři a přidá dva StatusBarPanel objekty. První StatusBarPanels názvem panel1zobrazí text stavu aplikace. Druhý StatusBarPanelobjekt s názvem panel2zobrazí aktuální datum a použije ToolTipText vlastnost StatusBarPanel třídy k zobrazení aktuálního času. Příklad používá ShowPanels vlastnost k zajištění, že panely jsou zobrazeny místo standardního panelu, a používá Panels vlastnost pro přístup Add k metodě objektu StatusBar.StatusBarPanelCollection pro přidání panelů do StatusBar. Příklad také používá AutoSizevlastnosti , BorderStyleToolTipText, a Text k inicializaci StatusBarPanel objektů. Tento příklad předpokládá, že metoda definovaná v příkladu je definována a volána z konstruktoru objektu 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

Poznámky

Tato třída není k dispozici v .NET 5 a novějších verzích. Místo toho ToolStripStatusLabel použijte ovládací prvek.

A StatusBarPanel představuje jednotlivé panely v StatusBar.StatusBarPanelCollection ovládacím StatusBar prvku. Objekt StatusBarPanel může obsahovat text nebo ikonu, která se dá použít k vyjádření stavu aplikace. Pomocí objektu StatusBar.StatusBarPanelCollection, který je přístupný prostřednictvím StatusBar.Panels vlastnosti StatusBar ovládacího prvku, načtěte, přidejte nebo odeberte jednotlivou položku StatusBarPanel.

Poskytuje StatusBarPanel vlastnosti, které umožňují změnit chování zobrazení panelu v rámci StatusBar ovládacího prvku. Vlastnost můžete použít Icon k zobrazení ikony na panelu. Tuto vlastnost lze použít k poskytnutí grafického znázornění stavu v aplikaci. Vlastnost Alignment umožňuje určit, jak má být text a/nebo ikona v panelu zarovnaná. Pokud chcete zajistit správnou velikost panelu tak, aby se vešel do textu panelu, můžete pomocí AutoSize vlastnosti automaticky změnit velikost panelu tak, aby se vešel do textu panelu, nebo vyplnit zbývající místo v ovládacím StatusBar prvku. Vlastnost MinWidth umožňuje zadat minimální šířku panelu, aby se zajistilo, že nebude menší než data, která má zobrazit.

Ovládací StatusBar prvek se obvykle používá k zobrazení informací nápovědy nebo informací o stavu vaší aplikace. Často je důležité zobrazit další informace o datech, které jsou prezentovány na panelu. Vlastnost můžete použít ToolTipText k zobrazení informací vždy, když ukazatel myši leží na panelu.

I když se StatusBar ovládací prvek obvykle používá k zobrazení textových informací, můžete také zadat vlastní typ zobrazení pro StatusBarPanelobjekt . Vlastnost Style umožňuje určit, jak StatusBarPanel se bude kreslit. Ve výchozím nastavení se Style vlastnost používá k zobrazení hodnoty Text vlastnosti (a ikony, pokud je ve Icon vlastnosti zadána). Pokud je vlastnost nastavená na OwnerDraw, můžete do panelu nakreslit vlastní informace. Pomocí této funkce můžete na panelu nakreslit indikátor průběhu nebo animovanou ikonu.

Když vytvoříte instanci StatusBarPanel třídy, vlastnosti pro čtení a zápis jsou nastaveny na počáteční hodnoty. Seznam těchto hodnot najdete v konstruktoru StatusBarPanel .

Konstruktory

Vlastnosti

Metody

Událost

Platí pro

Viz také

• StatusBarPanel