StatusBarPanel StatusBarPanel StatusBarPanel StatusBarPanel Class

Définition

Représente un panneau dans un contrôle StatusBar.Represents a panel in a StatusBar control. Bien que le contrôle StatusStrip remplace et ajoute des fonctionnalités au contrôle StatusBar des versions antérieures, StatusBar est conservé pour la compatibilité descendante et l'utilisation future si tel est votre choix.Although the StatusStrip control replaces and adds functionality to the StatusBar control of previous versions, StatusBar is retained for both backward compatibility and future use if you choose.

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
Implémente

Exemples

L’exemple de code suivant crée StatusBar un contrôle sur un formulaire et ajoute StatusBarPanel deux objets.The following code example creates a StatusBar control on a form and adds two StatusBarPanel objects. Le premier StatusBarPanel, nommé panel1, affiche le texte d’état d’une application.The first StatusBarPanel, named panel1, displays status text for an application. La seconde StatusBarPanel, nommée panel2, affiche la date actuelle et utilise la ToolTipText propriété de la StatusBarPanel classe 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 ShowPanels propriété pour s’assurer que les panneaux sont affichés à la place d’un panneau standard et qu' Panels il utilise la propriété Add pour StatusBar.StatusBarPanelCollection accéder à la méthode StatusBardu pour ajouter les panneaux à.The example uses the ShowPanels property to ensure that the panels are displayed instead of a standard panel, and it uses the Panels property to access the Add method of the StatusBar.StatusBarPanelCollection to add the panels to the StatusBar. L’exemple utilise également les AutoSizepropriétés BorderStyle ToolTipText,, et Text pour initialiser les StatusBarPanel objets.The example also uses the AutoSize, BorderStyle, ToolTipText, and Text properties to initialize the StatusBarPanel objects. Cet exemple suppose que la méthode définie dans l’exemple est définie et appelée à partir du constructeur d’un Form.This example assumes 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

Un StatusBarPanel représente un panneau individuel dans le StatusBar.StatusBarPanelCollection d’un StatusBar contrôle.A StatusBarPanel represents an individual panel in the StatusBar.StatusBarPanelCollection of a StatusBar control. Un StatusBarPanel peut contenir du texte et/ou une icône qui peut être utilisée pour refléter l’état d’une application.A StatusBarPanel can contain text and/or an icon that can be used to reflect the status of an 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.Use the StatusBar.StatusBarPanelCollection, accessible through the StatusBar.Panels property of a StatusBar control, to retrieve, add, or remove an individual StatusBarPanel.

Fournit des propriétés qui vous permettent de modifier le comportement d’affichage d’un panneau dans StatusBar un contrôle. StatusBarPanelThe StatusBarPanel provides properties that enable you to modify the display behavior of a panel within a StatusBar control. Vous pouvez utiliser la Icon propriété pour afficher une icône dans un panneau.You can use the Icon property to display an icon within a panel. Cette propriété peut être utilisée pour fournir une représentation graphique de l’État dans une application.This property can be used to provide a graphical representation of state in an application. La Alignment propriété vous permet de spécifier l’alignement du texte et/ou de l’icône dans le panneau.The Alignment property enables you to specify how text and/or an icon is aligned within the panel. Pour vous assurer que votre panneau est correctement dimensionné pour s’ajuster au texte du panneau, vous pouvez utiliser AutoSize la propriété pour redimensionner automatiquement le panneau afin qu’il corresponde au texte du panneau ou pour remplir l' StatusBar espace restant dans le contrôle.To ensure that your panel is sized properly to fit the text of the panel, you can use the AutoSize property to automatically resize the panel to fit the text of the panel or to fill the remaining space within the StatusBar control. La MinWidth propriété vous permet de spécifier une largeur minimale pour le panneau afin de garantir qu’il n’est pas plus petit que les données qu’il est censé afficher.The MinWidth property enables you to specify a minimum width for the panel to ensure that it does not get smaller than the data it is intended to display.

Le StatusBar contrôle est généralement utilisé pour afficher des informations d’aide ou des informations d’État sur votre application.The StatusBar control is typically used to display Help information or state information about your application. Souvent, il est important d’afficher des informations supplémentaires sur les données présentées dans un panneau.Often, it is important to display additional information about data that is presented in a panel. Vous pouvez utiliser la ToolTipText propriété pour afficher des informations chaque fois que le pointeur de la souris se trouve sur un panneau.You can use the ToolTipText property to display information whenever the mouse pointer rests on a panel.

