StatusBarPanel Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origem:

StatusBarPanel.cs

Cuidado

StatusBar is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use StatusStrip instead.

Representa um painel em um StatusBar controle.

Essa classe não está disponível no .NET 5 e 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

[System.ComponentModel.Browsable(false)]
[System.Obsolete("`StatusBar` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `StatusStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class StatusBarPanel : System.ComponentModel.Component, System.ComponentModel.ISupportInitialize

[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`StatusBar` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `StatusStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type StatusBarPanel = class
    inherit Component
    interface ISupportInitialize

Public Class StatusBarPanel
Inherits Component
Implements ISupportInitialize

Herança

Object

MarshalByRefObject

Component

StatusBarPanel

Atributos

BrowsableAttribute ObsoleteAttribute

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, nomeado 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 usa a Panels propriedade para acessar o Add método para StatusBar.StatusBarPanelCollection adicionar os painéis ao StatusBar. O exemplo também usa as AutoSizepropriedades , BorderStylee ToolTipTextText , 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 versões posteriores. Em vez disso, use o controle ToolStripStatusLabel.

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

As StatusBarPanel 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 em um painel. Essa propriedade pode ser usada para fornecer uma representação gráfica de estado em um aplicativo. A Alignment propriedade permite que você especifique como o texto e/ou um ícone são alinhados 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 da Ajuda ou informações de estado sobre seu aplicativo. Muitas vezes, é importante exibir informações adicionais sobre 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 a um StatusBarPanel. A Style propriedade permite que você especifique como será StatusBarPanel 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 como OwnerDraw, 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

Nome	Description
StatusBarPanel()	Obsoleto. Inicializa uma nova instância da classe StatusBarPanel.

Propriedades

Nome	Description
Alignment	Obsoleto. Obtém ou define o alinhamento de texto e ícones no painel da barra de status.
AutoSize	Obsoleto. Obtém ou define um valor que indica se o painel da barra de status é redimensionado automaticamente.
BorderStyle	Obsoleto. Obtém ou define o estilo de borda do painel da barra de status.
Icon	Obsoleto. Obtém ou define o ícone a ser exibido no painel da barra de status.
MinWidth	Obsoleto. Obtém ou define a largura mínima permitida do painel de barras de status dentro do StatusBar controle.
Name	Obsoleto. Obtém ou define o nome a ser aplicado ao StatusBarPanel.
Parent	Obsoleto. Obtém o StatusBar controle que hospeda o painel da barra de status.
Style	Obsoleto. Obtém ou define o estilo do painel da barra de status.
Tag	Obsoleto. Obtém ou define um objeto que contém dados sobre o StatusBarPanel.
Text	Obsoleto. Obtém ou define o texto do painel da barra de status.
ToolTipText	Obsoleto. Obtém ou define o texto tooltip associado ao painel da barra de status.
Width	Obsoleto. Obtém ou define a largura do painel da barra de status dentro do StatusBar controle.

Métodos

Nome	Description
BeginInit()	Obsoleto. Inicia a inicialização de um StatusBarPanel.
EndInit()	Obsoleto. Termina a inicialização de um StatusBarPanel.

Confira também

• StatusBarPanel