StatusBar.StatusBarPanelCollection Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Représente la collection de panneaux dans un contrôle 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

Héritage

Object

StatusBar.StatusBarPanelCollection

Attributs

ListBindableAttribute

Implémente

ICollection IEnumerable IList

Exemples

L’exemple de code suivant crée un StatusBar contrôle sur un formulaire et ajoute deux StatusBarPanel objets. L’un des éléments nommés panel1affiche le StatusBarPaneltexte d’état d’une application. Le deuxième StatusBarPanel, nommé panel2, affiche la date actuelle et utilise la ToolTipText propriété de la StatusBarPanel classe pour afficher l’heure actuelle. L’exemple utilise la ShowPanels propriété pour s’assurer que les panneaux sont affichés au lieu d’un panneau standard, et qu’il utilise et la Panels propriété pour accéder à la Add méthode de l’élément StatusBar.StatusBarPanelCollection pour ajouter les panneaux au StatusBar. L’exemple utilise également les propriétés , BorderStyleet Text ToolTipTextles AutoSizepropriétés pour initialiser les StatusBarPanel objets. Cet exemple suppose que la méthode définie dans l’exemple est définie et appelée à partir du constructeur d’un 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 le 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 un StatusBar.

Il existe plusieurs façons d’ajouter des panneaux à la collection. La Add méthode permet d’ajouter un seul panneau à la collection. Pour ajouter un certain nombre de panneaux à la collection, vous créez un tableau d’objets StatusBarPanel et affectez-le à la AddRange méthode. Si vous souhaitez insérer un panneau à un emplacement spécifique dans la collection, vous pouvez utiliser la Insert méthode. Pour supprimer des panneaux, vous pouvez utiliser la Remove méthode ou la RemoveAt méthode si vous savez où se trouve le panneau dans la collection. La Clear méthode vous permet de supprimer tous les panneaux de la collection au lieu d’utiliser la Remove méthode pour supprimer un seul panneau à la fois.

Outre les méthodes et les propriétés permettant d’ajouter et de supprimer des panneaux, les StatusBar.StatusBarPanelCollection méthodes permettent également de rechercher des panneaux dans la collection. La Contains méthode vous permet de déterminer si un panneau est membre de la collection. Une fois que vous savez que le panneau se trouve dans la collection, vous pouvez utiliser la IndexOf méthode pour déterminer l’emplacement du panneau dans la collection.

Constructeurs

StatusBar.StatusBarPanelCollection(StatusBar)

Initialise une nouvelle instance de la classe StatusBar.StatusBarPanelCollection.

Propriétés

Count	Obtient le nombre d’éléments de la collection.
IsReadOnly	Obtient une valeur indiquant si la collection est en lecture seule.
Item[Int32]	Obtient ou définit le StatusBarPanel à l'index spécifié.
Item[String]	Obtient un élément avec la clé spécifiée de la collection.

Méthodes

Add(StatusBarPanel)	Ajoute un StatusBarPanel à la collection.
Add(String)	Ajoute un StatusBarPanel contenant le texte spécifié à la collection.
AddRange(StatusBarPanel[])	Ajoute un tableau d'objets StatusBarPanel à la collection.
Clear()	Supprime tous les éléments de la collection.
Contains(StatusBarPanel)	Indique si le panneau spécifié réside dans la collection.
ContainsKey(String)	Détermine si la collection contient un StatusBarPanel avec la clé spécifiée.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetEnumerator()	Retourne un énumérateur qui peut être utilisé pour itérer au sein de la collection d'éléments.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IndexOf(StatusBarPanel)	Retourne l'index dans la collection du panneau spécifié.
IndexOfKey(String)	Retourne l'index de la première occurrence d'un StatusBarPanel avec la clé spécifiée.
Insert(Int32, StatusBarPanel)	Insère le StatusBarPanel spécifié dans la collection, à l'index spécifié.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Remove(StatusBarPanel)	Supprime l’objet StatusBarPanel spécifié de la collection.
RemoveAt(Int32)	Supprime le StatusBarPanel situé à l'index spécifié dans la collection.
RemoveByKey(String)	Supprime StatusBarPanel avec la clé spécifiée de la collection.
ToString()	Retourne une chaîne qui représente l'objet actuel. (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.
ICollection.IsSynchronized	Obtient une valeur indiquant si l’accès à la collection est synchronisé (thread-safe).
ICollection.SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l’accès à la collection.
IList.Add(Object)	Cette API prend en charge l'infrastructure du produit et n'est pas destinée à être utilisée directement à partir de votre code. Ajoute un StatusBarPanel à la collection.
IList.Contains(Object)	Indique si le panneau spécifié réside dans la collection.
IList.IndexOf(Object)	Retourne l'index du panneau spécifié dans la collection.
IList.Insert(Int32, Object)	Insère le StatusBarPanel spécifié dans la collection, à l'index spécifié.
IList.IsFixedSize	Obtient une valeur indiquant si la collection est de taille fixe.
IList.Item[Int32]	Obtient ou définit l'élément au niveau de l'index spécifié.
IList.Remove(Object)	Supprime l’objet StatusBarPanel spécifié de la collection.

Méthodes d’extension

Cast<TResult>(IEnumerable)	Effectue un cast des éléments d'un IEnumerable vers le type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d'un IEnumerable en fonction du type spécifié.
AsParallel(IEnumerable)	Active la parallélisation d'une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.

Voir aussi

• StatusBarPanel