StatusBar.ShowPanels Propriété

Définition

Obtient ou définit une valeur indiquant si les panneaux ajoutés au contrôle sont affichés.Gets or sets a value indicating whether any panels that have been added to the control are displayed.

public:
 property bool ShowPanels { bool get(); void set(bool value); };
public bool ShowPanels { get; set; }
member this.ShowPanels : bool with get, set
Public Property ShowPanels As Boolean

Valeur de propriété

true si les panneaux sont utilisés ; sinon, false.true if panels are displayed; otherwise, false. La valeur par défaut est false.The default is false.

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 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, 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

Par défaut, le contrôle StatusBar affiche la valeur de sa propriété Text sans aucun volet.By default, the StatusBar control displays the value of its Text property without any panels. Lorsque ShowPanels a la valeur true, tous les objets StatusBarPanel spécifiés dans le contrôle StatusBar sont affichés.When ShowPanels is set to true, any StatusBarPanel objects specified in the StatusBar control are displayed. Aucun panneau n’est initialement créé lorsque vous créez une instance de la classe StatusBar.No panels are initially created when you create an instance of the StatusBar class. Vous pouvez ajouter des panneaux à un contrôle StatusBar à l’aide de la méthode Add de la classe StatusBar.StatusBarPanelCollection.You can add panels to a StatusBar control by using the Add method of the StatusBar.StatusBarPanelCollection class. Cette classe de collection est accessible via la propriété Panels de StatusBar.This collection class can be accessed through the Panels property of StatusBar.

S’applique à

Voir aussi