Label.PreferredWidth Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die bevorzugte Breite des Steuerelements ab.

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

Eigenschaftswert

Int32

Die Breite des Steuerelements (in Pixel) unter der Voraussetzung, dass eine Textzeile angezeigt wird.

Attribute: BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird das Erstellen eines Label Steuerelements mit einem dreidimensionalen Rahmen und einem Bild veranschaulicht, das mithilfe der ImageList Eigenschaften und ImageIndex angezeigt wird. Das Steuerelement verfügt auch über eine Beschriftung mit einem mnemonischen Zeichen. Der Beispielcode verwendet die PreferredHeight Eigenschaften und PreferredWidth , um das Steuerelement auf dem Label Formular, in dem es angezeigt wird, ordnungsgemäß zu vergrößern. Dieses Beispiel erfordert, dass ein ImageList mit dem Namen imageList1 erstellt und zwei Images geladen wurde. Das Beispiel erfordert auch, dass sich der Code in einem Formular befindet, in dem der System.Drawing Namespace dem Code hinzugefügt wurde.

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

Hinweise

Diese Eigenschaft gibt die Länge der Textzeichenfolge zurück, berücksichtigt jedoch keine Zeilenumbrüche. Beispielsweise könnte eine Textzeichenfolge, die eine Breite von 300 Pixeln misst, als drei Zeilen in einer Label angezeigt werden, die nur 100 Pixel breit ist. Die PreferredWidth Eigenschaft gibt weiterhin 300 Pixel zurück. Sie können diese Eigenschaft zusammen mit der PreferredHeight -Eigenschaft verwenden, um sicherzustellen, dass der Text im Label Steuerelement ordnungsgemäß angezeigt wird. Sie können die AutoSize -Eigenschaft verwenden, um die Höhe und Breite des Label Steuerelements basierend auf dem Text und dem Schriftgrad automatisch anzupassen.

Hinweis

Wenn die BorderStyle -Eigenschaft des Steuerelements Label auf BorderStyle.Nonefestgelegt ist, ist der von PreferredWidth der -Eigenschaft zurückgegebene Wert aufgrund fehlender Rahmen größer.

Gilt für:

Freigeben über