Label.AutoSize プロパティ

  • リファレンス

定義

名前空間:
System.Windows.Forms
アセンブリ:
System.Windows.Forms.dll

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

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

プロパティ値

Boolean

表示内容に合わせてコントロールの幅を調整する場合は true。それ以外の場合は false。 デザイナーを使用してフォームに追加されると、既定値は true になります。 コードからインスタンス化されたときの既定値は false です。

属性
BrowsableAttribute

例

次のコード例は、このプロパティを AutoSize 示しています。 この例を実行するには、フォームに次のコードを貼り付け、フォームのコンストラクターまたはLoadメソッドからメソッドを呼び出InitializeLabelします。

   // 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 表示するように幅が調整されます。 通常、このプロパティは、アプリケーション プロセスの状態など、テキストのさまざまな長さを表示するためにコントロールを使用Labelする場合に設定trueされます。 このプロパティは、アプリケーションがさまざまな言語でテキストを表示し、Windowsの言語設定に基づいてテキストのサイズが増減する場合にも使用できます。

重要

フォントが高さと高さLabelAutoEllipsisより高い場合はtrue、テキストをfalse描画するように設定AutoSizeする必要があります。

適用対象

こちらもご覧ください