StatusBarPanel Classe

Definizione

Rappresenta un pannello in un controllo StatusBar.Represents a panel in a StatusBar control. Anche se il controllo StatusStrip sostituisce e aggiunge funzionalità al controllo StatusBar delle versioni precedenti, StatusBar viene mantenuto sia per la compatibilità con le versioni precedenti che per un eventuale uso futuro.Although 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
Ereditarietà
Implementazioni

Esempio

Nell'esempio di codice seguente viene creato un controllo StatusBar in un form e vengono aggiunti due oggetti StatusBarPanel.The following code example creates a StatusBar control on a form and adds two StatusBarPanel objects. Il primo StatusBarPanel, denominato panel1, Visualizza il testo di stato di un'applicazione.The first StatusBarPanel, named panel1, displays status text for an application. Il secondo StatusBarPanel, denominato panel2, Visualizza la data corrente e usa la proprietà ToolTipText della classe StatusBarPanel per visualizzare l'ora corrente.The second StatusBarPanel, named panel2, displays the current date and uses the ToolTipText property of the StatusBarPanel class to display the current time. Nell'esempio viene utilizzata la proprietà ShowPanels per assicurarsi che i pannelli siano visualizzati anziché un pannello standard e che utilizzi la proprietà Panels per accedere al metodo Add della StatusBar.StatusBarPanelCollection per aggiungere i pannelli alla 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. Nell'esempio vengono inoltre utilizzate le proprietà AutoSize, BorderStyle, ToolTipTexte Text per inizializzare gli oggetti StatusBarPanel.The example also uses the AutoSize, BorderStyle, ToolTipText, and Text properties to initialize the StatusBarPanel objects. In questo esempio si presuppone che il metodo definito nell'esempio venga definito e chiamato dal costruttore di un Form.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

Commenti

Una StatusBarPanel rappresenta un singolo pannello nella StatusBar.StatusBarPanelCollection di un controllo StatusBar.A StatusBarPanel represents an individual panel in the StatusBar.StatusBarPanelCollection of a StatusBar control. Un StatusBarPanel può contenere testo e/o un'icona che può essere utilizzata per riflettere lo stato di un'applicazione.A StatusBarPanel can contain text and/or an icon that can be used to reflect the status of an application. Usare la StatusBar.StatusBarPanelCollection, accessibile tramite la proprietà StatusBar.Panels di un controllo StatusBar, per recuperare, aggiungere o rimuovere un singolo StatusBarPanel.Use the StatusBar.StatusBarPanelCollection, accessible through the StatusBar.Panels property of a StatusBar control, to retrieve, add, or remove an individual StatusBarPanel.

Il StatusBarPanel fornisce proprietà che consentono di modificare il comportamento di visualizzazione di un pannello all'interno di un controllo StatusBar.The StatusBarPanel provides properties that enable you to modify the display behavior of a panel within a StatusBar control. È possibile utilizzare la proprietà Icon per visualizzare un'icona all'interno di un pannello.You can use the Icon property to display an icon within a panel. Questa proprietà può essere utilizzata per fornire una rappresentazione grafica dello stato in un'applicazione.This property can be used to provide a graphical representation of state in an application. Il Alignment proprietà consente di specificare il modo in cui il testo e/o un'icona è allineata all'interno del pannello.The Alignment property enables you to specify how text and/or an icon is aligned within the panel. Per assicurarsi che il pannello sia dimensionato correttamente per adattarsi al testo del pannello, è possibile usare la proprietà AutoSize per ridimensionare automaticamente il pannello in modo da adattarlo al testo del pannello o riempire lo spazio rimanente all'interno del controllo StatusBar.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. Il MinWidth proprietà consente di specificare una larghezza minima per il pannello, in modo da garantire che non risulti inferiore ai dati che devono essere visualizzati.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.

Il controllo StatusBar viene in genere usato per visualizzare informazioni della guida o informazioni sullo stato dell'applicazione.The StatusBar control is typically used to display Help information or state information about your application. Spesso è importante visualizzare informazioni aggiuntive sui dati presentati in un pannello.Often, it is important to display additional information about data that is presented in a panel. È possibile utilizzare la proprietà ToolTipText per visualizzare informazioni ogni volta che il puntatore del mouse viene posizionato su un pannello.You can use the ToolTipText property to display information whenever the mouse pointer rests on a panel.

