Sdílet prostřednictvím


StatusBarPanel Třída

Definice

Představuje panel v ovládacím StatusBar prvku.

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

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
Implementuje

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

StatusBarPanel()

Inicializuje novou instanci StatusBarPanel třídy.

Vlastnosti

Alignment

Získá nebo nastaví zarovnání textu a ikon v panelu stavového řádku.

AutoSize

Získá nebo nastaví hodnotu označující, zda je panel stavového řádku automaticky změněn.

BorderStyle

Získá nebo nastaví styl ohraničení panelu stavového řádku.

CanRaiseEvents

Získá hodnotu označující, zda komponenta může vyvolat událost.

(Zděděno od Component)
Container

Získá objekt IContainer , který obsahuje Component.

(Zděděno od Component)
DesignMode

Získá hodnotu, která označuje, zda je aktuálně v režimu návrhu Component .

(Zděděno od Component)
Events

Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component.

(Zděděno od Component)
Icon

Získá nebo nastaví ikonu tak, aby se zobrazila na panelu stavového řádku.

MinWidth

Získá nebo nastaví minimální povolenou šířku panelu stavového řádku v rámci StatusBar ovládacího prvku.

Name

Získá nebo nastaví název pro .StatusBarPanel

Parent

Získá ovládací prvek StatusBar , který hostuje panel stavového řádku.

Site

Získá nebo nastaví ISite hodnotu Component.

(Zděděno od Component)
Style

Získá nebo nastaví styl panelu stavového řádku.

Tag

Získá nebo nastaví objekt, který obsahuje data o StatusBarPanel.

Text

Získá nebo nastaví text panelu stavového řádku.

ToolTipText

Získá nebo nastaví text popisku přidružený ke stavovém panelu.

Width

Získá nebo nastaví šířku panelu stavového řádku v rámci StatusBar ovládacího prvku.

Metody

BeginInit()

Zahájí inicializaci .StatusBarPanel

CreateObjRef(Type)

Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy používaného ke komunikaci se vzdáleným objektem.

(Zděděno od MarshalByRefObject)
Dispose()

Uvolní všechny prostředky používané nástrojem Component.

(Zděděno od Component)
Dispose(Boolean)

Uvolní nespravované prostředky používané StatusBarPanel nástrojem a volitelně uvolní spravované prostředky.

EndInit()

Ukončí inicializaci .StatusBarPanel

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetLifetimeService()
Zastaralé.

Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci.

(Zděděno od MarshalByRefObject)
GetService(Type)

Vrátí objekt, který představuje službu poskytovanou objektem Component nebo jejím Containerobjektem .

(Zděděno od Component)
GetType()

Získá aktuální Type instanci.

(Zděděno od Object)
InitializeLifetimeService()
Zastaralé.

Získá objekt služby životnosti, který řídí zásady životnosti pro tuto instanci.

(Zděděno od MarshalByRefObject)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
MemberwiseClone(Boolean)

Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu.

(Zděděno od MarshalByRefObject)
ToString()

Načte řetězec, který obsahuje informace o panelu.

Událost

Disposed

Nastane, když je komponenta odstraněna voláním Dispose() metody.

(Zděděno od Component)

Platí pro

Viz také