StatusBarPanel.AutoSize Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Získá nebo nastaví hodnotu označující, zda je automaticky změněna velikost panelu stavového řádku.

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

Hodnota vlastnosti

StatusBarPanelAutoSize

Jedna z StatusBarPanelAutoSize hodnot. Výchozí formát je None.

Výjimky

InvalidEnumArgumentException

Hodnota přiřazená vlastnosti není členem výčtu StatusBarPanelAutoSize .

Příklady

Následující příklad kódu vytvoří ovládací prvek StatusBar ve formuláři a přidá dva StatusBarPanel objekty. První StatusBarPanels názvem panel1zobrazí text stavu aplikace. Druhý StatusBarPanelobjekt s názvem panel2zobrazí aktuální datum a použije ToolTipText vlastnost StatusBarPanel třídy k zobrazení aktuálního času. Příklad používá ShowPanels vlastnost k zajištění, že se panely zobrazí místo standardního panelu, a používá Panels vlastnost pro přístup Add k metodě objektu StatusBar.StatusBarPanelCollection pro přidání panelů do StatusBar. Příklad také používá AutoSizevlastnosti , BorderStyleToolTipText, a Text k inicializaci StatusBarPanel objektů. Tento příklad předpokládá, že metoda definovaná v příkladu je definována a volána z konstruktoru objektu 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

Poznámky

StatusBarPanel objekty nastavené tak, aby Contents měly přednost před těmito panely nastavenými na Spring hodnotu. Například vlastnost, která má nastavenou AutoSizeStatusBarPanel naSpring, je zkrácena, pokud StatusBarPanel vlastnost s nastavenou AutoSize na Contents vyžaduje tento prostor.

Pomocí příkazu můžete AutoSize zajistit, aby se obsah objektu StatusBarPanel správně zobrazoval v ovládacím StatusBar prvku, který obsahuje více než jeden panel. Můžete například chtít, aby se panel obsahující text automaticky přizpůsobil množství zobrazeného textu (Contents), zatímco jiný panel na panelu StatusBar , který zobrazuje indikátor průběhu nakreslený vlastníkem, musí mít pevnou velikost (None).

Viz také

• StatusBarPanelAutoSize