StatusBarPanel StatusBarPanel StatusBarPanel StatusBarPanel Class

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

Esempi

L'esempio di codice seguente crea una StatusBar control per un form e aggiunge due StatusBarPanel oggetti.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 per un'applicazione.The first StatusBarPanel, named panel1, displays status text for an application. Il secondo StatusBarPanel, denominato panel2, viene visualizzata la data corrente e utilizza il ToolTipText proprietà del StatusBarPanel classe 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. L'esempio Usa il ShowPanels proprietà per assicurarsi che i pannelli vengono visualizzati anziché un pannello standard e Usa il Panels proprietà a cui accedere il Add metodo del StatusBar.StatusBarPanelCollection per aggiungere pannelli al 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. L'esempio Usa anche il AutoSize, BorderStyle, ToolTipText, e Text le proprietà da inizializzare il StatusBarPanel oggetti.The example also uses the AutoSize, BorderStyle, ToolTipText, and Text properties to initialize the StatusBarPanel objects. Questo esempio si presuppone che il metodo definito nell'esempio viene definito e chiamato dal costruttore di una 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

Oggetto StatusBarPanel rappresenta un singolo pannello nel StatusBar.StatusBarPanelCollection di un StatusBar controllo.A StatusBarPanel represents an individual panel in the StatusBar.StatusBarPanelCollection of a StatusBar control. Oggetto StatusBarPanel può contenere testo e/o un'icona che può essere usata per indicare 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 il StatusBar.Panels proprietà di un StatusBar controllo, per recuperare, aggiungere o rimuovere un singolo oggetto 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 le proprietà che consentono di modificare il comportamento di visualizzazione di un pannello all'interno di un StatusBar controllo.The StatusBarPanel provides properties that enable you to modify the display behavior of a panel within a StatusBar control. È possibile usare il Icon proprietà 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 di un'applicazione.This property can be used to provide a graphical representation of state in an application. Il Alignment proprietà consente di specificare la modalità di allineamento testo e/o un'icona 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 viene ridimensionato in modo corretto per adattarsi al testo del pannello, è possibile usare la AutoSize proprietà per il ridimensionamento automatico per adattarsi al testo del pannello o per riempire il rimanente spazio all'interno di StatusBar controllo.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 garantire che il server non riceve più piccolo rispetto ai dati consente di visualizzare.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 StatusBar controllo viene in genere usato per visualizzare le informazioni della Guida o informazioni sullo stato relative all'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 usare il ToolTipText proprietà per visualizzare le informazioni ogni volta che il puntatore del mouse si sofferma su un pannello.You can use the ToolTipText property to display information whenever the mouse pointer rests on a panel.

Anche se il StatusBar controllo viene in genere usato per visualizzare le informazioni testuali, è anche possibile fornire il proprio tipo di visualizzazione per un StatusBarPanel.Although the StatusBar control is typically used to display textual information, you can also provide your own type of display to a StatusBarPanel. Il Style proprietà consente di specificare come il StatusBarPanel verrà disegnata.The Style property enables you to specify how the StatusBarPanel will be drawn. Per impostazione predefinita, il Style proprietà viene utilizzata per visualizzare il valore della Text proprietà (e un'icona, se specificato nel Icon proprietà).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 inserire le proprie informazioni nel pannello.If the property is set to OwnerDraw, you can draw your own information into the panel. È possibile usare questa funzionalità per disegnare 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 di StatusBarPanel (classe), le proprietà di lettura/scrittura sono 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 StatusBarPanel costruttore.For a list of these values, see the StatusBarPanel constructor.

Costruttori

StatusBarPanel() StatusBarPanel() StatusBarPanel() StatusBarPanel()

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

Proprietà

Alignment Alignment Alignment 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 AutoSize AutoSize 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 BorderStyle BorderStyle 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 CanRaiseEvents CanRaiseEvents CanRaiseEvents

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

(Inherited from Component)
Container Container Container Container

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

(Inherited from Component)
DesignMode DesignMode DesignMode 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.

(Inherited from Component)
Events Events Events Events

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

(Inherited from Component)
Icon Icon Icon 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 MinWidth MinWidth 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 Name Name Name

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

Parent Parent Parent 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 Site Site Site

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

(Inherited from Component)
Style Style Style Style

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

Tag Tag Tag Tag

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

Text Text Text Text

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

ToolTipText ToolTipText ToolTipText 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 Width Width 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() BeginInit() BeginInit() BeginInit()

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

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

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

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

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

EndInit() EndInit() EndInit() EndInit()

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

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() 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.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) 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.

(Inherited from Component)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() 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.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
ToString() ToString() ToString() ToString()

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

Eventi

Disposed Disposed Disposed 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.

(Inherited from Component)

Si applica a

Vedi anche