StatusBar.StatusBarPanelCollection Classe

Définition

Représente la collection de panneaux dans un contrôle StatusBar.Represents the collection of panels in a StatusBar control.

public: ref class StatusBar::StatusBarPanelCollection : System::Collections::IList
[System.ComponentModel.ListBindable(false)]
public class StatusBar.StatusBarPanelCollection : System.Collections.IList
public class StatusBar.StatusBarPanelCollection : System.Collections.IList
type StatusBar.StatusBarPanelCollection = class
    interface IList
    interface ICollection
    interface IEnumerable
Public Class StatusBar.StatusBarPanelCollection
Implements IList
Héritage
StatusBar.StatusBarPanelCollection
Attributs
Implémente

Exemples

L’exemple de code suivant crée un contrôle StatusBar sur un formulaire et ajoute deux objets StatusBarPanel.The following code example creates a StatusBar control on a form and adds two StatusBarPanel objects. L’une des StatusBarPanel, nommée panel1, affiche le texte d’état d’une application.One of the StatusBarPanel, named panel1, displays status text for an application. Le deuxième StatusBarPanel, nommé panel2, affiche la date actuelle et utilise la propriété ToolTipText de la classe StatusBarPanel pour afficher l’heure actuelle.The second StatusBarPanel, named panel2, displays the current date and uses the ToolTipText property of the StatusBarPanel class to display the current time. L’exemple utilise la propriété ShowPanels pour s’assurer que les panneaux sont affichés à la place d’un panneau standard et qu’il utilise et la propriété Panels pour accéder à la méthode Add de l' StatusBar.StatusBarPanelCollection pour ajouter les panneaux au StatusBar.The example uses the ShowPanels property to ensure that the panels are displayed instead of a standard panel, and it uses and the Panels property to access the Add method of the StatusBar.StatusBarPanelCollection to add the panels to the StatusBar. L’exemple utilise également les propriétés AutoSize, BorderStyle, ToolTipTextet Text pour initialiser les objets StatusBarPanel.The example also uses the AutoSize, BorderStyle, ToolTipText, and Text properties to initialize the StatusBarPanel objects. Cet exemple suppose que la méthode définie dans l’exemple est définie et appelée à partir du constructeur d’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

Remarques

La classe StatusBar.StatusBarPanelCollection stocke les panneaux affichés dans le StatusBar.The StatusBar.StatusBarPanelCollection class stores the panels displayed in the StatusBar. Chaque objet de la collection est une instance de la classe StatusBarPanel qui définit les caractéristiques d’affichage et les comportements d’un panneau affiché dans une StatusBar.Each object in the collection is an instance of the StatusBarPanel class which defines the display characteristics and behaviors of a panel displayed in a StatusBar.

Il existe plusieurs façons d’ajouter des panneaux à la collection.There are a number of ways to add panels to the collection. La méthode Add offre la possibilité d’ajouter un panneau unique à la collection.The Add method provides the ability to add a single panel to the collection. Pour ajouter un certain nombre de panneaux à la collection, vous créez un tableau d’objets StatusBarPanel et vous l’affectez à la méthode AddRange.To add a number of panels to the collection, you create an array of StatusBarPanel objects and assign it to the AddRange method. Si vous souhaitez insérer un panneau à un emplacement spécifique dans la collection, vous pouvez utiliser la méthode Insert.If you want to insert a panel at a specific location within the collection, you can use the Insert method. Pour supprimer des panneaux, vous pouvez utiliser la méthode Remove ou la méthode RemoveAt si vous savez où se trouve le panneau dans la collection.To remove panels, you can use either the Remove method or the RemoveAt method if you know where the panel is located within the collection. La méthode Clear vous permet de supprimer tous les panneaux de la collection au lieu d’utiliser la méthode Remove pour supprimer un seul panneau à la fois.The Clear method enables you to remove all panels from the collection instead of using the Remove method to remove a single panel at a time.

En plus des méthodes et des propriétés permettant d’ajouter et de supprimer des panneaux, le StatusBar.StatusBarPanelCollection fournit également des méthodes pour rechercher des panneaux dans la collection.In addition to methods and properties for adding and removing panels, the StatusBar.StatusBarPanelCollection also provides methods to find panels within the collection. La méthode Contains vous permet de déterminer si un panneau est membre de la collection.The Contains method enables you to determine whether a panel is a member of the collection. Une fois que vous savez que le volet se trouve dans la collection, vous pouvez utiliser la méthode IndexOf pour déterminer où se trouve le panneau dans la collection.Once you know that the panel is located within the collection, you can use the IndexOf method to determine where the panel is located within the collection.

