StatusBarPanel StatusBarPanel StatusBarPanel StatusBarPanel Class

Definição

Representa um painel em um controle StatusBar.Represents a panel in a StatusBar control. Embora o controle StatusStrip substitua e adicione funcionalidade ao controle StatusBar de versões anteriores, StatusBar é mantido para compatibilidade com versões anteriores e uso futuro, se desejado.Although the StatusStrip control replaces and adds functionality to the StatusBar control of previous versions, StatusBar is retained for both backward compatibility and future use if you choose.

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 uma StatusBar control em um formulário e adiciona dois StatusBarPanel objetos.The following code example creates a StatusBar control on a form and adds two StatusBarPanel objects. A primeira StatusBarPanel, denominado panel1, exibe o texto de status para um aplicativo.The first StatusBarPanel, named panel1, displays status text for an application. A segunda StatusBarPanel, denominado panel2, exibe a data atual e usa o ToolTipText propriedade o StatusBarPanel classe para exibir a hora atual.The second StatusBarPanel, named panel2, displays the current date and uses the ToolTipText property of the StatusBarPanel class to display the current time. 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 da StatusBar.StatusBarPanelCollection para adicionar os painéis para o StatusBar.The example uses the ShowPanels property to ensure that the panels are displayed instead of a standard panel, and it uses the Panels property to access the Add method of the StatusBar.StatusBarPanelCollection to add the panels to the StatusBar. O exemplo também usa o AutoSize, BorderStyle, ToolTipText, e Text as propriedades para inicializar o StatusBarPanel objetos.The example also uses the AutoSize, BorderStyle, ToolTipText, and Text properties to initialize the StatusBarPanel objects. Este exemplo supõe que o método definido no exemplo é definido e chamado do construtor de um Form.This example assumes that the method defined in the example is defined and called from the constructor of a 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

Um StatusBarPanel representa um painel individual em de StatusBar.StatusBarPanelCollection de um StatusBar controle.A StatusBarPanel represents an individual panel in the StatusBar.StatusBarPanelCollection of a StatusBar control. Um StatusBarPanel pode conter texto e/ou em um ícone que pode ser usado para refletir o status de um aplicativo.A StatusBarPanel can contain text and/or an icon that can be used to reflect the status of an application. Use o StatusBar.StatusBarPanelCollection, acessível por meio do StatusBar.Panels propriedade de uma StatusBar controle, recuperar, adicionar ou remover um indivíduo StatusBarPanel.Use the StatusBar.StatusBarPanelCollection, accessible through the StatusBar.Panels property of a StatusBar control, to retrieve, add, or remove an individual StatusBarPanel.

O StatusBarPanel fornece propriedades que permitem que você modificar o comportamento de exibição de um painel dentro de um StatusBar controle.The StatusBarPanel provides properties that enable you to modify the display behavior of a panel within a StatusBar control. Você pode usar o Icon propriedade para exibir um ícone em um painel.You can use the Icon property to display an icon within a panel. Essa propriedade pode ser usada para fornecer uma representação gráfica do estado em um aplicativo.This property can be used to provide a graphical representation of state in an application. O Alignment propriedade permite que você especifique como o texto e/ou um ícone é alinhado dentro do painel.The Alignment property enables you to specify how text and/or an icon is aligned within the panel. Para garantir que seu painel é dimensionado adequadamente para ajustar o texto do painel, você pode usar o AutoSize propriedade para redimensionar automaticamente o painel para ajustar o texto do painel ou para preencher o restante de espaço dentro de StatusBar controle.To ensure that your panel is sized properly to fit the text of the panel, you can use the AutoSize property to automatically resize the panel to fit the text of the panel or to fill the remaining space within the StatusBar control. O MinWidth propriedade permite que você especifique uma largura mínima do painel para garantir que não obtenha menor do que os dados que ele se destina a exibir.The MinWidth property enables you to specify a minimum width for the panel to ensure that it does not get smaller than the data it is intended to display.

