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
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 StatusBar un contrôle sur un formulaire et ajoute StatusBarPanel deux objets.The following code example creates a StatusBar control on a form and adds two StatusBarPanel objects. L’une des StatusBarPanel, nommées panel1, affiche le texte d’état d’une application.One of the StatusBarPanel, named panel1, displays status text for an application. La seconde StatusBarPanel, nommée panel2, affiche la date actuelle et utilise la ToolTipText propriété de la StatusBarPanel classe 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 ShowPanels propriété pour s’assurer que les panneaux sont affichés à la place d’un panneau standard, et utilise Panels et la propriété pour Add StatusBar.StatusBarPanelCollection accéder à la méthode StatusBardu pour ajouter les panneaux à.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 AutoSizepropriétés BorderStyle ToolTipText,, et Text pour initialiser les StatusBarPanel objets.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 StatusBar.StatusBarPanelCollection classe stocke les panneaux affichés dans StatusBarle.The StatusBar.StatusBarPanelCollection class stores the panels displayed in the StatusBar. Chaque objet de la collection est une instance de la StatusBarPanel classe qui définit les caractéristiques d’affichage et les comportements d’un panneau affiché dans StatusBarun.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 Add méthode 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 StatusBarPanel d’objets et vous l’affectez à la AddRange méthode.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 Insert méthode.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 Remove méthode ou la RemoveAt méthode si vous savez où le panneau se trouve 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 Clear méthode vous permet de supprimer tous les panneaux de la collection au lieu d' Remove utiliser la méthode 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 pour l’ajout et la suppression StatusBar.StatusBarPanelCollection de panneaux, le 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 Contains méthode 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 IndexOf utiliser la méthode 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 de 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 identique à 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()

Fait office 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 de l'objet 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 actuel.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