StatusBarPanel Classe

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

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

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

StatusBarPanel()

Initialise une nouvelle instance de la classe StatusBarPanel.

Propriétés

Alignment	Obtient ou définit l’alignement du texte et des icônes dans le panneau de la barre d’état.
AutoSize	Récupère ou définit une valeur indiquant si le panneau de barre d’état est automatiquement redimensionné.
BorderStyle	Obtient ou définit le style de bordure du panneau de la barre d'état.
CanRaiseEvents	Obtient une valeur qui indique si le composant peut déclencher un événement. (Hérité de Component)
Container	Obtient le IContainer qui contient la Component. (Hérité de Component)
DesignMode	Obtient une valeur qui indique si Component est actuellement en mode design. (Hérité de Component)
Events	Obtient la liste des gestionnaires d'événements attachés à ce Component. (Hérité de Component)
Icon	Obtient ou définit l'icône afin qu'elle s'affiche dans le panneau de la barre d'état.
MinWidth	Obtient ou définit la largeur minimale autorisée du panneau de la barre d'état dans le contrôle StatusBar.
Name	Obtient ou définit le nom à appliquer au StatusBarPanel.
Parent	Obtient le contrôle StatusBar qui héberge le panneau de la barre d'état.
Site	Obtient ou définit le ISite de Component. (Hérité de Component)
Style	Obtient ou définit le style du panneau de la barre d'état.
Tag	Obtient ou définit l’objet qui contient les données relatives au StatusBarPanel.
Text	Obtient ou définit le texte du panneau de la barre d'état.
ToolTipText	Obtient ou définit le texte info-bulle associé au panneau de la barre d'état.
Width	Obtient ou définit la largeur du panneau de la barre d'état dans le contrôle StatusBar.

Méthodes

BeginInit()	Commence l'initialisation d'un StatusBarPanel.
CreateObjRef(Type)	Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Libère toutes les ressources utilisées par Component. (Hérité de Component)
Dispose(Boolean)	Libère les ressources non managées utilisées par StatusBarPanel et libère éventuellement les ressources managées.
EndInit()	Termine l'initialisation d'un StatusBarPanel.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Obsolète. Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetService(Type)	Retourne un objet qui représente un service fourni par Component ou par son Container. (Hérité de Component)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obsolète. Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
ToString()	Récupère une chaîne qui contient des informations relatives au panneau.

Événements

Disposed

Se produit lorsque le composant est supprimé par un appel à la méthode Dispose().

(Hérité de Component)

S’applique à

Voir aussi

StatusBarPanel