StatusBar.StatusBarPanelCollection Classe

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Rappresenta la raccolta dei pannelli in un controllo StatusBar.

public: ref class StatusBar::StatusBarPanelCollection : System::Collections::IList

public class StatusBar.StatusBarPanelCollection : System.Collections.IList

[System.ComponentModel.ListBindable(false)]
public class StatusBar.StatusBarPanelCollection : System.Collections.IList

type StatusBar.StatusBarPanelCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

[<System.ComponentModel.ListBindable(false)>]
type StatusBar.StatusBarPanelCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

Public Class StatusBar.StatusBarPanelCollection
Implements IList

Ereditarietà

Object

StatusBar.StatusBarPanelCollection

Attributi

ListBindableAttribute

Implementazioni

ICollection IEnumerable IList

Esempio

Nell'esempio di codice seguente viene creato un StatusBar controllo in una maschera e vengono aggiunti due StatusBarPanel oggetti . Uno di 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 e 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

La StatusBar.StatusBarPanelCollection classe archivia i pannelli visualizzati in StatusBar. Ogni oggetto nella raccolta è un'istanza della StatusBarPanel classe che definisce le caratteristiche di visualizzazione e i comportamenti di un pannello visualizzato in un oggetto StatusBar.

Esistono diversi modi per aggiungere pannelli alla raccolta. Il Add metodo consente di aggiungere un singolo pannello alla raccolta. Per aggiungere un numero di pannelli all'insieme, creare una matrice di StatusBarPanel oggetti e assegnarla al AddRange metodo . Se si vuole inserire un pannello in una posizione specifica all'interno della raccolta, è possibile usare il Insert metodo . Per rimuovere i pannelli, è possibile usare il metodo o il Remove RemoveAt metodo se si sa dove si trova il pannello all'interno della raccolta. Il Clear metodo consente di rimuovere tutti i pannelli dalla raccolta anziché usare il Remove metodo per rimuovere un singolo pannello alla volta.

Oltre ai metodi e alle proprietà per l'aggiunta e la rimozione di pannelli, fornisce StatusBar.StatusBarPanelCollection anche metodi per trovare i pannelli all'interno della raccolta. Il Contains metodo consente di determinare se un pannello è un membro della raccolta. Dopo aver appreso che il pannello si trova all'interno della raccolta, è possibile usare il IndexOf metodo per determinare dove si trova il pannello all'interno della raccolta.

Costruttori

StatusBar.StatusBarPanelCollection(StatusBar)

Inizializza una nuova istanza della classe StatusBar.StatusBarPanelCollection.

Proprietà

Count	Ottiene il numero di elementi nella raccolta.
IsReadOnly	Ottiene un valore che indica se la raccolta è di sola lettura.
Item[Int32]	Ottiene o imposta l'oggetto StatusBarPanel in corrispondenza dell'indice specificato.
Item[String]	Ottiene un elemento con la chiave specificata dalla raccolta.

Metodi

Add(StatusBarPanel)	Aggiunge un oggetto StatusBarPanel alla raccolta.
Add(String)	Aggiunge un oggetto StatusBarPanel con il testo specificato all'insieme.
AddRange(StatusBarPanel[])	Aggiunge una matrice di oggetti StatusBarPanel all'insieme.
Clear()	Rimuove tutti gli elementi dalla raccolta.
Contains(StatusBarPanel)	Determina se il pannello specificato si trova all'interno dell'insieme.
ContainsKey(String)	Determina se l'insieme contiene un oggetto StatusBarPanel con la chiave specificata.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetEnumerator()	Restituisce un enumeratore da utilizzare per scorrere l'insieme degli elementi.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IndexOf(StatusBarPanel)	Restituisce l'indice del pannello specificato all'interno dell'insieme.
IndexOfKey(String)	Restituisce l'indice della prima occorrenza dell'oggetto StatusBarPanel con la chiave specificata.
Insert(Int32, StatusBarPanel)	Inserisce l'oggetto StatusBarPanel specificato nell'insieme in corrispondenza dell'indice specificato.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Remove(StatusBarPanel)	Rimuove l'oggetto StatusBarPanel specificato dalla raccolta.
RemoveAt(Int32)	Rimuove l'oggetto StatusBarPanel posizionato in corrispondenza dell'indice specificato all'interno dell'insieme.
RemoveByKey(String)	Rimuove l'elemento StatusBarPanel con la chiave specificata dall'insieme.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

ICollection.CopyTo(Array, Int32)	Consente di copiare l'oggetto StatusBar.StatusBarPanelCollection in una matrice compatibile unidimensionale, a partire dall'indice specificato della matrice di destinazione.
ICollection.IsSynchronized	Ottiene un valore che indica se l'accesso alla raccolta è sincronizzato (thread-safe).
ICollection.SyncRoot	Ottiene un oggetto che può essere usato per sincronizzare l'accesso alla raccolta.
IList.Add(Object)	Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice. Aggiunge un oggetto StatusBarPanel alla raccolta.
IList.Contains(Object)	Determina se il pannello specificato si trova all'interno dell'insieme.
IList.IndexOf(Object)	Restituisce l'indice del pannello specificato all'interno dell'insieme.
IList.Insert(Int32, Object)	Inserisce l'oggetto StatusBarPanel specificato nell'insieme in corrispondenza dell'indice specificato.
IList.IsFixedSize	Ottiene un valore che indica se la dimensione della raccolta è fissa.
IList.Item[Int32]	Ottiene o imposta l'elemento in corrispondenza dell'indice specificato.
IList.Remove(Object)	Rimuove l'oggetto StatusBarPanel specificato dalla raccolta.

Metodi di estensione

Cast<TResult>(IEnumerable)	Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.
OfType<TResult>(IEnumerable)	Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.
AsParallel(IEnumerable)	Consente la parallelizzazione di una query.
AsQueryable(IEnumerable)	Converte un oggetto IEnumerable in un oggetto IQueryable.

Vedi anche

• StatusBarPanel