StatusBarPanel Osztály

Definíció

Névtér:: System.Windows.Forms

Szerelvény:: System.Windows.Forms.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Egy StatusBar vezérlőelem panelét jelöli.

Ez az osztály nem érhető el .NET 5-ös és újabb verziókban. Ehelyett használja a ToolStripStatusLabel vezérlőt, amely lecseréli és kibővíti a vezérlőt StatusBarPanel .

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

Öröklődés: Object

MarshalByRefObject

Component
StatusBarPanel

Megvalósítás: ISupportInitialize

Példák

Az alábbi példakód létrehoz egy vezérlőelemet StatusBar egy űrlapon, és két StatusBarPanel objektumot ad hozzá. Az első StatusBarPanelnévvel ellátott panel1alkalmazás állapotszövegét jeleníti meg. A második StatusBarPanel, elnevezett panel2, megjeleníti az aktuális dátumot, és az StatusBarPanel ToolTipText osztály tulajdonságával jeleníti meg az aktuális időt. A példa a ShowPanels tulajdonságot használja annak biztosítására, hogy a panelek egy szabványos panel helyett jelenjenek meg, és a Panels tulajdonság használatával éri el a Add panelek hozzáadásának metódusátStatusBar.StatusBarPanelCollection.StatusBar A példa az AutoSizeobjektumok inicializálásához a , BorderStyle, ToolTipTextés Text tulajdonságokat StatusBarPanel is használja. Ez a példa feltételezi, hogy a példában definiált metódus egy 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

Megjegyzések

Ez az osztály nem érhető el .NET 5-ös és újabb verziókban. Használja inkább a ToolStripStatusLabel vezérlőt.

Az A StatusBarPanel egy vezérlő egy különálló panelét StatusBar.StatusBarPanelCollection StatusBar jelöli. A StatusBarPanel szöveg és/vagy ikon az alkalmazás állapotának tükrözésére használható. StatusBar.StatusBarPanelCollectionA vezérlőelem tulajdonságán StatusBar keresztül StatusBar.Panels elérhető tulajdonság használatával beolvashat, hozzáadhat vagy eltávolíthat egy adott személytStatusBarPanel.

Ez StatusBarPanel olyan tulajdonságokat biztosít, amelyek lehetővé teszik egy panel megjelenítési viselkedésének módosítását egy StatusBar vezérlőn belül. A tulajdonság használatával Icon megjeleníthet egy ikont egy panelen belül. Ez a tulajdonság használható az alkalmazások állapotának grafikus ábrázolására. A Alignment tulajdonság lehetővé teszi a szöveg és/vagy ikon igazítását a panelen belül. Annak érdekében, hogy a panel mérete megfelelően illeszkedjen a panel szövegéhez, a tulajdonság használatával AutoSize automatikusan átméretezheti a panelt a panel szövegének megfelelően, vagy kitöltheti a StatusBar vezérlőelemen belüli fennmaradó területet. A MinWidth tulajdonság lehetővé teszi a panel minimális szélességének megadását, hogy az ne legyen kisebb a megjelenítendő adatoknál.

A StatusBar vezérlő általában az alkalmazással kapcsolatos súgó- vagy állapotinformációk megjelenítésére szolgál. Gyakran fontos, hogy további információkat jelenítsünk meg a panelen megjelenő adatokról. A tulajdonság használatával megjelenítheti az ToolTipText adatokat, amikor az egérmutató egy panelen van.

Bár a StatusBar vezérlőt általában szöveges információk megjelenítésére használják, saját megjelenítési típust is megadhat egy StatusBarPanel. A Style tulajdonság lehetővé teszi a rajzolás módjának StatusBarPanel megadását. A tulajdonság alapértelmezés szerint a Style tulajdonság értékének Text megjelenítésére szolgál (és ha a Icon tulajdonságban meg van adva egy ikon). Ha a tulajdonság be van állítva OwnerDraw, saját adatokat rajzolhat a panelre. Ezzel a funkcióval folyamatjelző sávot vagy animált ikont rajzolhat a panelen.

