StatusBarPanel.AutoSize Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia wartość wskazującą, czy panel paska stanu jest automatycznie zmieniany.

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

Wartość właściwości

StatusBarPanelAutoSize

StatusBarPanelAutoSize Jedna z wartości. Wartość domyślna to None.

Wyjątki

InvalidEnumArgumentException

Wartość przypisana do właściwości nie jest elementem członkowskim StatusBarPanelAutoSize wyliczenia.

Przykłady

Poniższy przykład kodu tworzy kontrolkę StatusBar w formularzu i dodaje dwa StatusBarPanel obiekty. StatusBarPanelPierwszy , o nazwie panel1, wyświetla tekst stanu dla aplikacji. Drugi StatusBarPanel, o nazwie panel2, wyświetla bieżącą datę i używa ToolTipText właściwości StatusBarPanel klasy do wyświetlenia bieżącej godziny. W przykładzie ShowPanels użyto właściwości , aby upewnić się, że panele są wyświetlane zamiast panelu standardowego i używa Panels właściwości w celu uzyskania dostępu do Add metody StatusBar.StatusBarPanelCollection w celu dodania paneli do obiektu StatusBar. W przykładzie użyto AutoSizerównież właściwości , BorderStyle, ToolTipTexti Text w celu zainicjowania StatusBarPanel obiektów. W tym przykładzie przyjęto założenie, że metoda zdefiniowana w przykładzie jest zdefiniowana i wywoływana z konstruktora Formklasy .

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

Uwagi

StatusBarPanel obiekty ustawione tak, aby Contents miały pierwszeństwo przed tymi panelami ustawionymi Spring na wartość . Na przykład właściwość StatusBarPanel , która ma ustawioną SpringAutoSize właściwość na , jest skracana, jeśli element StatusBarPanel z właściwością AutoSize ustawioną na Contents wymaga tego miejsca.

Możesz użyć AutoSize polecenia , aby upewnić się, że zawartość obiektu StatusBarPanel jest poprawnie wyświetlana w kontrolce zawierającej StatusBar więcej niż jeden panel. Na przykład możesz chcieć, aby panel zawierający tekst był automatycznie dostosowywany do ilości wyświetlanego tekstu (Contents), podczas gdy inny panel na StatusBar ekranie wyświetlający pasek postępu narysowany przez właściciela musiałby mieć stały rozmiar (None).

Zobacz też

• StatusBarPanelAutoSize