Partilhar via


StatusBarPanel Classe

Definição

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
Implementações

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()
Obsoleto.

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()
Obsoleto.

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)

Aplica-se a

Confira também