Label.PreferredWidth 屬性

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

取得控制項的慣用寬度。

public:
 virtual property int PreferredWidth { int get(); };

[System.ComponentModel.Browsable(false)]
public virtual int PreferredWidth { get; }

[<System.ComponentModel.Browsable(false)>]
member this.PreferredWidth : int

Public Overridable ReadOnly Property PreferredWidth As Integer

屬性值

Int32

控制項的寬度 (單位為像素)，假設所顯示的是單行文字。

屬性

BrowsableAttribute

範例

下列程式碼範例示範如何建立 Label 控制項，其中包含使用 和 ImageIndex 屬性顯示的 ImageList 三維框線和影像。 控制項也有指定助記字元的標題。 範例程式碼會使用 PreferredHeight 和 PreferredWidth 屬性，在顯示控制項的表單上適當地調整其大小 Label 。 此範例要求 ImageList 已建立並命名為 imageList1，且已載入兩個映射。 此範例也需要程式碼位於命名空間已新增至其程式碼的表單 System.Drawing 內。

public:
   void CreateMyLabel()
   {
      // Create an instance of a Label.
      Label^ label1 = gcnew Label;
      
      // Set the border to a three-dimensional border.
      label1->BorderStyle = System::Windows::Forms::BorderStyle::Fixed3D;
      // Set the ImageList to use for displaying an image.
      label1->ImageList = imageList1;
      // Use the second image in imageList1.
      label1->ImageIndex = 1;
      // Align the image to the top left corner.
      label1->ImageAlign = ContentAlignment::TopLeft;
      
      // Specify that the text can display mnemonic characters.
      label1->UseMnemonic = true;
      // Set the text of the control and specify a mnemonic character.
      label1->Text = "First &Name:";
      
      /* Set the size of the control based on the PreferredHeight and PreferredWidth values. */
      label1->Size = System::Drawing::Size( label1->PreferredWidth, label1->PreferredHeight );
      
      //...Code to add the control to the form...
   }

public void CreateMyLabel()
{
   // Create an instance of a Label.
   Label label1 = new Label();

   // Set the border to a three-dimensional border.
   label1.BorderStyle = System.Windows.Forms.BorderStyle.Fixed3D;
   // Set the ImageList to use for displaying an image.
   label1.ImageList = imageList1;
   // Use the second image in imageList1.
   label1.ImageIndex = 1;
   // Align the image to the top left corner.
   label1.ImageAlign = ContentAlignment.TopLeft;

   // Specify that the text can display mnemonic characters.
   label1.UseMnemonic = true;
   // Set the text of the control and specify a mnemonic character.
   label1.Text = "First &Name:";
   
   /* Set the size of the control based on the PreferredHeight and PreferredWidth values. */
   label1.Size = new Size (label1.PreferredWidth, label1.PreferredHeight);

   //...Code to add the control to the form...
}

Public Sub CreateMyLabel()
    ' Create an instance of a Label.
    Dim label1 As New Label()
       
    ' Set the border to a three-dimensional border.
    label1.BorderStyle = System.Windows.Forms.BorderStyle.Fixed3D
    ' Set the ImageList to use for displaying an image.
    label1.ImageList = imageList1
    ' Use the second image in imageList1.
    label1.ImageIndex = 1
    ' Align the image to the top left corner.
    label1.ImageAlign = ContentAlignment.TopLeft
     
    ' Specify that the text can display mnemonic characters.
    label1.UseMnemonic = True
    ' Set the text of the control and specify a mnemonic character.
    label1.Text = "First &Name:"
       
    ' Set the size of the control based on the PreferredHeight and PreferredWidth values. 
    label1.Size = New Size(label1.PreferredWidth, label1.PreferredHeight)

    '...Code to add the control to the form...
End Sub

備註

此屬性會傳回文字字串的長度，但不會考慮換行。 例如，測量 300 圖元寬的文字字串可以顯示為只有 100 圖元寬的 三 Label 行。 屬性 PreferredWidth 仍然會傳回 300 圖元。 您可以使用這個屬性以及 PreferredHeight 屬性，以確保控制項中的 Label 文字正確顯示。 您可以使用 AutoSize 屬性，根據文字和字型大小自動調整控制項的高度和寬度 Label 。

注意

BorderStyle如果控制項的 Label 屬性設定 BorderStyle.None 為 ，則屬性所 PreferredWidth 傳回的值會因為缺少框線而較大。

另請參閱

• PreferredHeight
• AutoSize