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 控件，该控件具有 ImageList 三维边框和使用 和 ImageIndex 属性显示的图像。 控件还具有指定助记符的标题。 示例代码使用 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 像素的文本字符串在 中显示为三行 Label ，宽度仅为 100 像素。 属性 PreferredWidth 仍返回 300 像素。 可以将此属性与 属性一起使用 PreferredHeight ，以确保控件中的 Label 文本正确显示。 可以使用 AutoSize 属性根据文本和字号自动调整控件的高度和宽度 Label 。

注意

BorderStyle如果控件的 Label 属性设置为 BorderStyle.None，则属性返回PreferredWidth的值将因缺少边框而更大。

另请参阅

• PreferredHeight
• AutoSize