StatusBarPanel Класс

Определение

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

Наследование

Object

MarshalByRefObject

Component

StatusBarPanel

Реализации

ISupportInitialize

Примеры

В следующем примере кода создается StatusBar элемент управления в форме и добавляются два StatusBarPanel объекта.The following code example creates a StatusBar control on a form and adds two StatusBarPanel objects. Первый StatusBarPanel , названный panel1 , отображает текст состояния для приложения.The first StatusBarPanel, named panel1, displays status text for an application. Вторая StatusBarPanel , с именем panel2 , отображает текущую дату и использует ToolTipText свойство StatusBarPanel класса для отображения текущего времени.The second StatusBarPanel, named panel2, displays the current date and uses the ToolTipText property of the StatusBarPanel class to display the current time. В примере используется ShowPanels свойство, чтобы убедиться, что панели отображаются вместо стандартной панели, и использует Panels свойство для доступа к Add методу, чтобы StatusBar.StatusBarPanelCollection Добавить панели в StatusBar .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. В примере также используются AutoSize свойства, BorderStyle , ToolTipText и Text для инициализации StatusBarPanel объектов.The example also uses the AutoSize, BorderStyle, ToolTipText, and Text properties to initialize the StatusBarPanel objects. В этом примере предполагается, что метод, определенный в примере, определяется и вызывается из конструктора 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

Комментарии

Этот класс недоступен в .NET 5,0 и более поздних версиях.This class is not available in .NET 5.0 and later versions. Вместо этого используйте элемент управления.Use the control instead.

StatusBarPanelПредставляет отдельную панель в элементе StatusBar.StatusBarPanelCollection StatusBar управления.A StatusBarPanel represents an individual panel in the StatusBar.StatusBarPanelCollection of a StatusBar control. StatusBarPanelМожет содержать текст и (или) значок, который можно использовать для отражения состояния приложения.A StatusBarPanel can contain text and/or an icon that can be used to reflect the status of an application. Используйте объект StatusBar.StatusBarPanelCollection , доступный через StatusBar.Panels свойство StatusBar элемента управления для получения, добавления или удаления отдельного объекта StatusBarPanel .Use the StatusBar.StatusBarPanelCollection, accessible through the StatusBar.Panels property of a StatusBar control, to retrieve, add, or remove an individual StatusBarPanel.

StatusBarPanelПредоставляет свойства, позволяющие изменять поведение экрана панели внутри StatusBar элемента управления.The StatusBarPanel provides properties that enable you to modify the display behavior of a panel within a StatusBar control. Свойство можно использовать Icon для вывода значка на панели.You can use the Icon property to display an icon within a panel. Это свойство может использоваться для предоставления графического представления состояния в приложении.This property can be used to provide a graphical representation of state in an application. AlignmentСвойство позволяет указать, как текст и/или значок выровняйтеся внутри панели.The Alignment property enables you to specify how text and/or an icon is aligned within the panel. Чтобы размеры панели правильно соответствовали размеру текста панели, можно использовать AutoSize свойство, чтобы автоматически изменить размер панели в соответствии с текстом панели или заполнить оставшееся пространство внутри StatusBar элемента управления.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. MinWidthСвойство позволяет задать минимальную ширину панели, чтобы она не превышала данные, которые она должна отображать.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.

StatusBarЭлемент управления обычно используется для отображения справочной информации или сведений о состоянии приложения.The StatusBar control is typically used to display Help information or state information about your application. Часто важно отображать дополнительные сведения о данных, представленных на панели.Often, it is important to display additional information about data that is presented in a panel. Свойство можно использовать ToolTipText для вывода сведений при каждом помещении указателя мыши на панель.You can use the ToolTipText property to display information whenever the mouse pointer rests on a panel.

Хотя StatusBar элемент управления обычно используется для вывода текстовых данных, можно также предоставить собственный тип дисплея StatusBarPanel .Although the StatusBar control is typically used to display textual information, you can also provide your own type of display to a StatusBarPanel. StyleСвойство позволяет указать, как StatusBarPanel будет отображаться.The Style property enables you to specify how the StatusBarPanel will be drawn. По умолчанию Style свойство используется для вывода значения Text Свойства (и значка, если он указан в Icon свойстве).By default, the Style property is used to display the value of the Text property (and an icon, if specified in the Icon property). Если свойство имеет значение OwnerDraw , вы можете нарисовать собственную информацию на панели.If the property is set to OwnerDraw, you can draw your own information into the panel. С помощью этой функции можно нарисовать индикатор выполнения или анимированный значок на панели.You can use this feature to draw a progress bar or an animated icon in the panel.

При создании экземпляра StatusBarPanel класса свойства чтения и записи устанавливаются в начальные значения.When you create an instance of the StatusBarPanel class, the read/write properties are set to initial values. Список этих значений см. в конструкторе StatusBarPanel.For a list of these values, see the StatusBarPanel constructor.

Конструкторы

Свойства

Методы

События

Применяется к

См. также раздел

• StatusBarPanel