StatusBarPanel Classe

Definição

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

Propriedades

Métodos

Eventos

Aplica-se a

Confira também

• StatusBarPanel