StatusBarPanel.AutoSize Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

StatusBarPanel.cs

Ottiene o imposta un valore che indica se il pannello della barra di stato viene ridimensionato automaticamente.

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

Valore della proprietà

StatusBarPanelAutoSize

Uno dei StatusBarPanelAutoSize valori. Il valore predefinito è None.

Eccezioni

InvalidEnumArgumentException

Il valore assegnato alla proprietà non è un membro dell'enumerazione StatusBarPanelAutoSize .

Esempio

Nell'esempio di codice seguente viene creato un StatusBar controllo in una maschera e vengono aggiunti due StatusBarPanel oggetti . Il primo StatusBarPaneloggetto , denominato panel1, visualizza il testo di stato per un'applicazione. Il secondo StatusBarPaneloggetto , denominato panel2, visualizza la data corrente e usa la ToolTipText proprietà della StatusBarPanel classe per visualizzare l'ora corrente. Nell'esempio viene utilizzata la ShowPanels proprietà per assicurarsi che i pannelli vengano visualizzati anziché un pannello standard e che usi la Panels proprietà per accedere al Add metodo di StatusBar.StatusBarPanelCollection per aggiungere i pannelli a StatusBar. Nell'esempio vengono utilizzate anche le AutoSizeproprietà , BorderStyleToolTipText, e Text per inizializzare gli StatusBarPanel oggetti . In questo esempio si presuppone che il metodo definito nell'esempio sia definito e chiamato dal costruttore di un oggetto 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

Commenti

StatusBarPanel gli oggetti impostati in modo da Contents avere la precedenza su tali pannelli impostati sul Spring valore . Ad esempio, un StatusBarPanel oggetto con la relativa AutoSize proprietà impostata su Spring viene abbreviato se un StatusBarPanel oggetto con la AutoSize proprietà impostata su Contents richiede tale spazio.

È possibile usare AutoSize per assicurarsi che il contenuto di un oggetto StatusBarPanel venga visualizzato correttamente in un StatusBar controllo che contiene più pannelli. Ad esempio, è possibile che un pannello contenente testo venga modificato automaticamente in base alla quantità di testo visualizzata (Contents), mentre un altro pannello in StatusBar cui viene visualizzato un indicatore di stato disegnato dal proprietario dovrà essere una dimensione fissa (None).

Vedi anche

• StatusBarPanelAutoSize