StatusBarPanel Třída

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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: 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 , BorderStyle ToolTipText, 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é

StatusBarPanel