StatusBarPanel Classe

Définition

public ref class StatusBarPanel : System::ComponentModel::Component, System::ComponentModel::ISupportInitialize

public class StatusBarPanel : System.ComponentModel.Component, System.ComponentModel.ISupportInitialize

type StatusBarPanel = class
    inherit Component
    interface ISupportInitialize

Public Class StatusBarPanel
Inherits Component
Implements ISupportInitialize

Héritage

Object

MarshalByRefObject

Component

StatusBarPanel

Implémente

ISupportInitialize

Exemples

L’exemple de code suivant crée un StatusBar contrôle sur un formulaire et ajoute deux StatusBarPanel objets. Le premier StatusBarPanel, nommé panel1, affiche status texte pour 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 il utilise la Panels propriété pour accéder à la Add méthode de pour StatusBar.StatusBarPanelCollection ajouter les panneaux au StatusBar. L’exemple utilise également les AutoSizepropriétés , BorderStyle, ToolTipTextet Text 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

Cette classe n’est pas disponible dans .NET 5 et versions ultérieures. Utilisez le contrôle à la ToolStripStatusLabel place.

Un StatusBarPanel représente un panneau individuel dans le StatusBar.StatusBarPanelCollection d’un StatusBar contrôle. Un StatusBarPanel peut contenir du texte et/ou une icône qui peut être utilisé pour refléter la status d’une application. Utilisez , StatusBar.StatusBarPanelCollectionaccessible via la StatusBar.Panels propriété d’un StatusBar contrôle , pour récupérer, ajouter ou supprimer un individu StatusBarPanel.

Fournit StatusBarPanel des propriétés qui vous permettent de modifier le comportement d’affichage d’un panneau dans un StatusBar contrôle. Vous pouvez utiliser la Icon propriété pour afficher une icône dans un panneau. Cette propriété peut être utilisée pour fournir une représentation graphique de l’état dans une application. La Alignment propriété vous permet de spécifier la façon dont le texte et/ou une icône sont alignés dans le panneau. Pour vous assurer que votre panneau est correctement dimensionné pour s’adapter au texte du panneau, vous pouvez utiliser la AutoSize propriété pour redimensionner automatiquement le panneau en fonction du texte du panneau ou pour remplir l’espace restant dans le StatusBar contrôle. La MinWidth propriété vous permet de spécifier une largeur minimale pour le panneau afin qu’il ne soit pas plus petit que les données qu’il est destiné à afficher.

Le StatusBar contrôle est généralement utilisé pour afficher des informations d’aide ou des informations d’état sur votre application. Souvent, il est important d’afficher des informations supplémentaires sur les données présentées dans un panneau. Vous pouvez utiliser la ToolTipText propriété pour afficher des informations chaque fois que le pointeur de la souris se trouve sur un panneau.

Bien que le StatusBar contrôle soit généralement utilisé pour afficher des informations textuelles, vous pouvez également fournir votre propre type d’affichage à un StatusBarPanel. La Style propriété vous permet de spécifier la façon dont le StatusBarPanel sera dessiné. Par défaut, la Style propriété est utilisée pour afficher la valeur de la Text propriété (et une icône, si elle est spécifiée dans la Icon propriété ). Si la propriété a la OwnerDrawvaleur , vous pouvez dessiner vos propres informations dans le panneau. Vous pouvez utiliser cette fonctionnalité pour dessiner une barre de progression ou une icône animée dans le panneau.

Lorsque vous créez une instance de la StatusBarPanel classe, les propriétés en lecture/écriture sont définies sur les valeurs initiales. Pour obtenir la liste de ces valeurs, consultez le StatusBarPanel constructeur.

Constructeurs

Propriétés

Méthodes

Événements

S’applique à

Voir aussi

• StatusBarPanel