Anche se il controllo StatusBar viene in genere usato per visualizzare informazioni testuali, è anche possibile fornire il proprio tipo di visualizzazione a una StatusBarPanel.Although the StatusBar control is typically used to display textual information, you can also provide your own type of display to a StatusBarPanel. La proprietà Style consente di specificare la modalità di disegno del StatusBarPanel.The Style property enables you to specify how the StatusBarPanel will be drawn. Per impostazione predefinita, la proprietà Style viene utilizzata per visualizzare il valore della proprietà Text (e un'icona, se specificata nella proprietà Icon).By default, the Style property is used to display the value of the Text property (and an icon, if specified in the Icon property). Se la proprietà è impostata su OwnerDraw, è possibile creare informazioni personalizzate nel pannello.If the property is set to OwnerDraw, you can draw your own information into the panel. È possibile usare questa funzionalità per creare un indicatore di stato o un'icona animata nel pannello.You can use this feature to draw a progress bar or an animated icon in the panel.

Quando si crea un'istanza della classe StatusBarPanel, le proprietà di lettura/scrittura vengono impostate sui valori iniziali.When you create an instance of the StatusBarPanel class, the read/write properties are set to initial values. Per un elenco di questi valori, vedere il costruttore StatusBarPanel.For a list of these values, see the StatusBarPanel constructor.

Costruttori

StatusBarPanel()

Inizializza una nuova istanza della classe StatusBarPanel.Initializes a new instance of the StatusBarPanel class.

Proprietà

Alignment

Ottiene o imposta l'allineamento di testo e icone all'interno del pannello della barra di stato.Gets or sets the alignment of text and icons within the status bar panel.

AutoSize

Ottiene o imposta un valore che indica se il pannello della barra di stato deve essere ridimensionato automaticamente.Gets or sets a value indicating whether the status bar panel is automatically resized.

BorderStyle

Ottiene o imposta lo stile del bordo del pannello con la barra di stato.Gets or sets the border style of the status bar panel.

CanRaiseEvents

Ottiene un valore che indica se il componente può generare un evento.Gets a value indicating whether the component can raise an event.

(Ereditato da Component)
Container

Ottiene il IContainer che contiene il Component.Gets the IContainer that contains the Component.

(Ereditato da Component)
DesignMode

Ottiene un valore che indica se il Component si trova in modalità progettazione.Gets a value that indicates whether the Component is currently in design mode.

(Ereditato da Component)
Events

Ottiene l'elenco dei gestori eventi allegati a questo Component.Gets the list of event handlers that are attached to this Component.

(Ereditato da Component)
Icon

Ottiene o imposta l'icona da visualizzare nel pannello con la barra di stato.Gets or sets the icon to display within the status bar panel.

MinWidth

Ottiene o imposta la larghezza minima consentita del pannello con la barra di stato nel controllo StatusBar.Gets or sets the minimum allowed width of the status bar panel within the StatusBar control.

Name

Ottiene o imposta il nome da applicare all'oggetto StatusBarPanel.Gets or sets the name to apply to the StatusBarPanel.

Parent

Ottiene il controllo StatusBar che contiene il pannello con la barra di stato.Gets the StatusBar control that hosts the status bar panel.

Site

Ottiene o imposta l'oggetto ISite dell'oggetto Component.Gets or sets the ISite of the Component.

(Ereditato da Component)
Style

Ottiene o imposta lo stile del pannello con la barra di stato.Gets or sets the style of the status bar panel.

Tag

Ottiene o imposta un oggetto che contiene i dati relativi all'oggetto StatusBarPanel.Gets or sets an object that contains data about the StatusBarPanel.

Text

Ottiene o imposta il testo del pannello con la barra di stato.Gets or sets the text of the status bar panel.

ToolTipText

Ottiene o imposta il testo della descrizione comandi associato al pannello con la barra di stato.Gets or sets ToolTip text associated with the status bar panel.

Width

Ottiene o imposta la larghezza del pannello con la barra di stato nel controllo StatusBar.Gets or sets the width of the status bar panel within the StatusBar control.

Metodi

BeginInit()

Avvia l'inizializzazione di un oggetto StatusBarPanel.Begins the initialization of a StatusBarPanel.

CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Ereditato da MarshalByRefObject)
Dispose()

Rilascia tutte le risorse usate da Component.Releases all resources used by the Component.

(Ereditato da Component)
Dispose(Boolean)

Rilascia le risorse non gestite usate da StatusBarPanel e facoltativamente rilascia le risorse gestite.Releases the unmanaged resources used by the StatusBarPanel and optionally releases the managed resources.

EndInit()

Avvia l'inizializzazione di un oggetto StatusBarPanel.Ends the initialization of a StatusBarPanel.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
GetService(Type)

Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container.Returns an object that represents a service provided by the Component or by its Container.

(Ereditato da Component)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Ereditato da MarshalByRefObject)
ToString()

Recupera una stringa contenente informazioni sul pannello.Retrieves a string that contains information about the panel.

Eventi

Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Ereditato da Component)

Si applica a

Vedi anche