StatusBarPanel.AutoSize Eigenschaft

Definition

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

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. Der erste StatusBarPanel, benannte 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 es verwendet die Panels Eigenschaft, um auf die Add Methode der StatusBar.StatusBarPanelCollection Hinzuzufügen der Panels zu StatusBarzugreifen. Im Beispiel werden auch die AutoSizeObjekte initialisiertStatusBarPanel, BorderStyleToolTipTextund Text die Eigenschaften werden verwendet. In diesem Beispiel wird davon ausgegangen, dass die im Beispiel definierte Methode definiert und vom 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

StatusBarPanel objekte, die festgelegt sind, die Contents Vorrang vor diesen Panels haben, die auf den Spring Wert festgelegt sind. Beispielsweise wird eine StatusBarPanel Eigenschaft, auf die die AutoSize Eigenschaft festgelegt ist, gekürzt, wenn eine StatusBarPanel mit dem AutoSize Eigenschaftssatz Spring festgelegte Contents Leerzeichen erforderlich ist.

Sie können verwenden AutoSize , um sicherzustellen, dass der Inhalt eines StatusBarPanel Steuerelements ordnungsgemäß in einem StatusBar Steuerelement angezeigt wird, das mehrere Bereiche enthält. Beispielsweise können Sie möchten, dass ein Bereich, der Text enthält, automatisch an die Textmenge angepasst werden soll, die angezeigt wird (Contents), während ein anderer Bereich auf dem StatusBar angezeigten Statusbalken für besitzergezeichnete Statusleisten eine feste Größe (None) aufweisen muss.

Gilt für:

Siehe auch