StatusBarPanel Classe

Definição

public ref class StatusBarPanel : System::ComponentModel::Component, System::ComponentModel::ISupportInitialize

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}")]
public class StatusBarPanel : System.ComponentModel.Component, System.ComponentModel.ISupportInitialize

type StatusBarPanel = class
    inherit Component
    interface 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 seguinte exemplo de código cria um StatusBar controlo num formulário e adiciona dois StatusBarPanel objetos. O primeiro StatusBarPanel, chamado panel1, apresenta o texto de estado de uma aplicação. A segunda StatusBarPanel, chamada panel2, mostra a data atual e usa a ToolTipText propriedade da StatusBarPanel classe para mostrar a hora atual. O exemplo usa a ShowPanels propriedade para garantir que os painéis são exibidos em vez de um painel padrão, e usa a Panels propriedade para aceder ao Add método de StatusBar.StatusBarPanelCollection adicionar os painéis ao StatusBar. O exemplo também utiliza as AutoSizepropriedades , BorderStyle, ToolTipText, e Text para inicializar os StatusBarPanel objetos. Este exemplo assume que o método definido no exemplo é 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

Observações

Esta classe não está disponível no .NET 5 e versões posteriores. Usa o ToolStripStatusLabel controlo em vez disso.

A StatusBarPanel representa um painel individual no StatusBar.StatusBarPanelCollection de um StatusBar controlo. A StatusBarPanel pode conter texto e/ou um ícone que pode ser usado para refletir o estado de uma aplicação. Use o StatusBar.StatusBarPanelCollection, acessível através da StatusBar.Panels propriedade de um StatusBar controlo, para recuperar, adicionar ou remover um indivíduo StatusBarPanel.

Fornece StatusBarPanel propriedades que permitem modificar o comportamento de exibição de um painel dentro de um StatusBar controlo. Pode usar a Icon propriedade para mostrar um ícone dentro de um painel. Esta propriedade pode ser usada para fornecer uma representação gráfica do estado numa aplicação. A Alignment propriedade permite-lhe especificar como o texto e/ou um ícone está alinhado dentro do painel. Para garantir que o seu painel está dimensionado corretamente para se ajustar ao texto do painel, pode usar a AutoSize propriedade para redimensionar automaticamente o painel para se ajustar ao texto do painel ou para preencher o espaço restante dentro do StatusBar controlo. A MinWidth propriedade permite-lhe especificar uma largura mínima para o painel para garantir que não fique menor do que os dados que pretende mostrar.

O StatusBar controlo é normalmente usado para mostrar informação de Ajuda ou indicar informações sobre a sua aplicação. Muitas vezes, é importante apresentar informação adicional sobre os dados apresentados num painel. Pode usar a ToolTipText propriedade para mostrar informação sempre que o ponteiro do rato repousa num painel.

Embora o StatusBar controlo seja normalmente usado para mostrar informação textual, também pode fornecer o seu próprio tipo de visualização para um StatusBarPanel. A Style propriedade permite-lhe especificar como será desenhado StatusBarPanel . Por defeito, a Style propriedade é usada para mostrar o valor da Text propriedade (e um ícone, se especificado na Icon propriedade). Se a propriedade estiver definida para OwnerDraw, pode incorporar a sua própria informação no painel. Pode usar esta funcionalidade para desenhar uma barra de progresso ou um ícone animado no painel.

Quando crias uma instância da StatusBarPanel classe, as propriedades de leitura/escrita são definidas para valores iniciais. Para obter uma lista desses valores, consulte o StatusBarPanel construtor.

Ver também

• StatusBarPanel