StatusBar.ShowPanels Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft einen Wert ab, der angibt, ob zum Steuerelement hinzugefügte Bereiche angezeigt werden, oder legt diesen fest.

public:
 property bool ShowPanels { bool get(); void set(bool value); };

public bool ShowPanels { get; set; }

member this.ShowPanels : bool with get, set

Public Property ShowPanels As Boolean

Eigenschaftswert

Boolean

true, wenn Bereiche angezeigt werden, andernfalls false. Der Standardwert ist false.

Beispiele

Im folgenden Codebeispiel wird ein StatusBar Steuerelement in einem Formular erstellt und zwei StatusBarPanel Objekte hinzugefügt. Eines der StatusBarPanel Objekte, benannt panel1, zeigt Statustext für eine Anwendung an. Die zweite StatusBarPanel, benannte panel2, zeigt das aktuelle Datum an und verwendet die ToolTipText Eigenschaft der StatusBarPanel Klasse, um die aktuelle Uhrzeit anzuzeigen. Im Beispiel wird die ShowPanels Eigenschaft verwendet, um sicherzustellen, dass die Panels anstelle eines Standardpanels angezeigt werden, und die Eigenschaft wird verwendet und die Panels Eigenschaft verwendet, um auf die Add Methode der StatusBar.StatusBarPanelCollection Panels zuzugreifen, um die Panels zu hinzufügen StatusBar. Im Beispiel werden auch die AutoSizeObjekte initialisiertStatusBarPanel, BorderStyleToolTipTextund Text die Eigenschaften werden verwendet. In diesem Beispiel muss die im Beispiel definierte Methode definiert und aus dem Konstruktor einer .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

Hinweise

Standardmäßig zeigt das StatusBar Steuerelement den Wert seiner Text Eigenschaft ohne Panels an. Wenn ShowPanels festgelegt trueist, werden alle StatusBarPanel im StatusBar Steuerelement angegebenen Objekte angezeigt. Beim Erstellen einer Instanz der StatusBar Klasse werden zunächst keine Panels erstellt. Sie können einem Steuerelement Panels StatusBar hinzufügen, indem Sie die Add Methode der StatusBar.StatusBarPanelCollection Klasse verwenden. Auf diese Auflistungsklasse kann über die Panels Eigenschaft von StatusBar.

Siehe auch

• StatusBarPanel