StatusBarPanel Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Reprezentuje panel w kontrolce StatusBar .

Ta klasa nie jest dostępna na platformie .NET 5 i nowszych wersjach. Zamiast tego użyj kontrolki ToolStripStatusLabel , która zastępuje i rozszerza kontrolkę 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

Dziedziczenie: Object

MarshalByRefObject

Component
StatusBarPanel

Implementuje: ISupportInitialize

Przykłady

Poniższy przykład kodu tworzy kontrolkę StatusBar w formularzu i dodaje dwa StatusBarPanel obiekty. Pierwszy StatusBarPanel, o nazwie panel1, wyświetla tekst stanu aplikacji. StatusBarPanelDrugi , o nazwie panel2, wyświetla bieżącą datę i używa ToolTipText właściwości StatusBarPanel klasy do wyświetlenia bieżącej godziny. W przykładzie ShowPanels użyto właściwości , aby upewnić się, że panele są wyświetlane zamiast panelu standardowego i używa Panels właściwości w celu uzyskania dostępu do Add metody StatusBar.StatusBarPanelCollection w celu dodania paneli do obiektu StatusBar. W przykładzie użyto AutoSizerównież właściwości , BorderStyle, ToolTipTexti Text do zainicjowania StatusBarPanel obiektów. W tym przykładzie przyjęto założenie, że metoda zdefiniowana w przykładzie jest zdefiniowana i wywoływana z konstruktora klasy 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

Uwagi

Ta klasa nie jest dostępna na platformie .NET 5 i nowszych wersjach. Zamiast tego użyj kontrolki ToolStripStatusLabel .

Element StatusBarPanel reprezentuje pojedynczy panel w StatusBar.StatusBarPanelCollection kontrolce StatusBar . Może StatusBarPanel zawierać tekst i/lub ikonę, która może służyć do odzwierciedlenia stanu aplikacji. StatusBar.StatusBarPanelCollectionUżyj elementu , dostępnego za pośrednictwem StatusBar.Panels właściwości kontrolkiStatusBar, aby pobrać, dodać lub usunąć pojedynczą StatusBarPaneljednostkę .

Udostępnia StatusBarPanel właściwości, które umożliwiają modyfikowanie zachowania wyświetlania panelu w ramach kontrolki StatusBar . Możesz użyć Icon właściwości , aby wyświetlić ikonę w panelu. Ta właściwość może służyć do zapewnienia graficznej reprezentacji stanu w aplikacji. Właściwość Alignment umożliwia określenie sposobu wyrównania tekstu i/lub ikony w panelu. Aby upewnić się, że panel jest prawidłowo dopasowany do tekstu panelu, możesz użyć AutoSize właściwości , aby automatycznie zmienić rozmiar panelu, aby dopasować tekst panelu do tekstu lub wypełnić pozostałe miejsce w kontrolce StatusBar . Właściwość MinWidth umożliwia określenie minimalnej szerokości panelu, aby upewnić się, że nie ma mniejszej niż dane, które mają być wyświetlane.

Kontrolka StatusBar jest zwykle używana do wyświetlania informacji pomocy lub informacji o stanie aplikacji. Często ważne jest, aby wyświetlić dodatkowe informacje o danych przedstawionych w panelu. Właściwość służy do wyświetlania ToolTipText informacji za każdym razem, gdy wskaźnik myszy znajduje się na panelu.

Chociaż kontrolka StatusBar jest zwykle używana do wyświetlania informacji tekstowych, można również podać własny typ wyświetlania do elementu StatusBarPanel. Właściwość Style umożliwia określenie sposobu narysowania StatusBarPanel . Domyślnie Style właściwość jest używana do wyświetlania wartości Text właściwości (i ikony, jeśli określono w Icon właściwości). Jeśli właściwość jest ustawiona na OwnerDrawwartość , możesz narysować własne informacje do panelu. Tej funkcji można użyć do narysowania paska postępu lub animowanej ikony na panelu.

Podczas tworzenia wystąpienia StatusBarPanel klasy właściwości odczytu/zapisu są ustawione na wartości początkowe. Aby uzyskać listę tych wartości, zobacz StatusBarPanel konstruktor.

Konstruktory

StatusBarPanel()

Inicjuje nowe wystąpienie klasy StatusBarPanel.

Właściwości

Alignment	Pobiera lub ustawia wyrównanie tekstu i ikon w panelu paska stanu.
AutoSize	Pobiera lub ustawia wartość wskazującą, czy panel paska stanu jest automatycznie zmieniany.
BorderStyle	Pobiera lub ustawia styl obramowania panelu paska stanu.
CanRaiseEvents	Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component)
Container	Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
DesignMode	Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component)
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component)
Icon	Pobiera lub ustawia ikonę do wyświetlenia w panelu paska stanu.
MinWidth	Pobiera lub ustawia minimalną dozwoloną szerokość panelu paska stanu w kontrolce StatusBar .
Name	Pobiera lub ustawia nazwę, która ma być stosowana do elementu StatusBarPanel.
Parent	Pobiera kontrolkę StatusBar , która hostuje panel paska stanu.
Site	Pobiera lub ustawia ISite element .Component (Odziedziczone po Component)
Style	Pobiera lub ustawia styl panelu paska stanu.
Tag	Pobiera lub ustawia obiekt zawierający dane dotyczące obiektu StatusBarPanel.
Text	Pobiera lub ustawia tekst panelu paska stanu.
ToolTipText	Pobiera lub ustawia tekst etykietki narzędzia skojarzony z panelem paska stanu.
Width	Pobiera lub ustawia szerokość panelu paska stanu w kontrolce StatusBar .

Metody

BeginInit()	Rozpoczyna inicjowanie elementu StatusBarPanel.
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element StatusBarPanel i opcjonalnie zwalnia zasoby zarządzane.
EndInit()	Kończy inicjowanie elementu StatusBarPanel.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Przestarzałe. Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetService(Type)	Zwraca obiekt reprezentujący usługę dostarczaną przez Component obiekt lub przez obiekt Container. (Odziedziczone po Component)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
InitializeLifetimeService()	Przestarzałe. Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
ToString()	Pobiera ciąg zawierający informacje o panelu.

Zdarzenia

Disposed

Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody .

(Odziedziczone po Component)

Dotyczy

Zobacz też

StatusBarPanel