O StatusBar controle normalmente é usado para exibir informações de Ajuda ou informações de estado sobre o seu aplicativo.The StatusBar control is typically used to display Help information or state information about your application. Muitas vezes, é importante exibir informações adicionais sobre dados que são apresentados em um painel.Often, it is important to display additional information about data that is presented in a panel. Você pode usar o ToolTipText propriedade para exibir informações sempre que o ponteiro do mouse fica em um painel.You can use the ToolTipText property to display information whenever the mouse pointer rests on a panel.

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.Although the StatusBar control is typically used to display textual information, you can also provide your own type of display to a StatusBarPanel. O Style propriedade permite que você especifique como o StatusBarPanel será desenhado.The Style property enables you to specify how the StatusBarPanel will be drawn. Por padrão, o Style propriedade é usada para exibir o valor da Text propriedade (e um ícone, se especificado no Icon propriedade).By default, the Style property is used to display the value of the Text property (and an icon, if specified in the Icon property). Se a propriedade é definida como OwnerDraw, você pode desenhar suas próprias informações para o painel.If the property is set to OwnerDraw, you can draw your own information into the panel. Você pode usar esse recurso para desenhar uma barra de progresso ou um ícone animado no painel.You can use this feature to draw a progress bar or an animated icon in the panel.

Quando você cria uma instância da StatusBarPanel classe, as propriedades de leitura/gravação são definidas como valores iniciais.When you create an instance of the StatusBarPanel class, the read/write properties are set to initial values. Para obter uma lista desses valores, consulte o StatusBarPanel construtor.For a list of these values, see the StatusBarPanel constructor.

Construtores

StatusBarPanel() StatusBarPanel() StatusBarPanel() StatusBarPanel()

Inicializa uma nova instância da classe StatusBarPanel.Initializes a new instance of the StatusBarPanel class.

Propriedades

Alignment Alignment Alignment Alignment

Obtém ou define o alinhamento do texto e dos ícones no painel da barra de status.Gets or sets the alignment of text and icons within the status bar panel.

AutoSize AutoSize AutoSize AutoSize

Obtém ou define um valor que indica se o painel da barra de status é redimensionado automaticamente.Gets or sets a value indicating whether the status bar panel is automatically resized.

BorderStyle BorderStyle BorderStyle BorderStyle

Obtém ou define o estilo de borda do painel da barra de status.Gets or sets the border style of the status bar panel.

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Obtém um valor que indica se o componente pode acionar um evento.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Container Container Container Container

Obtém o IContainer que contém o Component.Gets the IContainer that contains the Component.

(Inherited from Component)
DesignMode DesignMode DesignMode DesignMode

Obtém um valor que indica se o Component está no modo de design no momento.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Obtém a lista de manipuladores de eventos que estão anexados a este Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Icon Icon Icon Icon

Obtém ou define o ícone a ser exibido no painel da barra de status.Gets or sets the icon to display within the status bar panel.

MinWidth MinWidth MinWidth MinWidth

Obtém ou define a largura mínima permitida do painel da barra de status dentro do controle StatusBar.Gets or sets the minimum allowed width of the status bar panel within the StatusBar control.

Name Name Name Name

Obtém ou define o nome a ser aplicado ao StatusBarPanel.Gets or sets the name to apply to the StatusBarPanel.

Parent Parent Parent Parent

Obtém o controle StatusBar que hospeda o painel da barra de status.Gets the StatusBar control that hosts the status bar panel.

Site Site Site Site

Obtém ou define o ISite do Component.Gets or sets the ISite of the Component.

(Inherited from Component)
Style Style Style Style

Obtém ou define o estilo do painel da barra de status.Gets or sets the style of the status bar panel.

Tag Tag Tag Tag

Obtém ou define um objeto que contém dados sobre o StatusBarPanel.Gets or sets an object that contains data about the StatusBarPanel.

Text Text Text Text

Obtém ou define o texto do painel da barra de status.Gets or sets the text of the status bar panel.

ToolTipText ToolTipText ToolTipText ToolTipText

Obtém ou define o texto de dica de ferramenta associado ao painel da barra de status.Gets or sets ToolTip text associated with the status bar panel.

Width Width Width Width

Obtém ou define a largura do painel da barra de status dentro do controle StatusBar.Gets or sets the width of the status bar panel within the StatusBar control.

Métodos

BeginInit() BeginInit() BeginInit() BeginInit()

Começa a inicialização de um StatusBarPanel.Begins the initialization of a StatusBarPanel.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Libera todos os recursos usados pelo Component.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libera os recursos não gerenciados usados pelo StatusBarPanel e opcionalmente libera os recursos gerenciados.Releases the unmanaged resources used by the StatusBarPanel and optionally releases the managed resources.

EndInit() EndInit() EndInit() EndInit()

Termina a inicialização de um StatusBarPanel.Ends the initialization of a StatusBarPanel.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
ToString() ToString() ToString() ToString()

Recupera uma cadeia de caracteres que contém informações sobre o painel.Retrieves a string that contains information about the panel.

Eventos

Disposed Disposed Disposed Disposed

Ocorre quando o componente é disposto por uma chamada para o método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

Aplica-se a

Veja também