StatusBarPanel.AutoSize StatusBarPanel.AutoSize StatusBarPanel.AutoSize StatusBarPanel.AutoSize Property

定義

ステータス バー パネルのサイズを自動調整するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the status bar panel is automatically resized.

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

プロパティ値

例外

プロパティに割り当てられている値は StatusBarPanelAutoSize 列挙体のメンバーではありません。The value assigned to the property is not a member of the StatusBarPanelAutoSize enumeration.

次のコード例ではStatusBar 、フォームにコントロールを作成しStatusBarPanel 、2つのオブジェクトを追加します。The following code example creates a StatusBar control on a form and adds two StatusBarPanel objects. 1つStatusBarPanel目のpanel1名前は、アプリケーションのステータステキストを表示します。The first StatusBarPanel, named panel1, displays status text for an application. 2番StatusBarPanelpanel2のは、 ToolTipText現在の日付を表示し、 StatusBarPanelクラスのプロパティを使用して現在の時刻を表示します。The second StatusBarPanel, named panel2, displays the current date and uses the ToolTipText property of the StatusBarPanel class to display the current time. この例ではShowPanels 、プロパティを使用して、標準パネルではなくパネルが表示されるようPanelsにしStatusBarます。 Addまた、プロパティStatusBar.StatusBarPanelCollectionを使用してのメソッドにアクセスし、パネルをに追加します。The example uses the ShowPanels property to ensure that the panels are displayed instead of a standard panel, and it uses the Panels property to access the Add method of the StatusBar.StatusBarPanelCollection to add the panels to the StatusBar. また、この例でAutoSizeBorderStyle ToolTipText、、、 Text 、およびの各StatusBarPanelプロパティを使用して、オブジェクトを初期化します。The example also uses the AutoSize, BorderStyle, ToolTipText, and Text properties to initialize the StatusBarPanel objects. この例では、例で定義されているメソッドが、 Formのコンストラクターから定義および呼び出されていることを前提としています。This example assumes that the method defined in the example is defined and called from the constructor of a 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

注釈

StatusBarPanelContents設定されたオブジェクトは、 Spring値に設定されたパネルよりも優先されます。StatusBarPanel objects set to Contents have precedence over those panels set to the Spring value. たとえばStatusBarPanel StatusBarPanel Contents AutoSize 、プロパティがに設定Springされたを使用する場合は、プロパティがに設定されているを使用すると、その領域が必要になります。 AutoSizeFor example, a StatusBarPanel that has its AutoSize property set to Spring is shortened if a StatusBarPanel with the AutoSize property set to Contents requires that space.

を使用AutoSizeすると、のコンテンツが、 StatusBarPanel複数のパネルを含むStatusBarコントロールに正しく表示されるようにすることができます。You can use AutoSize to ensure that the contents of a StatusBarPanel are properly displayed in a StatusBar control that contains more than one panel. たとえば、表示されているテキストの量 (Contents) に合わせて自動的に調整するテキストを含むパネルが必要になる場合がありますが、オーナー描画の進行状況バーを表示するのStatusBar別のパネルNoneは固定サイズ () である必要があります。For example, you might want a panel that contains text to adjust automatically to the amount of text it is displaying (Contents), while another panel on the StatusBar that displays an owner-drawn progress bar would need to be a fixed size (None).

適用対象

こちらもご覧ください