Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações. |
Tradução
Original
|
Classe StatusBar
Representa um controle de BAR de status do Windows. Embora ToolStripStatusLabel substitui e adiciona funcionalidade a StatusBar controle de versões anteriores, StatusBar é mantida para compatibilidade com versões anteriores e para uso futuro, se você escolher.
Assembly: System.Windows.Forms (em System.Windows.Forms.dll)
Normalmente, um StatusBar consiste em controle StatusBarPanel objetos, cada um deles exibe texto e/ou um ícone. Você também pode fornecer painéis desenhados pelo proprietário para fornecer painéis personalizados sistema autônomo um BAR de progresso ou uma série de imagens exibe o estado do seu aplicativo. A StatusBar controle normalmente exibe informações sobre um objeto sendo visualizado em um Form, o objeto componentes ou informações contextuais operação desse objeto dentro de seu aplicativo.
The StatusBar o controle fornece propriedades que permitem que você personalize a aparência do controle. Se o StatusBar é exibida em um formulário que pode ser redimensionado, você pode usar o SizingGrip propriedade para exibir uma alça de dimensionamento no canto inferior direito do formulário para indicar aos usuários que o formulário pode ser redimensionado. The ShowPanels propriedade permite que você exiba painéis dentro de seu StatusBar ou para exibir apenas o valor das Text propriedade do controle.
O padrão de StatusBar não tem nenhum painéis. Para adicionar painéis a um StatusBar Você pode usar o Add método para o StatusBar.StatusBarPanelCollection classe que pode é acessado através do Panels propriedade do controle. Você também pode usar o StatusBar.StatusBarPanelCollection objeto fornecido por meio do Panels propriedade para remover painéis de controle e acesso um específico StatusBarPanel para manipular o painel.
Se você quiser determinar quando um StatusBarPanel objeto dentro de um StatusBar controle é clicado, você poderá criar um manipulador de eventos para o PanelClick evento. Para executar operações de desenho proprietário em um painel, você pode criar um manipulador de eventos para o DrawItem evento. Os dados do evento passados ao manipulador de eventos fornecem informações sobre o painel para desenhar e um Graphics objeto para executar tarefas de desenho.
Quando você cria uma instância de StatusBar, as propriedades de leitura/gravar são conjunto valores iniciais. Para obter uma lista desses valores, consulte o StatusBar construtor.
O exemplo de código a seguir cria um StatusBar controle em um formulário e adiciona dois StatusBarPanel objetos. Um do StatusBarPanel objetos, chamados panel1, exibe o texto de status de um aplicativo. O segundo StatusBarPanel, chamado panel2, exibe a data corrente e usa o ToolTipText propriedade das StatusBarPanel classe para exibir a time corrente. O exemplo usa o ShowPanels propriedade para garantir que os painéis são exibidos em vez de um painel padrão e usa o Panels propriedade para acessar o Add método para o StatusBar.StatusBarPanelCollection Para adicionar painéis para o StatusBar. O exemplo também usa o AutoSize, BorderStyle, ToolTipText, e Text Propriedades de inicializar o StatusBarPanel objetos. Este exemplo requer que o método definido no exemplo é definido e chamado a partir do construtor de um Form.
privatevoid 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 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.set_BorderStyle(StatusBarPanelBorderStyle.Sunken);
// Initialize the text of the panel.
panel1.set_Text("Ready...");
// Set the AutoSize property to use all remaining space on the StatusBar.
panel1.set_AutoSize(StatusBarPanelAutoSize.Spring);
// Display the second panel with a raised border style.
panel2.set_BorderStyle(StatusBarPanelBorderStyle.Raised);
// Create ToolTip text that displays the time the application was started.
panel2.set_ToolTipText("Started: " + System.DateTime.get_Now().ToShortTimeString());
// Set the text of the panel to the current date.
panel2.set_Text(System.DateTime.get_Today().ToLongDateString());
// Set the AutoSize property to size the panel to the size of the
// contents.
panel2.set_AutoSize(StatusBarPanelAutoSize.Contents);
// Display panels in the StatusBar control.
statusBar1.set_ShowPanels(true);
// Add both panels to the StatusBarPanelCollection of the StatusBar.
statusBar1.get_Panels().Add(panel1);
statusBar1.get_Panels().Add(panel2);
// Add the StatusBar to the form.
this.get_Controls().Add(statusBar1);
} //CreateMyStatusBar
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.StatusBar
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Pocket PC
o.NET Framework e.NET Compact Framework não oferecem suporte a todas as versões de cada plataforma. Para obter uma lista de versões suportadas, consulte Requisitos de sistema do .NET framework.