StatusBarPanel Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Representa um painel em um controle StatusBar.

Essa classe não está disponível no .NET 5 e em versões posteriores. Em vez disso, use o ToolStripStatusLabel controle , que substitui e estende o StatusBarPanel controle .

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

Herança

Object

MarshalByRefObject

Component

StatusBarPanel

Implementações

ISupportInitialize

Exemplos

O exemplo de código a seguir cria um StatusBar controle em um formulário e adiciona dois StatusBarPanel objetos . O primeiro StatusBarPanel, chamado panel1, exibe status texto de um aplicativo. O segundo StatusBarPanel, chamado 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 usa 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 , BorderStyleToolTipText, e 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

Essa classe não está disponível no .NET 5 e em versões posteriores. Em vez disso, use o ToolStripStatusLabel controle .

Um StatusBarPanel representa um painel individual no StatusBar.StatusBarPanelCollection de um StatusBar controle . Um StatusBarPanel pode conter texto e/ou um ícone que pode ser usado para refletir a status de um aplicativo. Use o StatusBar.StatusBarPanelCollection, acessível por meio da StatusBar.Panels propriedade de um StatusBar controle, para recuperar, adicionar ou remover um individual StatusBarPanel.

O StatusBarPanel fornece propriedades que permitem modificar o comportamento de exibição de um painel dentro de um StatusBar controle . Você pode usar a Icon propriedade para exibir um ícone dentro de um painel. Essa propriedade pode ser usada para fornecer uma representação gráfica do estado em um aplicativo. A Alignment propriedade permite que você especifique como o texto e/ou um ícone é alinhado dentro do painel. Para garantir que o painel seja dimensionado corretamente para ajustar o texto do painel, você pode usar a AutoSize propriedade para redimensionar automaticamente o painel para ajustar o texto do painel ou preencher o espaço restante dentro do StatusBar controle. A MinWidth propriedade permite que você especifique uma largura mínima para o painel para garantir que ele não seja menor do que os dados que se destina a exibir.

O StatusBar controle normalmente é usado para exibir informações de Ajuda ou informações de estado sobre seu aplicativo. Geralmente, é importante exibir informações adicionais sobre os dados apresentados em um painel. Você pode usar a ToolTipText propriedade para exibir informações sempre que o ponteiro do mouse estiver em um painel.

Embora o StatusBar controle normalmente seja usado para exibir informações textuais, você também pode fornecer seu próprio tipo de exibição para um StatusBarPanel. A Style propriedade permite que você especifique como o StatusBarPanel será desenhado. Por padrão, a Style propriedade é usada para exibir o valor da Text propriedade (e um ícone, se especificado na Icon propriedade ). Se a propriedade estiver definida OwnerDrawcomo , você poderá desenhar suas próprias informações no painel. Você pode usar esse recurso para desenhar uma barra de progresso ou um ícone animado no painel.

Quando você cria uma instância da StatusBarPanel classe , as propriedades de leitura/gravação são definidas como valores iniciais. Para obter uma lista desses valores, consulte o StatusBarPanel construtor .

Construtores

StatusBarPanel()

Inicializa uma nova instância da classe StatusBarPanel.

Propriedades

Alignment	Obtém ou define o alinhamento do texto e dos ícones no painel da barra de status.
AutoSize	Obtém ou define um valor que indica se o painel da barra de status é redimensionado automaticamente.
BorderStyle	Obtém ou define o estilo de borda do painel da barra de status.
CanRaiseEvents	Obtém um valor que indica se o componente pode acionar um evento. (Herdado de Component)
Container	Obtém o IContainer que contém o Component. (Herdado de Component)
DesignMode	Obtém um valor que indica se o Component está no modo de design no momento. (Herdado de Component)
Events	Obtém a lista de manipuladores de eventos que estão anexados a este Component. (Herdado de Component)
Icon	Obtém ou define o ícone a ser exibido no painel da barra de status.
MinWidth	Obtém ou define a largura mínima permitida do painel da barra de status dentro do controle StatusBar.
Name	Obtém ou define o nome a ser aplicado ao StatusBarPanel.
Parent	Obtém o controle StatusBar que hospeda o painel da barra de status.
Site	Obtém ou define o ISite do Component. (Herdado de Component)
Style	Obtém ou define o estilo do painel da barra de status.
Tag	Obtém ou define um objeto que contém dados sobre o StatusBarPanel.
Text	Obtém ou define o texto do painel da barra de status.
ToolTipText	Obtém ou define o texto de dica de ferramenta associado ao painel da barra de status.
Width	Obtém ou define a largura do painel da barra de status dentro do controle StatusBar.

Métodos

BeginInit()	Começa a inicialização de um StatusBarPanel.
CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Dispose()	Libera todos os recursos usados pelo Component. (Herdado de Component)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo StatusBarPanel e opcionalmente libera os recursos gerenciados.
EndInit()	Termina a inicialização de um StatusBarPanel.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetService(Type)	Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container. (Herdado de Component)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
ToString()	Recupera uma cadeia de caracteres que contém informações sobre o painel.

Eventos

Disposed

Ocorre quando o componente é disposto por uma chamada ao método Dispose(). (Herdado de Component)

Confira também

• StatusBarPanel