Bien que StatusBar le contrôle soit généralement utilisé pour afficher des informations textuelles, vous pouvez également fournir votre propre type d' StatusBarPanelaffichage à un.Although the StatusBar control is typically used to display textual information, you can also provide your own type of display to a StatusBarPanel. La Style propriété vous permet de spécifier la façon StatusBarPanel dont le sera dessiné.The Style property enables you to specify how the StatusBarPanel will be drawn. 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 Icon dans la propriété).By default, the Style property is used to display the value of the Text property (and an icon, if specified in the Icon property). Si la propriété a la valeur OwnerDraw, vous pouvez dessiner vos propres informations dans le panneau.If the property is set to OwnerDraw, you can draw your own information into the panel. Vous pouvez utiliser cette fonctionnalité pour dessiner une barre de progression ou une icône animée dans le panneau.You can use this feature to draw a progress bar or an animated icon in the panel.

Lorsque vous créez une instance de la StatusBarPanel classe, les propriétés en lecture/écriture sont définies sur les valeurs initiales.When you create an instance of the StatusBarPanel class, the read/write properties are set to initial values. Pour obtenir la liste de ces valeurs, consultez StatusBarPanel le constructeur.For a list of these values, see the StatusBarPanel constructor.

Constructeurs

StatusBarPanel() StatusBarPanel() StatusBarPanel() StatusBarPanel()

Initialise une nouvelle instance de la classe StatusBarPanel.Initializes a new instance of the StatusBarPanel class.

Propriétés

Alignment Alignment Alignment Alignment

Obtient ou définit l’alignement du texte et des icônes dans le panneau de la barre d’état.Gets or sets the alignment of text and icons within the status bar panel.

AutoSize AutoSize AutoSize AutoSize

Récupère ou définit une valeur indiquant si le panneau de barre d’état est automatiquement redimensionné.Gets or sets a value indicating whether the status bar panel is automatically resized.

BorderStyle BorderStyle BorderStyle BorderStyle

Obtient ou définit le style de bordure du panneau de la barre d'état.Gets or sets the border style of the status bar panel.

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Obtient une valeur qui indique si le composant peut déclencher un événement.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Container Container Container Container

Obtient le IContainer qui contient Component.Gets the IContainer that contains the Component.

(Inherited from Component)
DesignMode DesignMode DesignMode DesignMode

Obtient une valeur qui indique si Component est actuellement en mode design.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Obtient la liste des gestionnaires d'événements attachés à ce Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Icon Icon Icon Icon

Obtient ou définit l'icône afin qu'elle s'affiche dans le panneau de la barre d'état.Gets or sets the icon to display within the status bar panel.

MinWidth MinWidth MinWidth MinWidth

Obtient ou définit la largeur minimale autorisée du panneau de la barre d'état dans le contrôle StatusBar.Gets or sets the minimum allowed width of the status bar panel within the StatusBar control.

Name Name Name Name

Obtient ou définit le nom à appliquer au StatusBarPanel.Gets or sets the name to apply to the StatusBarPanel.

Parent Parent Parent Parent

Obtient le contrôle StatusBar qui héberge le panneau de la barre d'état.Gets the StatusBar control that hosts the status bar panel.

Site Site Site Site

Obtient ou définit le ISite de Component.Gets or sets the ISite of the Component.

(Inherited from Component)
Style Style Style Style

Obtient ou définit le style du panneau de la barre d'état.Gets or sets the style of the status bar panel.

Tag Tag Tag Tag

Obtient ou définit un objet qui contient les données relatives à StatusBarPanel.Gets or sets an object that contains data about the StatusBarPanel.

Text Text Text Text

Obtient ou définit le texte du panneau de la barre d'état.Gets or sets the text of the status bar panel.

ToolTipText ToolTipText ToolTipText ToolTipText

Obtient ou définit le texte info-bulle associé au panneau de la barre d'état.Gets or sets ToolTip text associated with the status bar panel.

Width Width Width Width

Obtient ou définit la largeur du panneau de la barre d'état dans le contrôle StatusBar.Gets or sets the width of the status bar panel within the StatusBar control.

Méthodes

BeginInit() BeginInit() BeginInit() BeginInit()

Commence l'initialisation d'un StatusBarPanel.Begins the initialization of a StatusBarPanel.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Libère toutes les ressources utilisées par Component.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libère les ressources non managées utilisées par StatusBarPanel et libère éventuellement les ressources managées.Releases the unmanaged resources used by the StatusBarPanel and optionally releases the managed resources.

EndInit() EndInit() EndInit() EndInit()

Termine l'initialisation d'un StatusBarPanel.Ends the initialization of a StatusBarPanel.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

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.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Retourne un objet qui représente un service fourni par Component ou par son Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
ToString() ToString() ToString() ToString()

Récupère une chaîne qui contient des informations relatives au panneau.Retrieves a string that contains information about the panel.

Événements

Disposed Disposed Disposed Disposed

Se produit lorsque le composant est supprimé par un appel à la méthode Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

S’applique à

Voir aussi