Label.AutoSize プロパティ

内容をすべて表示するためにコントロールのサイズを自動調整するかどうかを示す値を取得または設定します。

Public Overridable Property AutoSize As Boolean
[C#]
public virtual bool AutoSize {get; set;}
[C++]
public: __property virtual bool get_AutoSize();public: __property virtual void set_AutoSize(bool);
[JScript]
public function get AutoSize() : Boolean;public function set AutoSize(Boolean);

プロパティ値

表示内容に合わせてコントロールの幅を調整する場合は true 。それ以外の場合は false 。既定値は false です。

解説

このプロパティを true に設定すると、内容全体が表示されるように Label の幅が調整されます。 Label コントロールを使用して、長さが変化するテキスト (アプリケーション プロセスのステータスなど) を表示する場合は、通常、このプロパティを true に設定します。アプリケーションが各種言語でテキストを表示し、テキスト サイズが Windows の言語設定に基づいて変化する場合も、このプロパティを使用できます。

使用例

[Visual Basic, C#] AutoSize プロパティの使用例を次に示します。この例を実行するには、フォーム内に以下のコードを貼り付けて、フォームのコンストラクタまたは Load メソッドから InitializeLabel メソッドを呼び出します。

 
' Declare a label.
Friend WithEvents Label1 As System.Windows.Forms.Label

' Initialize the label.
Private Sub InitializeLabel()
    Me.Label1 = New Label
    Me.Label1.Location = New System.Drawing.Point(10, 10)
    Me.Label1.Name = "Label1"
    Me.Label1.TabIndex = 0

    ' Set the label to a small size, but set the AutoSize property 
    ' to true. The label will adjust its length so all the text
    ' is visible, however if the label is wider than the form,
    ' the entire label will not be visible.
    Me.Label1.Size = New System.Drawing.Size(10, 10)
    Me.Controls.Add(Me.Label1)
    Me.Label1.AutoSize = True
    Me.Label1.Text = "The text in this label is longer than the set size."

End Sub

[C#] 
// Declare a label.
internal System.Windows.Forms.Label Label1;

// Initialize the label.
private void InitializeLabel()
{
    this.Label1 = new Label();
    this.Label1.Location = new System.Drawing.Point(10, 10);
    this.Label1.Name = "Label1";
    this.Label1.TabIndex = 0;

    // Set the label to a small size, but set the AutoSize property 
    // to true. The label will adjust its length so all the text
    // is visible, however if the label is wider than the form,
    // the entire label will not be visible.
    this.Label1.Size = new System.Drawing.Size(10, 10);
    this.Controls.Add(this.Label1);
    this.Label1.AutoSize = true;
    this.Label1.Text = "The text in this label is longer" +  
        " than the set size.";

}

[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

Label クラス | Label メンバ | System.Windows.Forms 名前空間 | Text | PreferredHeight | PreferredWidth