Az osztály egy példányának StatusBarPanel létrehozásakor az olvasási/írási tulajdonságok kezdeti értékekre vannak állítva. Ezeknek az értékeknek a listáját a konstruktorban StatusBarPanel találja.

Konstruktorok

Name	Description
StatusBarPanel()	Inicializálja a StatusBarPanel osztály új példányát.

Tulajdonságok

Name	Description
Alignment	Lekéri vagy beállítja a szöveg és az ikonok igazítását az állapotsor paneljén.
AutoSize	Lekéri vagy beállít egy értéket, amely jelzi, hogy az állapotsor panelje automatikusan átméretezve van-e.
BorderStyle	Lekéri vagy beállítja az állapotsor panel szegélystílusát.
CanRaiseEvents	Beolvas egy értéket, amely jelzi, hogy az összetevő képes-e eseményt létrehozni. (Öröklődés forrása Component)
Container	Lekéri a IContainer .Component (Öröklődés forrása Component)
DesignMode	Olyan értéket kap, amely jelzi, hogy az Component aktuálisan tervezési módban van-e. (Öröklődés forrása Component)
Events	Lekéri az ehhez Componentcsatolt eseménykezelők listáját. (Öröklődés forrása Component)
Icon	Lekéri vagy beállítja az ikont, hogy megjelenjen az állapotsor paneljén.
MinWidth	Lekéri vagy beállítja az állapotsor paneljének minimálisan megengedett szélességét a StatusBar vezérlőn belül.
Name	Lekéri vagy beállítja a nevére alkalmazandó nevet.StatusBarPanel
Parent	Lekéri az StatusBar állapotsor panelt üzemeltető vezérlőt.
Site	Lekéri vagy megadja a ISite értékét a Component-hez. (Öröklődés forrása Component)
Style	Lekéri vagy beállítja az állapotsor panel stílusát.
Tag	Lekéri vagy beállít egy objektumot, amely adatokat tartalmaz a StatusBarPanel.
Text	Lekéri vagy beállítja az állapotsor paneljének szövegét.
ToolTipText	Lekéri vagy beállítja az állapotsor panelhez társított elemleírás-szöveget.
Width	Lekéri vagy beállítja az állapotsor paneljének szélességét a StatusBar vezérlőn belül.

Metódusok

Name	Description
BeginInit()	Megkezdi a .-nak az inicializálását StatusBarPanel.
CreateObjRef(Type)	Létrehoz egy objektumot, amely tartalmazza a távoli objektumokkal való kommunikációhoz használt proxy létrehozásához szükséges összes releváns információt. (Öröklődés forrása MarshalByRefObject)
Dispose()	Felszabadítja a .-hez használt összes erőforrást Component. (Öröklődés forrása Component)
Dispose(Boolean)	Felszabadítja a felügyelt erőforrások által StatusBarPanel használt nem felügyelt erőforrásokat, és opcionálisan felszabadítja a felügyelt erőforrásokat.
EndInit()	Véget vet egy StatusBarPanel.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetLifetimeService()	Lekéri a példány élettartamszabályzatát vezérlő aktuális élettartam-szolgáltatásobjektumot. (Öröklődés forrása MarshalByRefObject)
GetService(Type)	Olyan objektumot ad vissza, amely az általa vagy annak által Component Containernyújtott szolgáltatást jelöli. (Öröklődés forrása Component)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
InitializeLifetimeService()	Beolvas egy élettartam-szolgáltatásobjektumot a példány élettartam-szabályzatának szabályozásához. (Öröklődés forrása MarshalByRefObject)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
MemberwiseClone(Boolean)	Az aktuális MarshalByRefObject objektum sekély másolatát hozza létre. (Öröklődés forrása MarshalByRefObject)
ToString()	Lekéri a panel adatait tartalmazó sztringet.

esemény

Name	Description
Disposed	Akkor fordul elő, ha az összetevőt a metódus hívása megsemmisíti Dispose() . (Öröklődés forrása Component)

A következőre érvényes:

Lásd még

StatusBarPanel

Visszajelzés

Hasznosnak találta ezt az oldalt?