StatusBar.StatusBarPanelCollection Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Representa a coleção de painéis em um controle 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

Herança

Object

StatusBar.StatusBarPanelCollection

Atributos

ListBindableAttribute

Implementações

ICollection IEnumerable IList

Exemplos

O exemplo de código a seguir cria um StatusBar controle em um formulário e adiciona dois StatusBarPanel objetos. Um dos StatusBarPanel, nomeados panel1, exibe o texto de status de um aplicativo. O segundo StatusBarPanel, nomeado panel2, exibe a data atual e usa a ToolTipText propriedade da StatusBarPanel classe para exibir a hora atual. O exemplo usa a ShowPanels propriedade para garantir que os painéis sejam exibidos em vez de um painel padrão, e ele usa e a Panels propriedade para acessar o Add método do StatusBar.StatusBarPanelCollection para adicionar os painéis ao StatusBar. O exemplo também usa as AutoSizepropriedades , BorderStyleToolTipTexte Text , para inicializar os StatusBarPanel objetos. Este exemplo pressupõe que o método definido no exemplo seja definido e chamado do construtor de um 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

Comentários

A StatusBar.StatusBarPanelCollection classe armazena os painéis exibidos no StatusBar. Cada objeto na coleção é uma instância da StatusBarPanel classe que define as características de exibição e os comportamentos de um painel exibido em um StatusBar.

Há várias maneiras de adicionar painéis à coleção. O Add método fornece a capacidade de adicionar um único painel à coleção. Para adicionar vários painéis à coleção, crie uma matriz de StatusBarPanel objetos e atribua-a AddRange ao método. Se você quiser inserir um painel em um local específico dentro da coleção, poderá usar o Insert método. Para remover painéis, você pode usar o Remove método ou o RemoveAt método se souber onde o painel está localizado na coleção. O Clear método permite que você remova todos os painéis da coleção em vez de usar o Remove método para remover um único painel por vez.

Além de métodos e propriedades para adicionar e remover painéis, o StatusBar.StatusBarPanelCollection também fornece métodos para localizar painéis dentro da coleção. O Contains método permite que você determine se um painel é um membro da coleção. Depois de saber que o painel está localizado dentro da coleção, você pode usar o IndexOf método para determinar onde o painel está localizado na coleção.

Construtores

StatusBar.StatusBarPanelCollection(StatusBar)

Inicializa uma nova instância da classe StatusBar.StatusBarPanelCollection.

Propriedades

Count	Obtém o número de itens na coleção.
IsReadOnly	Obtém um valor que indica se esta coleção é somente leitura.
Item[Int32]	Obtém ou define o StatusBarPanel no índice especificado.
Item[String]	Obtém um item com a chave especificada da coleção.

Métodos

Add(StatusBarPanel)	Adiciona um StatusBarPanel à coleção.
Add(String)	Adiciona um StatusBarPanel com o texto especificado na coleção.
AddRange(StatusBarPanel[])	Adiciona uma matriz de objetos StatusBarPanel à coleção.
Clear()	Remove todos os itens da coleção.
Contains(StatusBarPanel)	Determina se o painel especificado está localizado dentro da coleção.
ContainsKey(String)	Determina se a coleção contém um StatusBarPanel com a chave especificada.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetEnumerator()	Retorna um enumerador a ser usado para iterar pela coleção de itens.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IndexOf(StatusBarPanel)	Retorna o índice na coleção do painel especificado.
IndexOfKey(String)	Retorna o índice da primeira ocorrência de um StatusBarPanel com a chave especificada.
Insert(Int32, StatusBarPanel)	Insere o StatusBarPanel especificado na coleção no índice especificado.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Remove(StatusBarPanel)	Remove o StatusBarPanel especificado da coleção.
RemoveAt(Int32)	Remove o StatusBarPanel no índice especificado dentro da coleção.
RemoveByKey(String)	Remove o StatusBarPanel com a chave especificada da coleção.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

ICollection.CopyTo(Array, Int32)	Copia o StatusBar.StatusBarPanelCollection para uma matriz unidimensional compatível, iniciando no índice especificado da matriz de destino.
ICollection.IsSynchronized	Obtém um valor que indica se o acesso à coleção é sincronizado (thread-safe).
ICollection.SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso à coleção.
IList.Add(Object)	Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código. Adiciona um StatusBarPanel à coleção.
IList.Contains(Object)	Determina se o painel especificado está localizado dentro da coleção.
IList.IndexOf(Object)	Retorna o índice do painel especificado dentro da coleção.
IList.Insert(Int32, Object)	Insere o StatusBarPanel especificado na coleção no índice especificado.
IList.IsFixedSize	Obtém um valor que indica se a coleção tem um tamanho fixo.
IList.Item[Int32]	Obtém ou define o elemento no índice especificado.
IList.Remove(Object)	Remove o StatusBarPanel especificado da coleção.

Métodos de Extensão

Cast<TResult>(IEnumerable)	Converte os elementos de um IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base em um tipo especificado.
AsParallel(IEnumerable)	Habilita a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable em um IQueryable.

Confira também

• StatusBarPanel