Compartilhar via

Como adicionar painéis a um controle StatusBar

  • Artigo

Importante

Os controles StatusStrip e ToolStripStatusLabel substituem e adicionam funcionalidade aos controles StatusBar e StatusBarPanel; no entanto, os controles StatusBar e StatusBarPanel são mantidos para compatibilidade com versões anteriores e uso futuro, se você escolher.

Dentro de um controle StatusBar, a área programável consiste em instâncias da classe StatusBarPanel. Elas são adicionadas por meio de adições à classe StatusBar.StatusBarPanelCollection.

Para adicionar painéis a uma barra de status

  1. Em um procedimento, crie painéis de barra de status adicionando-os ao StatusBar.StatusBarPanelCollection. Especifique as configurações de propriedade para painéis individuais usando seu índice passado pela propriedade Panels.

    No exemplo de código a seguir, o caminho definido para o local do ícone é a pasta Meus Documentos. Esse local é usado porque você pode assumir que a maioria dos computadores que executam o sistema operacional Windows incluirá essa pasta. Escolher esse local também permite que usuários com níveis mínimos de acesso do sistema executem o aplicativo com segurança. O exemplo a seguir requer um formulário com um controle de StatusBar já adicionado.

    Nota

    O StatusBar.StatusBarPanelCollection é uma coleção baseada em zero, portanto, o código deve continuar de acordo.

    Public Sub CreateStatusBarPanels()  
' Create panels and set text property.  
   StatusBar1.Panels.Add("One")  
   StatusBar1.Panels.Add("Two")  
   StatusBar1.Panels.Add("Three")  
' Set properties of StatusBar panels.  
' Set AutoSize property of panels.  
   StatusBar1.Panels(0).AutoSize = StatusBarPanelAutoSize.Spring  
   StatusBar1.Panels(1).AutoSize = StatusBarPanelAutoSize.Contents  
   StatusBar1.Panels(2).AutoSize = StatusBarPanelAutoSize.Contents  
' Set BorderStyle property of panels.  
   StatusBar1.Panels(0).BorderStyle = StatusBarPanelBorderStyle.Raised  
   StatusBar1.Panels(1).BorderStyle = StatusBarPanelBorderStyle.Sunken  
   StatusBar1.Panels(2).BorderStyle = StatusBarPanelBorderStyle.Raised  
' Set Icon property of third panel. You should replace the bolded  
' icon in the sample below with an icon of your own choosing.  
   StatusBar1.Panels(2).Icon = New _
   System.Drawing.Icon(System.Environment.GetFolderPath _  
   (System.Environment.SpecialFolder.Personal) _  
   & "\Icon.ico")  
   StatusBar1.ShowPanels = True  
End Sub  

    public void CreateStatusBarPanels()  
{  
   // Create panels and set text property.  
   statusBar1.Panels.Add("One");  
   statusBar1.Panels.Add("Two");  
   statusBar1.Panels.Add("Three");  
   // Set properties of StatusBar panels.  
   // Set AutoSize property of panels.  
   statusBar1.Panels[0].AutoSize = StatusBarPanelAutoSize.Spring;  
   statusBar1.Panels[1].AutoSize = StatusBarPanelAutoSize.Contents;  
   statusBar1.Panels[2].AutoSize = StatusBarPanelAutoSize.Contents;  
   // Set BorderStyle property of panels.  
   statusBar1.Panels[0].BorderStyle =  
      StatusBarPanelBorderStyle.Raised;  
   statusBar1.Panels[1].BorderStyle = StatusBarPanelBorderStyle.Sunken;  
   statusBar1.Panels[2].BorderStyle = StatusBarPanelBorderStyle.Raised;  
   // Set Icon property of third panel. You should replace the bolded  
   // icon in the sample below with an icon of your own choosing.  
   // Note the escape character used (@) when specifying the path.  
   statusBar1.Panels[2].Icon =
      new System.Drawing.Icon (System.Environment.GetFolderPath _  
   (System.Environment.SpecialFolder.Personal) _  
   + @"\Icon.ico");  
   statusBar1.ShowPanels = true;  
}  

    public:  
   void CreateStatusBarPanels()  
   {  
      // Create panels and set text property.  
      statusBar1->Panels->Add("One");  
      statusBar1->Panels->Add("Two");  
      statusBar1->Panels->Add("Three");  
      // Set properties of StatusBar panels.  
      // Set AutoSize property of panels.  
      statusBar1->Panels[0]->AutoSize =  
         StatusBarPanelAutoSize::Spring;  
      statusBar1->Panels[1]->AutoSize =  
         StatusBarPanelAutoSize::Contents;  
      statusBar1->Panels[2]->AutoSize =  
         StatusBarPanelAutoSize::Contents;  
      // Set BorderStyle property of panels.  
      statusBar1->Panels[0]->BorderStyle =  
         StatusBarPanelBorderStyle::Raised;  
      statusBar1->Panels[1]->BorderStyle =  
         StatusBarPanelBorderStyle::Sunken;  
      statusBar1->Panels[2]->BorderStyle =  
         StatusBarPanelBorderStyle::Raised;  
      // Set Icon property of third panel.  
      // You should replace the bolded image
      // in the sample below with an icon of your own choosing.  
      statusBar1->Panels[2]->Icon =  
         gcnew System::Drawing::Icon(String::Concat(  
         System::Environment::GetFolderPath(  
         System::Environment::SpecialFolder::Personal),  
         "\\Icon.ico"));  
      statusBar1->ShowPanels = true;  
   }

Consulte também