Classe StatusBarPanel

A StatusBarPanel representa um painel individual no StatusBar.StatusBarPanelCollection de um StatusBar controle. A StatusBarPanel pode conter texto e/ou um ícone que pode ser usado para refletir o status de um aplicativo. Use o StatusBar.StatusBarPanelCollection, acessível através de StatusBar.Panels propriedade de um StatusBar controlar, recuperar, adicionar ou remover um indivíduo StatusBarPanel.

The StatusBarPanel Fornece propriedades que permitem que você modificar o comportamento de exibição de um painel dentro de um StatusBar controle. Você pode usar o Icon propriedade para exibir um ícone dentro de um painel. Esta propriedade pode ser usada para fornecer uma representação gráfica de estado em um aplicativo. The Alignment propriedade permite que você especifique o texto e/ou um ícone é alinhado dentro do painel. Para garantir que o painel é dimensionado adequadamente para ajuste o texto do painel, você pode usar o AutoSize propriedade para redimensionar automaticamente o painel para ajuste o texto do painel ou para preencher o restante de espaço dentro do StatusBar controle. The MinWidth propriedade permite que você especificar uma largura mínima para o painel para garantir que não obtiver menor do que os dados destina-se a exibir.

The StatusBar controle normalmente é usado para exibir informações de Ajuda ou informações de estado sobre seu aplicativo. Em geral, é importante exibir informações adicionais sobre os dados que são apresentadas em um painel. Você pode usar o ToolTipText propriedade para exibir informações sempre que o ponteiro do mouse é posicionado em um painel.

Embora o StatusBar controle é normalmente usado para exibir informações textuais, você também pode fornecer seu próprio tipo de exibição para um StatusBarPanel. The Style propriedade permite que você especifique como o StatusBarPanel serão desenhados. 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 for conjunto para OwnerDraw, você pode desenhar suas próprias informações para o painel. Você pode usar esse recurso para desenhar uma BAR de progresso ou um ícone animado no painel.

Quando você cria uma instância do StatusBarPanel classe, as propriedades de leitura/gravar são definidas como valores iniciais. Para obter uma lista desses valores, consulte o StatusBarPanel construtor.

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 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 assume 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

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

.NET Framework

Referência