Constructeurs

StatusBar.StatusBarPanelCollection(StatusBar)

Initialise une nouvelle instance de la classe StatusBar.StatusBarPanelCollection.Initializes a new instance of the StatusBar.StatusBarPanelCollection class.

Propriétés

Count

Obtient le nombre d'éléments dans la collection.Gets the number of items in the collection.

IsReadOnly

Obtient une valeur indiquant si la collection est en lecture seule.Gets a value indicating whether this collection is read-only.

Item[Int32]

Obtient ou définit le StatusBarPanel à l'index spécifié.Gets or sets the StatusBarPanel at the specified index.

Item[String]

Obtient un élément avec la clé spécifiée de la collection.Gets an item with the specified key from the collection.

Méthodes

Add(StatusBarPanel)

Ajoute un StatusBarPanel à la collection.Adds a StatusBarPanel to the collection.

Add(String)

Ajoute un StatusBarPanel contenant le texte spécifié à la collection.Adds a StatusBarPanel with the specified text to the collection.

AddRange(StatusBarPanel[])

Ajoute un tableau d'objets StatusBarPanel à la collection.Adds an array of StatusBarPanel objects to the collection.

Clear()

Supprime tous les éléments de la collection.Removes all items from the collection.

Contains(StatusBarPanel)

Indique si le panneau spécifié réside dans la collection.Determines whether the specified panel is located within the collection.

ContainsKey(String)

Détermine si la collection contient un StatusBarPanel avec la clé spécifiée.Determines whether the collection contains a StatusBarPanel with the specified key.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetEnumerator()

Retourne un énumérateur qui peut être utilisé pour itérer au sein de la collection d'éléments.Returns an enumerator to use to iterate through the item collection.

GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
IndexOf(StatusBarPanel)

Retourne l'index dans la collection du panneau spécifié.Returns the index within the collection of the specified panel.

IndexOfKey(String)

Retourne l'index de la première occurrence d'un StatusBarPanel avec la clé spécifiée.Returns the index of the first occurrence of a StatusBarPanel with the specified key.

Insert(Int32, StatusBarPanel)

Insère le StatusBarPanel spécifié dans la collection, à l'index spécifié.Inserts the specified StatusBarPanel into the collection at the specified index.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
Remove(StatusBarPanel)

Supprime l’objet StatusBarPanel spécifié de la collection.Removes the specified StatusBarPanel from the collection.

RemoveAt(Int32)

Supprime le StatusBarPanel situé à l'index spécifié dans la collection.Removes the StatusBarPanel located at the specified index within the collection.

RemoveByKey(String)

Supprime StatusBarPanel avec la clé spécifiée de la collection.Removes the StatusBarPanel with the specified key from the collection.

ToString()

Retourne une chaîne qui représente l'objet actif.Returns a string that represents the current object.

(Hérité de Object)

Implémentations d’interfaces explicites

ICollection.CopyTo(Array, Int32)

Copie StatusBar.StatusBarPanelCollection dans un tableau compatible unidimensionnel, en commençant à l'index spécifié du tableau cible.Copies the StatusBar.StatusBarPanelCollection to a compatible one-dimensional array, starting at the specified index of the target array.

ICollection.IsSynchronized

Obtient une valeur indiquant si l’accès à la collection est synchronisé (thread-safe).Gets a value indicating whether access to the collection is synchronized (thread safe).

ICollection.SyncRoot

Obtient un objet qui peut être utilisé pour synchroniser l’accès à la collection.Gets an object that can be used to synchronize access to the collection.

IList.Add(Object)

Ajoute un StatusBarPanel à la collection.Adds a StatusBarPanel to the collection.

IList.Contains(Object)

Indique si le panneau spécifié réside dans la collection.Determines whether the specified panel is located within the collection.

IList.IndexOf(Object)

Retourne l'index du panneau spécifié dans la collection.Returns the index of the specified panel within the collection.

IList.Insert(Int32, Object)

Insère le StatusBarPanel spécifié dans la collection, à l'index spécifié.Inserts the specified StatusBarPanel into the collection at the specified index.

IList.IsFixedSize

Obtient une valeur indiquant si la collection est de taille fixe.Gets a value indicating whether the collection has a fixed size.

IList.Item[Int32]

Obtient ou définit l'élément au niveau de l'index spécifié.Gets or sets the element at the specified index.

IList.Remove(Object)

Supprime l’objet StatusBarPanel spécifié de la collection.Removes the specified StatusBarPanel from the collection.

Méthodes d’extension

Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Active la parallélisation d'une requête.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

S’applique à

Voir aussi