Procedura: aggiungere pannelli a un controllo StatusBar

Articolo
08/11/2011

Importante
Benché i controlli StatusStrip e ToolStripStatusLabel sostituiscano i controlli StatusBar e StatusBarPanel delle versioni precedenti aggiungendo funzionalità, i controlli StatusBar e StatusBarPanel vengono mantenuti per compatibilità con le versioni precedenti e per utilizzo futuro se lo si desidera.

L'area programmabile all'interno di un controllo Controllo StatusBar (Windows Form) è costituita da istanze della classe StatusBarPanel. Tali istanze vengono create come aggiunte alla classe StatusBar.StatusBarPanelCollection.

Per aggiungere pannelli a una barra di stato

In una routine creare i pannelli della barra di stato aggiungendoli all'insieme StatusBar.StatusBarPanelCollection. Specificare le impostazioni delle proprietà per i singoli pannelli utilizzando il relativo indice passato mediante la proprietà Panels.

Nell'esempio che segue il percorso impostato per l'icona corrisponde alla cartella Documenti. Si consiglia di utilizzare questa posizione perché tale cartella è presente nella maggior parte dei computer che esegue il sistema operativo Windows. La scelta di questa posizione consente inoltre di eseguire l'applicazione senza problemi agli utenti che dispongono di livelli di accesso minimo. Per l'esempio è necessario un form a cui sia già stato aggiunto il controllo StatusBar.

Nota

Poiché l'insieme StatusBar.StatusBarPanelCollection è a base zero, il codice deve procedere di conseguenza.

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;
   }