StatusBarPanel Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

StatusBarPanel.cs

Attention

StatusBar is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use StatusStrip instead.

Représente un panneau dans un StatusBar contrôle.

Cette classe n’est pas disponible dans .NET 5 et versions ultérieures. Utilisez plutôt le ToolStripStatusLabel contrôle, qui remplace et étend le StatusBarPanel contrôle.

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

[System.ComponentModel.Browsable(false)]
[System.Obsolete("`StatusBar` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `StatusStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class StatusBarPanel : System.ComponentModel.Component, System.ComponentModel.ISupportInitialize

[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`StatusBar` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `StatusStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type StatusBarPanel = class
    inherit Component
    interface ISupportInitialize

Public Class StatusBarPanel
Inherits Component
Implements ISupportInitialize

Héritage

Object

MarshalByRefObject

Component

StatusBarPanel

Attributs

BrowsableAttribute ObsoleteAttribute

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 le texte 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 la Panels propriété pour accéder à la Add méthode de l’ajout StatusBar.StatusBarPanelCollection des panneaux au StatusBarpanneau . L’exemple utilise également les propriétés , BorderStyleet TextToolTipTextles 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

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

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

Les StatusBarPanel propriétés qui vous permettent de modifier le comportement d’affichage d’un panneau au sein d’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 pour ajuster le 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 de s’assurer qu’elle n’est pas plus petite que les données qu’elle est destinées à afficher.

Le StatusBar contrôle est généralement utilisé pour afficher des informations d’aide ou des informations d’état sur votre application. Il est souvent 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 dessin 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é est définie OwnerDrawsur , 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

Nom	Description
StatusBarPanel()	Obsolète. Initialise une nouvelle instance de la classe StatusBarPanel.

Propriétés

Nom	Description
Alignment	Obsolète. Obtient ou définit l’alignement du texte et des icônes dans le panneau de barre d’état.
AutoSize	Obsolète. Obtient ou définit une valeur indiquant si le panneau de barre d’état est automatiquement redimensionné.
BorderStyle	Obsolète. Obtient ou définit le style de bordure du panneau de barre d’état.
Icon	Obsolète. Obtient ou définit l’icône à afficher dans le panneau de barre d’état.
MinWidth	Obsolète. Obtient ou définit la largeur minimale autorisée du panneau de barre d’état dans le StatusBar contrôle.
Name	Obsolète. Obtient ou définit le nom à appliquer au StatusBarPanel.
Parent	Obsolète. Obtient le StatusBar contrôle qui héberge le panneau de barre d’état.
Style	Obsolète. Obtient ou définit le style du panneau de barre d’état.
Tag	Obsolète. Obtient ou définit un objet qui contient des données sur le StatusBarPanel.
Text	Obsolète. Obtient ou définit le texte du panneau de barre d’état.
ToolTipText	Obsolète. Obtient ou définit le texte info-bulle associé au panneau de barre d’état.
Width	Obsolète. Obtient ou définit la largeur du panneau de barre d’état dans le StatusBar contrôle.

Méthodes

Nom	Description
BeginInit()	Obsolète. Commence l’initialisation d’un StatusBarPanel.
EndInit()	Obsolète. Termine l’initialisation d’un StatusBarPanel.

Voir aussi

• StatusBarPanel