StatusBarPanel.AutoSize Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen Wert ab, der angibt, ob die Größe des Statusleistenbereichs automatisch angepasst wird, oder legt diesen Wert fest.

public:
 property System::Windows::Forms::StatusBarPanelAutoSize AutoSize { System::Windows::Forms::StatusBarPanelAutoSize get(); void set(System::Windows::Forms::StatusBarPanelAutoSize value); };

public System.Windows.Forms.StatusBarPanelAutoSize AutoSize { get; set; }

member this.AutoSize : System.Windows.Forms.StatusBarPanelAutoSize with get, set

Public Property AutoSize As StatusBarPanelAutoSize

Eigenschaftswert

StatusBarPanelAutoSize

Einer der StatusBarPanelAutoSize-Werte. Der Standardwert ist None.

Ausnahmen

InvalidEnumArgumentException

Der Wert, der der Eigenschaft zugewiesen wurde, ist kein Member der StatusBarPanelAutoSize-Enumeration.

Beispiele

Im folgenden Codebeispiel wird ein StatusBar -Steuerelement in einem Formular erstellt und zwei StatusBarPanel -Objekte hinzugefügt. Die erste StatusBarPanelmit dem Namen panel1zeigt Statustext für eine Anwendung an. Der zweite StatusBarPanelmit dem Namen panel2zeigt 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 Standardbereichs angezeigt werden, und es verwendet die Panels -Eigenschaft, um auf die Add -Methode von StatusBar.StatusBarPanelCollection zuzugreifen, um die Bereiche dem hinzuzufügen StatusBar. Im Beispiel werden auch die AutoSizeEigenschaften , BorderStyle, ToolTipTextund Text verwendet, um die StatusBarPanel Objekte zu initialisieren. In diesem Beispiel wird davon ausgegangen, dass die im Beispiel definierte Methode definiert und vom Konstruktor eines Formaufgerufen wird.

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

StatusBarPanel -Objekte, die so Contents festgelegt sind, dass sie Vorrang vor diesen Bereichen haben, die auf den Spring Wert festgelegt sind. Beispielsweise wird eine StatusBarPanel , deren AutoSize -Eigenschaft auf Spring festgelegt ist, gekürzt, wenn ein StatusBarPanel mit der AutoSize -Eigenschaft auf Contents festgelegt ist, diesen Speicherplatz benötigt.

Mit können AutoSize Sie sicherstellen, dass der Inhalt eines StatusBarPanel -Steuerelements ordnungsgemäß in einem StatusBar Steuerelement angezeigt wird, das mehr als ein Panel enthält. Beispielsweise können Sie möchten, dass ein Bereich, der Text enthält, automatisch an die Textmenge angepasst wird, die angezeigt wird (Contents), während ein anderer Bereich auf der, der StatusBar eine vom Besitzer gezeichnete Fortschrittsleiste anzeigt, eine feste Größe (None) aufweisen muss.

Gilt für:

Weitere Informationen

StatusBarPanelAutoSize