StatusBar.StatusBarPanelCollection Класс

Ссылка

Определение

Пространство имен:: System.Windows.Forms

Сборка:: System.Windows.Forms.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет коллекцию панелей в элементе управления StatusBar.

public: ref class StatusBar::StatusBarPanelCollection : System::Collections::IList

public class StatusBar.StatusBarPanelCollection : System.Collections.IList

[System.ComponentModel.ListBindable(false)]
public class StatusBar.StatusBarPanelCollection : System.Collections.IList

type StatusBar.StatusBarPanelCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

[<System.ComponentModel.ListBindable(false)>]
type StatusBar.StatusBarPanelCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

Public Class StatusBar.StatusBarPanelCollection
Implements IList

Наследование: Object
StatusBar.StatusBarPanelCollection

Атрибуты: ListBindableAttribute

Реализации: ICollection IEnumerable IList

Примеры

В следующем примере кода создается StatusBar элемент управления в форме и добавляются два StatusBarPanel объекта. Один из именованных StatusBarPanelpanel1отображает текст состояния для приложения. StatusBarPanelВторой с именем panel2отображает текущую дату и использует ToolTipText свойство класса для отображения текущего StatusBarPanel времени. В примере используется ShowPanels свойство, чтобы убедиться, что панели отображаются вместо стандартной панели, а также Panels используется и свойство для доступа к Add методу StatusBar.StatusBarPanelCollection добавления панелей в StatusBar. В этом примере также используются AutoSizeсвойства , BorderStyle ToolTipTextа также свойства для инициализации Text StatusBarPanel объектов. В этом примере предполагается, что метод, определенный в примере, определен и вызывается из конструктора 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. Каждый объект в коллекции является экземпляром StatusBarPanel класса, который определяет характеристики отображения и поведение панели, отображаемой в .StatusBar

Существует несколько способов добавления панелей в коллекцию. Этот Add метод позволяет добавить одну панель в коллекцию. Чтобы добавить несколько панелей в коллекцию, необходимо создать массив StatusBarPanel объектов и назначить его методу AddRange . Если вы хотите вставить панель в определенное расположение в коллекции, можно использовать Insert этот метод. Чтобы удалить панели, можно использовать Remove метод или RemoveAt метод, если вы знаете, где находится панель в коллекции. Этот Clear метод позволяет удалить все панели из коллекции, а не использовать Remove метод для удаления одной панели за раз.

Помимо методов и свойств для добавления и удаления панелей, StatusBar.StatusBarPanelCollection также предоставляются методы для поиска панелей в коллекции. Этот Contains метод позволяет определить, является ли панель членом коллекции. После того как вы знаете, что панель находится в коллекции, можно использовать IndexOf метод, чтобы определить, где находится панель в коллекции.

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

StatusBar.StatusBarPanelCollection(StatusBar)

Инициализирует новый экземпляр класса StatusBar.StatusBarPanelCollection.

Свойства

Count	Возвращает количество элементов в коллекции.
IsReadOnly	Возвращает значение, которое определяет, является ли коллекция доступной только для чтения.
Item[Int32]	Возвращает или задает объект StatusBarPanel с заданным индексом.
Item[String]	Возвращает из коллекции элемент с указанным ключом.

Методы

Add(StatusBarPanel)	Добавляет StatusBarPanel в коллекцию.
Add(String)	Добавляет в коллекцию панель StatusBarPanel с указанным текстом.
AddRange(StatusBarPanel[])	Добавляет в коллекцию массив объектов StatusBarPanel.
Clear()	Удаляет все элементы из коллекции.
Contains(StatusBarPanel)	Определяет, находится ли указанный элемент управления в коллекции.
ContainsKey(String)	Определяет, содержится ли в коллекции панель StatusBarPanel с указанным ключом.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetEnumerator()	Возвращает перечислитель для перебора элементов коллекции.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
IndexOf(StatusBarPanel)	Возвращает индекс указанной панели в коллекции.
IndexOfKey(String)	Возвращает индекс первого вхождения панели StatusBarPanel с указанным ключом.
Insert(Int32, StatusBarPanel)	Вставляет в коллекцию заданный объект StatusBarPanel по указанному индексу.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
Remove(StatusBarPanel)	Удаляет указанный объект StatusBarPanel из коллекции.
RemoveAt(Int32)	Удаляет панель StatusBarPanel, находящуюся по указанному индексу в коллекции.
RemoveByKey(String)	Удаляет из коллекции объект StatusBarPanel с указанным ключом.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Явные реализации интерфейса

ICollection.CopyTo(Array, Int32)	Копирует всю коллекцию StatusBar.StatusBarPanelCollection в совместимый одномерный массив, начиная с указанного индекса целевого массива.
ICollection.IsSynchronized	Возвращает значение, указывающее, является ли доступ к коллекции синхронизированным (потокобезопасным).
ICollection.SyncRoot	Возвращает объект, который можно использовать для синхронизации доступа к коллекции.
IList.Add(Object)	Этот API поддерживает инфраструктуру продукта и не предназначен для использования непосредственно из программного кода. Добавляет StatusBarPanel в коллекцию.
IList.Contains(Object)	Определяет, находится ли указанный элемент управления в коллекции.
IList.IndexOf(Object)	Возвращает индекс указанной панели в коллекции.
IList.Insert(Int32, Object)	Вставляет в коллекцию заданный объект StatusBarPanel по указанному индексу.
IList.IsFixedSize	Возвращает значение, указывающее, имеет ли коллекция фиксированный размер.
IList.Item[Int32]	Возвращает или задает элемент по указанному индексу.
IList.Remove(Object)	Удаляет указанный объект StatusBarPanel из коллекции.

Методы расширения

Cast<TResult>(IEnumerable)	Приводит элементы объекта IEnumerable к заданному типу.
OfType<TResult>(IEnumerable)	Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.
AsParallel(IEnumerable)	Позволяет осуществлять параллельный запрос.
AsQueryable(IEnumerable)	Преобразовывает коллекцию IEnumerable в объект IQueryable.

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

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

StatusBarPanel

Бөлісу құралы: