Label.PreferredWidth Eigenschap

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

Waarde van eigenschap

De breedte van het besturingselement (in pixels), ervan uitgaande dat één regel tekst wordt weergegeven.

Kenmerken

BrowsableAttribute

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een Label besturingselement maakt met een driedimensionale rand en een afbeelding die wordt weergegeven met behulp van de ImageList en ImageIndex eigenschappen. Het besturingselement heeft ook een bijschrift met een mnemonic teken opgegeven. In de voorbeeldcode worden de PreferredHeight en PreferredWidth eigenschappen gebruikt om het besturingselement op de Label juiste manier te wijzigen in het formulier waarop het wordt weergegeven. In dit voorbeeld is vereist dat er een ImageList imageList1 is gemaakt en benoemd en dat er twee installatiekopieën zijn geladen. Het voorbeeld vereist ook dat de code zich in een formulier bevindt waaraan de naamruimte is toegevoegd aan de System.Drawing bijbehorende code.

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

Opmerkingen

Deze eigenschap retourneert de lengte van de tekenreeks, maar houdt geen rekening met regelterugloop. Een tekenreeks met een breedte van 300 pixels kan bijvoorbeeld worden weergegeven als drie regels in een tekenreeks Label van slechts 100 pixels breed. De PreferredWidth eigenschap retourneert nog steeds 300 pixels. U kunt deze eigenschap, samen met de PreferredHeight eigenschap, gebruiken om ervoor te zorgen dat de tekst in het Label besturingselement correct wordt weergegeven. U kunt de AutoSize eigenschap gebruiken om de hoogte en breedte van het Label besturingselement automatisch aan te passen op basis van de tekst en tekengrootte.

Zie ook

• PreferredHeight
• AutoSize