StatusBarPanel Класс

Определение

Представляет панель элемента управления StatusBar.Represents a panel in a StatusBar control. Хотя элемент управления StatusStrip заменяет элемент управления StatusBar предыдущих версий и расширяет его функциональные возможности, однако при необходимости элемент управления StatusBar можно сохранить для обратной совместимости и использования в будущем.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
Наследование
Реализации

Примеры

В следующем примере кода создается элемент управления 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

Комментарии

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. Для получения, добавления или удаления отдельных StatusBarPanelиспользуйте StatusBar.StatusBarPanelCollection, доступный через свойство StatusBar.Panels элемента управления StatusBar.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()

Инициализация нового экземпляра класса StatusBarPanel.Initializes a new instance of the StatusBarPanel class.

Свойства

Alignment

Возвращает или задает способ выравнивания текста и значков на панели строки состояния.Gets or sets the alignment of text and icons within the status bar panel.

AutoSize

Возвращает или задает значение, указывающее, изменяется ли автоматически размер панели строки состояния.Gets or sets a value indicating whether the status bar panel is automatically resized.

BorderStyle

Получает или задает стиль границы для панели строки состояния.Gets or sets the border style of the status bar panel.

CanRaiseEvents

Возвращает значение, показывающее, может ли компонент вызывать событие.Gets a value indicating whether the component can raise an event.

(Унаследовано от Component)
Container

Возвращает контейнер IContainer, содержащий компонент Component.Gets the IContainer that contains the Component.

(Унаследовано от Component)
DesignMode

Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время.Gets a value that indicates whether the Component is currently in design mode.

(Унаследовано от Component)
Events

Возвращает список обработчиков событий, которые прикреплены к этому объекту Component.Gets the list of event handlers that are attached to this Component.

(Унаследовано от Component)
Icon

Получает или задает значок на панели строки состояния.Gets or sets the icon to display within the status bar panel.

MinWidth

Получает или задает минимальную допустимую ширину для панели строки состояния в элементе управления StatusBar.Gets or sets the minimum allowed width of the status bar panel within the StatusBar control.

Name

Получает или задает имя, применяемое к StatusBarPanel.Gets or sets the name to apply to the StatusBarPanel.

Parent

Получает элемент управления StatusBar, который содержит данную панель строки состояния.Gets the StatusBar control that hosts the status bar panel.

Site

Возвращает или задает ISite объекта Component.Gets or sets the ISite of the Component.

(Унаследовано от Component)
Style

Получает или задает стиль панели строки состояния.Gets or sets the style of the status bar panel.

Tag

Возвращает или задает объект, содержащий данные об объекте StatusBarPanel.Gets or sets an object that contains data about the StatusBarPanel.

Text

Получает или задает текст панели строки состояния.Gets or sets the text of the status bar panel.

ToolTipText

Получает или задает текст всплывающей подсказки, связанный с панелью строки состояния.Gets or sets ToolTip text associated with the status bar panel.

Width

Получает или задает ширину панели строки состояния в элементе управления StatusBar.Gets or sets the width of the status bar panel within the StatusBar control.

Методы

BeginInit()

Начинает инициализацию панели StatusBarPanel.Begins the initialization of a StatusBarPanel.

CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Унаследовано от MarshalByRefObject)
Dispose()

Освобождает все ресурсы, занятые модулем Component.Releases all resources used by the Component.

(Унаследовано от Component)
Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые StatusBarPanel, и дополнительно освобождает управляемые ресурсы.Releases the unmanaged resources used by the StatusBarPanel and optionally releases the managed resources.

EndInit()

Завершает инициализацию объекта StatusBarPanel.Ends the initialization of a StatusBarPanel.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
GetService(Type)

Возвращает объект, представляющий службу, предоставляемую классом Component или классом Container.Returns an object that represents a service provided by the Component or by its Container.

(Унаследовано от Component)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
InitializeLifetimeService()

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Унаследовано от MarshalByRefObject)
ToString()

Извлекает строку, которая содержит сведения о панели.Retrieves a string that contains information about the panel.

События

Disposed

Происходит при удалении компонента вызовом метода Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Унаследовано от Component)

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

Дополнительно