StatusBarPanel Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

StatusBarPanel.cs

Upozornění

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

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

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

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

Dědičnost

Object

MarshalByRefObject

Component

StatusBarPanel

Atributy

BrowsableAttribute ObsoleteAttribute

Implementuje

ISupportInitialize

Příklady

Následující příklad kódu vytvoří StatusBar ovládací prvek ve formuláři a přidá dva StatusBarPanel objekty. StatusBarPanelPrvní pojmenovaný panel1text zobrazí stavový text aplikace. Druhý StatusBarPanel, pojmenovaný panel2, zobrazí aktuální datum a používá ToolTipText vlastnost StatusBarPanel třídy k zobrazení aktuálního času. Příklad používá ShowPanels vlastnost k zajištění, aby se panely zobrazovaly místo standardního panelu a používá Panels vlastnost pro přístup k Add metodě StatusBar.StatusBarPanelCollection přidání panelů do StatusBar. Příklad také používá AutoSize, , BorderStyleToolTipTexta Text vlastnosti inicializovat StatusBarPanel objekty. 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. ToolStripStatusLabel Místo toho použijte ovládací prvek.

A StatusBarPanel představuje jednotlivý panel StatusBar.StatusBarPanelCollectionStatusBar ovládacího prvku. A StatusBarPanel může obsahovat text nebo ikonu, která se dá použít k vyjádření stavu aplikace. StatusBar.StatusBarPanelCollectionPoužijte , přístupné prostřednictvím StatusBar.Panels vlastnosti StatusBar ovládacího prvku, k načtení, přidání nebo odebrání jednotlivce StatusBarPanel.

Poskytuje StatusBarPanel vlastnosti, které umožňují změnit chování zobrazení panelu v ovládacím StatusBar prvku. Vlastnost můžete použít Icon k zobrazení ikony na panelu. Tuto vlastnost lze použít k poskytnutí grafické reprezentace stavu v aplikaci. Tato Alignment vlastnost umožňuje určit, jak je text a/nebo ikona zarovnaná v panelu. Pokud chcete zajistit správnou velikost panelu tak, aby odpovídal textu panelu, můžete pomocí AutoSize vlastnosti automaticky změnit velikost panelu tak, aby se přizpůsobil textu panelu nebo aby vyplnil zbývající místo v ovládacím StatusBar prvku. Tato MinWidth vlastnost umožňuje zadat minimální šířku panelu, aby se zajistilo, že se nezmenší než data, která se mají zobrazit.

Ovládací StatusBar prvek se obvykle používá k zobrazení informací nápovědy nebo informací o stavu aplikace. Často je důležité zobrazit další informace o datech, která se zobrazují na panelu. Vlastnost můžete použít ToolTipText k zobrazení informací při každém umístění ukazatele myši na panelu.

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

Při vytváření instance StatusBarPanel třídy jsou vlastnosti pro čtení a zápis nastaveny na počáteční hodnoty. Seznam těchto hodnot naleznete v konstruktoru StatusBarPanel .

Konstruktory

Name	Description
StatusBarPanel()	Zastaralé. Inicializuje novou instanci StatusBarPanel třídy.

Vlastnosti

Name	Description
Alignment	Zastaralé. Získá nebo nastaví zarovnání textu a ikon na stavovém řádku panelu.
AutoSize	Zastaralé. Získá nebo nastaví hodnotu určující, zda je panel stavového řádku automaticky změněn.
BorderStyle	Zastaralé. Získá nebo nastaví styl ohraničení stavového řádku panelu.
Icon	Zastaralé. Získá nebo nastaví ikonu pro zobrazení na stavovém řádku panelu.
MinWidth	Zastaralé. Získá nebo nastaví minimální povolenou šířku stavového řádku v ovládacím StatusBar prvku.
Name	Zastaralé. Získá nebo nastaví název, který má být aplikován na StatusBarPanel.
Parent	Zastaralé. StatusBar Získá ovládací prvek, který je hostitelem stavového řádku panelu.
Style	Zastaralé. Získá nebo nastaví styl stavového řádku panelu.
Tag	Zastaralé. Získá nebo nastaví objekt, který obsahuje data o objektu StatusBarPanel.
Text	Zastaralé. Získá nebo nastaví text stavového řádku.
ToolTipText	Zastaralé. Získá nebo nastaví text popisku přidružený k stavovém řádku panelu.
Width	Zastaralé. Získá nebo nastaví šířku stavového řádku panelu v ovládacím StatusBar prvku.

Metody

Name	Description
BeginInit()	Zastaralé. Začíná inicializace .StatusBarPanel
EndInit()	Zastaralé. Ukončí inicializaci .StatusBarPanel

Viz také

• StatusBarPanel