Esta documentación está archivada y no tiene mantenimiento.

Label.PreferredWidth (Propiedad)

Obtiene el ancho preferido del control.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

public virtual int PreferredWidth { get; }
/** @property */
public int get_PreferredWidth ()

public function get PreferredWidth () : int

No aplicable.

Valor de propiedad

Ancho del control, en píxeles, suponiendo que se muestra una sola línea de texto.

Esta propiedad devuelve la longitud de la cadena de texto, pero no tiene en cuenta el ajuste de línea. Por ejemplo, una cadena de texto cuyo ancho es de 300 píxeles puede mostrarse como tres líneas en Label cuyo ancho es de sólo 100 píxeles. La propiedad PreferredWidth sigue devolviendo 300 píxeles. Esta propiedad puede utilizarse junto con la propiedad PreferredHeight para asegurarse de que se muestra correctamente el texto del control Label. Se puede utilizar la propiedad AutoSize para ajustar automáticamente el alto y el ancho del control Label, dependiendo del texto y del tamaño de fuente.

NotaNota:

Si la propiedad BorderStyle del control Label se establece en BorderStyle.None, el valor devuelto por la propiedad PreferredWidth será mayor debido a la falta de bordes.

En el siguiente ejemplo de código se muestra cómo crear un control Label con un borde tridimensional y una imagen que se muestra mediante las propiedades ImageList y ImageIndex. El control también dispone de un título con un carácter de tecla de acceso especificado. El código de ejemplo utiliza las propiedades PreferredHeight y PreferredWidth para ajustar adecuadamente el tamaño del control Label en el formulario en el que se muestra. En este ejemplo se requiere que se haya creado un objeto ImageList denominado imageList1 y que éste haya cargado dos imágenes. En el ejemplo se requiere también que el código pertenezca a un formulario que tenga el espacio de nombres System.Drawing agregado a su código.

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 void CreateMyLabel()
{
    // Create an instance of a Label.
    Label label1 = new Label();
    // Set the border to a three-dimensional border.
    label1.set_BorderStyle(System.Windows.Forms.BorderStyle.Fixed3D);
    // Set the ImageList to use for displaying an image.
    label1.set_ImageList(imageList1);
    // Use the second image in imageList1.
    label1.set_ImageIndex(1);
    // Align the image to the top left corner.
    label1.set_ImageAlign(ContentAlignment.TopLeft);
    // Specify that the text can display mnemonic characters.
    label1.set_UseMnemonic(true);
    // Set the text of the control and specify a mnemonic character.
    label1.set_Text("First &Name:");
    /* Set the size of the control based on the PreferredHeight
       and PreferredWidth values. */
    label1.set_Size(new Size(label1.get_PreferredWidth(), 
        label1.get_PreferredHeight()));
    //...Code to add the control to the form...
} //CreateMyLabel 

public function CreateMyLabel()
{
   // Create an instance of a Label.
   var label1 : Label = 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 System.Drawing.Size (label1.PreferredWidth, label1.PreferredHeight);

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


Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0
Mostrar: