StatusBarPanel Klasa

Definicja

Reprezentuje Panel w StatusBar kontrolce.Represents a panel in a StatusBar control. Mimo że StatusBar StatusBar formant zastępuje i dodaje funkcje kontroli nad poprzednimi wersjami, jest zachowywany w celu zapewnienia zgodności z poprzednimi wersjami i w przyszłości w przypadku wybrania tej opcji. StatusStripAlthough the StatusStrip control replaces and adds functionality to the StatusBar control of previous versions, StatusBar is retained for both backward compatibility and future use if you choose.

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
Implementuje

Przykłady

Poniższy przykład kodu tworzy StatusBar kontrolkę w formularzu i dodaje dwa StatusBarPanel obiekty.The following code example creates a StatusBar control on a form and adds two StatusBarPanel objects. Pierwszy StatusBarPanel, nazwany panel1, wyświetla tekst stanu dla aplikacji.The first StatusBarPanel, named panel1, displays status text for an application. Drugi StatusBarPanel, nazwany panel2, wyświetla ToolTipText bieżącą datę i używa właściwości klasy, StatusBarPanel aby wyświetlić bieżącą godzinę.The second StatusBarPanel, named panel2, displays the current date and uses the ToolTipText property of the StatusBarPanel class to display the current time. ShowPanels W przykładzie użyto właściwości, aby upewnić się, że panele są wyświetlane zamiast standardowego panelu, i Add Panels używa właściwości, aby uzyskać dostęp do metody, StatusBar.StatusBarPanelCollection aby dodać panele do StatusBar.The example uses the ShowPanels property to ensure that the panels are displayed instead of a standard panel, and it uses the Panels property to access the Add method of the StatusBar.StatusBarPanelCollection to add the panels to the StatusBar. W AutoSizeprzykładzie zastosowano również właściwości BorderStyle, ToolTipText, i Text , aby zainicjować StatusBarPanel obiekty.The example also uses the AutoSize, BorderStyle, ToolTipText, and Text properties to initialize the StatusBarPanel objects. W tym przykładzie przyjęto założenie, że metoda zdefiniowana w przykładzie jest zdefiniowana i wywoływana z konstruktora Formklasy.This example assumes that the method defined in the example is defined and called from the constructor of a 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

A StatusBarPanel reprezentuje pojedynczy panel StatusBar.StatusBarPanelCollection w StatusBar kontrolce.A StatusBarPanel represents an individual panel in the StatusBar.StatusBarPanelCollection of a StatusBar control. StatusBarPanel Może zawierać tekst i/lub ikonę, która może być używana do odzwierciedlenia stanu aplikacji.A StatusBarPanel can contain text and/or an icon that can be used to reflect the status of an application. Użyj, dostępnej StatusBar.Panels przez właściwość StatusBar kontrolki, do pobrania, dodania lub usunięcia osoby StatusBarPanel. StatusBar.StatusBarPanelCollectionUse the StatusBar.StatusBarPanelCollection, accessible through the StatusBar.Panels property of a StatusBar control, to retrieve, add, or remove an individual StatusBarPanel.

Zawiera właściwości, które umożliwiają modyfikowanie zachowania wyświetlania panelu StatusBar w kontrolce. StatusBarPanelThe StatusBarPanel provides properties that enable you to modify the display behavior of a panel within a StatusBar control. Możesz użyć właściwości, Icon aby wyświetlić ikonę w panelu.You can use the Icon property to display an icon within a panel. Ta właściwość może służyć do zapewnienia graficznej reprezentacji stanu w aplikacji.This property can be used to provide a graphical representation of state in an application. Alignment Właściwość pozwala określić, jak tekst i/lub ikona są wyrównane w panelu.The Alignment property enables you to specify how text and/or an icon is aligned within the panel. Aby upewnić się, że rozmiar panelu jest odpowiednio dopasowany do tekstu panelu, możesz użyć AutoSize właściwości, aby automatycznie zmienić rozmiar panelu w celu dopasowania go do tekstu panelu lub wypełnić pozostałe miejsce StatusBar w kontrolce.To ensure that your panel is sized properly to fit the text of the panel, you can use the AutoSize property to automatically resize the panel to fit the text of the panel or to fill the remaining space within the StatusBar control. MinWidth Właściwość pozwala określić minimalną szerokość panelu, aby upewnić się, że nie jest ona mniejsza niż dane, które mają być wyświetlane.The MinWidth property enables you to specify a minimum width for the panel to ensure that it does not get smaller than the data it is intended to display.

StatusBar Kontrolka jest zwykle używana do wyświetlania informacji pomocy lub informacji o stanie aplikacji.The StatusBar control is typically used to display Help information or state information about your application. Często ważne jest, aby wyświetlić dodatkowe informacje o danych, które są prezentowane w panelu.Often, it is important to display additional information about data that is presented in a panel. Możesz użyć właściwości, ToolTipText aby wyświetlić informacje za każdym razem, gdy wskaźnik myszy zatrzyma się na panelu.You can use the ToolTipText property to display information whenever the mouse pointer rests on a panel.

