StatusBarPanel Classe

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta un pannello in un controllo StatusBar.

Questa classe non è disponibile in .NET 5 e versioni successive. Utilizzare invece il ToolStripStatusLabel controllo , che sostituisce ed estende il StatusBarPanel controllo .

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à: Object

MarshalByRefObject

Component
StatusBarPanel

Implementazioni: ISupportInitialize

Esempio

Nell'esempio di codice seguente viene creato un StatusBar controllo in una maschera e vengono aggiunti due StatusBarPanel oggetti . Il primo StatusBarPanel, denominato panel1, visualizza il testo di stato per un'applicazione. Il secondo StatusBarPaneloggetto , denominato panel2, visualizza la data corrente e usa la ToolTipText proprietà della StatusBarPanel classe per visualizzare l'ora corrente. Nell'esempio viene utilizzata la ShowPanels proprietà per assicurarsi che i pannelli vengano visualizzati anziché un pannello standard e che usi la Panels proprietà per accedere al Add metodo di StatusBar.StatusBarPanelCollection per aggiungere i pannelli a StatusBar. Nell'esempio vengono inoltre utilizzate le AutoSizeproprietà , BorderStyle, ToolTipTexte Text per inizializzare gli StatusBarPanel oggetti . In questo esempio si presuppone che il metodo definito nell'esempio sia definito e chiamato dal costruttore di un oggetto 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

Questa classe non è disponibile in .NET 5 e versioni successive. Usare invece il ToolStripStatusLabel controllo .

Un StatusBarPanel oggetto rappresenta un singolo pannello nell'oggetto StatusBar.StatusBarPanelCollection di un StatusBar controllo . Un StatusBarPanel oggetto può contenere testo e/o un'icona che può essere usata per riflettere lo stato di un'applicazione. StatusBar.StatusBarPanelCollectionUtilizzare , accessibile tramite la StatusBar.Panels proprietà di un StatusBar controllo, per recuperare, aggiungere o rimuovere un singolo StatusBarPaneloggetto .

Fornisce StatusBarPanel proprietà che consentono di modificare il comportamento di visualizzazione di un pannello all'interno di un StatusBar controllo . È possibile utilizzare la Icon proprietà per visualizzare un'icona all'interno di un pannello. Questa proprietà può essere usata per fornire una rappresentazione grafica dello stato in un'applicazione. La Alignment proprietà consente di specificare la modalità di allineamento del testo e/o di un'icona all'interno del pannello. Per assicurarsi che il pannello venga ridimensionato correttamente per adattare il testo del pannello, è possibile utilizzare la AutoSize proprietà per ridimensionare automaticamente il pannello in modo da adattare il testo del pannello o per riempire lo spazio rimanente all'interno del StatusBar controllo. La MinWidth proprietà consente di specificare una larghezza minima per il pannello per assicurarsi che non sia inferiore ai dati da visualizzare.

Il StatusBar controllo viene in genere usato per visualizzare informazioni sulla Guida o sullo stato relative all'applicazione. Spesso è importante visualizzare informazioni aggiuntive sui dati presentati in un pannello. È possibile utilizzare la ToolTipText proprietà per visualizzare le informazioni ogni volta che il puntatore del mouse si posiziona su un pannello.

Anche se il StatusBar controllo viene in genere usato per visualizzare informazioni testuali, è anche possibile fornire il proprio tipo di visualizzazione a un oggetto StatusBarPanel. La Style proprietà consente di specificare la modalità di disegno dell'oggetto StatusBarPanel . Per impostazione predefinita, la Style proprietà viene utilizzata per visualizzare il valore della Text proprietà e un'icona, se specificata nella Icon proprietà . Se la proprietà è impostata su OwnerDraw, è possibile disegnare le proprie informazioni nel pannello. È possibile usare questa funzionalità per disegnare un indicatore di stato o un'icona animata nel pannello.

Quando si crea un'istanza della StatusBarPanel classe , le proprietà di lettura/scrittura vengono impostate sui valori iniziali. Per un elenco di questi valori, vedere il StatusBarPanel costruttore.

Costruttori

StatusBarPanel()

Inizializza una nuova istanza della classe StatusBarPanel.

Proprietà

Alignment	Ottiene o imposta l'allineamento di testo e icone all'interno del pannello della barra di stato.
AutoSize	Ottiene o imposta un valore che indica se il pannello della barra di stato deve essere ridimensionato automaticamente.
BorderStyle	Ottiene o imposta lo stile del bordo del pannello con la barra di stato.
CanRaiseEvents	Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component)
Container	Ottiene l'oggetto IContainer che contiene Component. (Ereditato da Component)
DesignMode	Ottiene un valore che indica se il Component si trova in modalità progettazione. (Ereditato da Component)
Events	Ottiene l'elenco dei gestori eventi allegati a questo Component. (Ereditato da Component)
Icon	Ottiene o imposta l'icona da visualizzare nel pannello con la barra di stato.
MinWidth	Ottiene o imposta la larghezza minima consentita del pannello con la barra di stato nel controllo StatusBar.
Name	Ottiene o imposta il nome da applicare all'oggetto StatusBarPanel.
Parent	Ottiene il controllo StatusBar che contiene il pannello con la barra di stato.
Site	Ottiene o imposta l'oggetto ISite di Component. (Ereditato da Component)
Style	Ottiene o imposta lo stile del pannello con la barra di stato.
Tag	Ottiene o imposta un oggetto che contiene i dati relativi all'oggetto StatusBarPanel.
Text	Ottiene o imposta il testo del pannello con la barra di stato.
ToolTipText	Ottiene o imposta il testo della descrizione comandi associato al pannello con la barra di stato.
Width	Ottiene o imposta la larghezza del pannello con la barra di stato nel controllo StatusBar.

Metodi

BeginInit()	Avvia l'inizializzazione di un oggetto 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. (Ereditato da MarshalByRefObject)
Dispose()	Rilascia tutte le risorse usate da Component. (Ereditato da Component)
Dispose(Boolean)	Rilascia le risorse non gestite usate da StatusBarPanel e, facoltativamente, le risorse gestite.
EndInit()	Avvia l'inizializzazione di un oggetto StatusBarPanel.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Obsoleti. Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetService(Type)	Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container. (Ereditato da Component)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
InitializeLifetimeService()	Obsoleti. Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
ToString()	Recupera una stringa contenente informazioni sul pannello.

Eventi

Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().

(Ereditato da Component)

Si applica a

Vedi anche

StatusBarPanel

Condividi tramite