Label.AutoSize プロパティ

定義

内容をすべて表示するためにコントロールのサイズを自動調整するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the control is automatically resized to display its entire contents.

public:
 virtual property bool AutoSize { bool get(); void set(bool value); };
[System.ComponentModel.Browsable(true)]
public virtual bool AutoSize { get; set; }
member this.AutoSize : bool with get, set
Public Overridable Property AutoSize As Boolean

プロパティ値

表示内容に合わせてコントロールの幅を調整する場合は true。それ以外の場合は falsetrue if the control adjusts its width to closely fit its contents; otherwise, false.


デザイナーを使用してフォームに追加されると、既定値は true になります。When added to a form using the designer, the default value is true. コードからインスタンス化されたときの既定値は false です。When instantiated from code, the default value is false.

属性

次のコード例は、AutoSize プロパティを示しています。The following code example demonstrates the AutoSize property. この例を実行するには、フォームに次のコードを貼り付け、フォームのコンストラクターまたは Load メソッドから InitializeLabel メソッドを呼び出します。To run this example, paste the following code in a form and call the InitializeLabel method from the form's constructor or Load method.

   // Declare a label.
internal:
   System::Windows::Forms::Label ^ Label1;

private:

   // Initialize the label.
   void InitializeLabel()
   {
      this->Label1 = gcnew Label;
      this->Label1->Location = 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 = 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.";
   }
// 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.";

}
' 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

注釈

このプロパティが trueに設定されている場合、Label はその幅を調整してコンテンツ全体を表示します。When this property is set to true, the Label adjusts its width to display its entire contents. このプロパティは、通常、Label コントロールを使用して、アプリケーションプロセスの状態など、さまざまなテキストの長さを表示する場合に true に設定されます。This property is typically set to true when you use a Label control to display various lengths of text, such as the status of an application process. このプロパティは、アプリケーションでさまざまな言語のテキストを表示するときに、Windows の言語設定に基づいてテキストのサイズが増減する場合にも使用できます。You can also use this property when the application will display text in various languages, and the size of the text might increase or decrease based on the language settings in Windows.

重要

フォントが Label の高さよりも高さが高く、AutoEllipsistrue場合は、テキストを描画するために AutoSizefalse に設定する必要があります。If the font is taller than the height of the Label and AutoEllipsis is true, you must set AutoSize to false for text to be drawn.

適用対象

こちらもご覧ください