StatusBarPanel StatusBarPanel StatusBarPanel StatusBarPanel Class

Определение

Представляет панель элемента управления 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 примере используется свойство, чтобы убедиться, что панели отображаются вместо стандартной панели, и Add Panels использует свойство для доступа к методу, 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

Комментарии

Представляет отдельную панель StatusBar.StatusBarPanelCollection в StatusBar элементе управления. StatusBarPanelA 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.

Предоставляет свойства, позволяющие изменять поведение экрана панели StatusBar внутри элемента управления. StatusBarPanelThe 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.

Хотя элемент управления обычно используется для вывода текстовых данных, можно также предоставить собственный тип дисплея StatusBarPanel. StatusBarAlthough the StatusBar control is typically used to display textual information, you can also provide your own type of display to a StatusBarPanel. Свойство позволяет указать, StatusBarPanel как будет отображаться. StyleThe 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() StatusBarPanel() StatusBarPanel()

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

Свойства

Alignment Alignment Alignment Alignment

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

AutoSize AutoSize AutoSize AutoSize

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

BorderStyle BorderStyle BorderStyle BorderStyle

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

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

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

(Inherited from Component)
Container Container Container Container

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

(Inherited from Component)
DesignMode DesignMode DesignMode DesignMode

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

(Inherited from Component)
Events Events Events Events

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

(Inherited from Component)
Icon Icon Icon Icon

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

MinWidth MinWidth MinWidth MinWidth

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

Name Name Name Name

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

Parent Parent Parent Parent

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

Site Site Site Site

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

(Inherited from Component)
Style Style Style Style

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

Tag Tag Tag Tag

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

Text Text Text Text

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

ToolTipText ToolTipText ToolTipText ToolTipText

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

Width Width Width Width

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

Методы

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

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

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.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()

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

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

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

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

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

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

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

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

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

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

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.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)

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

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

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

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

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

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

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

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

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

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

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

События

Disposed Disposed Disposed Disposed

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

(Inherited from Component)

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

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