Chociaż formant jest zazwyczaj używany do wyświetlania informacji tekstowych, można również udostępnić własny typ ekranu StatusBarPanel. StatusBarAlthough the StatusBar control is typically used to display textual information, you can also provide your own type of display to a StatusBarPanel. Właściwość pozwala określić, w StatusBarPanel jaki sposób będzie rysowany. StyleThe Style property enables you to specify how the StatusBarPanel will be drawn. Domyślnie Style właściwość jest używana do wyświetlania wartości Text właściwości (i ikony Icon , jeśli jest określona we właściwości).By default, the Style property is used to display the value of the Text property (and an icon, if specified in the Icon property). Jeśli właściwość jest ustawiona na OwnerDraw, możesz narysować własne informacje w panelu.If the property is set to OwnerDraw, you can draw your own information into the panel. Za pomocą tej funkcji można narysować pasek postępu lub animowaną ikonę w panelu.You can use this feature to draw a progress bar or an animated icon in the panel.

Podczas tworzenia wystąpienia StatusBarPanel klasy właściwości do odczytu/zapisu są ustawiane na wartości początkowe.When you create an instance of the StatusBarPanel class, the read/write properties are set to initial values. Aby uzyskać listę tych wartości, zobacz StatusBarPanel Konstruktor.For a list of these values, see the StatusBarPanel constructor.

Konstruktory

StatusBarPanel()

Inicjuje nowe wystąpienie klasy StatusBarPanel klasy.Initializes a new instance of the StatusBarPanel class.

Właściwości

Alignment

Pobiera lub Ustawia wyrównanie tekstu i ikon w panelu paska stanu.Gets or sets the alignment of text and icons within the status bar panel.

AutoSize

Pobiera lub ustawia wartość wskazującą, czy rozmiar panelu paska stanu jest zmieniany automatycznie.Gets or sets a value indicating whether the status bar panel is automatically resized.

BorderStyle

Pobiera lub ustawia styl obramowania panelu paska stanu.Gets or sets the border style of the status bar panel.

CanRaiseEvents

Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie.Gets a value indicating whether the component can raise an event.

(Odziedziczone po Component)
Container

Pobiera, który zawiera Component. IContainerGets the IContainer that contains the Component.

(Odziedziczone po Component)
DesignMode

Pobiera wartość wskazującą, czy Component jest aktualnie w trybie projektowania.Gets a value that indicates whether the Component is currently in design mode.

(Odziedziczone po Component)
Events

Pobiera listę programów obsługi zdarzeń, które są dołączone do tego Componentelementu.Gets the list of event handlers that are attached to this Component.

(Odziedziczone po Component)
Icon

Pobiera lub ustawia ikonę, która ma być wyświetlana w panelu paska stanu.Gets or sets the icon to display within the status bar panel.

MinWidth

Pobiera lub ustawia minimalną dozwoloną szerokość panelu paska stanu w StatusBar formancie.Gets or sets the minimum allowed width of the status bar panel within the StatusBar control.

Name

Pobiera lub ustawia nazwę, która ma zostać zastosowana do StatusBarPanel.Gets or sets the name to apply to the StatusBarPanel.

Parent

StatusBar Pobiera formant, który obsługuje panel pasek stanu.Gets the StatusBar control that hosts the status bar panel.

Site

Pobiera lub ustawia wartość ISite. ComponentGets or sets the ISite of the Component.

(Odziedziczone po Component)
Style

Pobiera lub ustawia styl panelu paska stanu.Gets or sets the style of the status bar panel.

Tag

Pobiera lub ustawia obiekt, który zawiera dane o StatusBarPanel.Gets or sets an object that contains data about the StatusBarPanel.

Text

Pobiera lub ustawia tekst panelu paska stanu.Gets or sets the text of the status bar panel.

ToolTipText

Pobiera lub ustawia tekst etykietki narzędzia skojarzony z panelem paska stanu.Gets or sets ToolTip text associated with the status bar panel.

Width

Pobiera lub ustawia szerokość panelu paska stanu w StatusBar kontrolce.Gets or sets the width of the status bar panel within the StatusBar control.

Metody

BeginInit()

Rozpoczyna inicjalizację StatusBarPanel.Begins the initialization of a StatusBarPanel.

CreateObjRef(Type)

Tworzy obiekt, który zawiera wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikacji z obiektem zdalnym.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Odziedziczone po MarshalByRefObject)
Dispose()

Zwalnia wszystkie zasoby używane przez Componentprogram.Releases all resources used by the Component.

(Odziedziczone po Component)
Dispose(Boolean)

Zwalnia niezarządzane zasoby używane przez StatusBarPanel program i opcjonalnie zwalnia zarządzane zasoby.Releases the unmanaged resources used by the StatusBarPanel and optionally releases the managed resources.

EndInit()

Zamyka inicjalizację StatusBarPanel.Ends the initialization of a StatusBarPanel.

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetLifetimeService()

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
GetService(Type)

Zwraca obiekt, który reprezentuje usługę dostarczoną przez Component lub Containerprzez.Returns an object that represents a service provided by the Component or by its Container.

(Odziedziczone po Component)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
InitializeLifetimeService()

Uzyskuje obiekt usługi istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego MarshalByRefObject obiektu.Creates a shallow copy of the current MarshalByRefObject object.

(Odziedziczone po MarshalByRefObject)
ToString()

Pobiera ciąg zawierający informacje o panelu.Retrieves a string that contains information about the panel.

Zdarzenia

Disposed

Występuje, gdy składnik zostanie usunięty przez wywołanie Dispose() metody.Occurs when the component is disposed by a call to the Dispose() method.

(Odziedziczone po Component)

Dotyczy

Zobacz też