StatusBar.Panels Propriété

Définition

Obtient la collection des panneaux StatusBar contenus dans la classe.Gets the collection of StatusBar panels contained within the control.

public:
 property System::Windows::Forms::StatusBar::StatusBarPanelCollection ^ Panels { System::Windows::Forms::StatusBar::StatusBarPanelCollection ^ get(); };
public System.Windows.Forms.StatusBar.StatusBarPanelCollection Panels { get; }
member this.Panels : System.Windows.Forms.StatusBar.StatusBarPanelCollection
Public ReadOnly Property Panels As StatusBar.StatusBarPanelCollection

Valeur de propriété

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’un des objets StatusBarPanel, nommé panel1, affiche le texte d’état d’une application.One of the StatusBarPanel objects, named panel1, displays status text for an application. Le deuxième objet 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 object, 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, ToolTipText et Text pour initialiser les objets StatusBarPanel.The example also uses the AutoSize, BorderStyle, ToolTipText, and Text properties to initialize the StatusBarPanel objects. Cet exemple requiert que la méthode définie dans l’exemple soit définie et appelée à partir du constructeur d’un Form.This example requires 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

Le contrôle StatusBar peut afficher un certain nombre de panneaux pour fournir des informations à l’utilisateur de votre application.The StatusBar control can display a number of panels to provide information to the user of your application. Par exemple, un panneau peut afficher l’heure actuelle ou la progression du téléchargement d’un fichier.For example, a panel could display the current time or the progress of a file download. Chaque panneau affiché par le contrôle StatusBar est une instance de la classe StatusBarPanel.Each panel displayed by the StatusBar control is an instance of the StatusBarPanel class. La propriété Panels vous permet d’obtenir une référence à la collection d’objets StatusBarPanel actuellement stockés dans le contrôle StatusBar.The Panels property enables you to obtain a reference to the collection of StatusBarPanel objects that are currently stored in the StatusBar control. Grâce à cette référence, vous pouvez ajouter des panneaux, supprimer des panneaux, accéder à un panneau spécifique dans la collection et obtenir le nombre de panneaux dans le contrôle StatusBar.With this reference, you can add panels, remove panels, access a specific panel within the collection, and obtain a count of the panels in the StatusBar control. Pour plus d’informations sur les tâches qui peuvent être effectuées avec la collection de volets, consultez les rubriques de référence sur les classes StatusBar.StatusBarPanelCollection.For more information on the tasks that can be performed with the panel collection, see the StatusBar.StatusBarPanelCollection class reference topics.

S’applique à

Voir aussi