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

Label.PreferredHeight (Propiedad)

Obtiene el alto preferido del control.

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

public virtual int PreferredHeight { get; }
/** @property */
public int get_PreferredHeight ()

public function get PreferredHeight () : int

No aplicable.

Valor de propiedad

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

Esta propiedad devuelve el alto que debe tener el control para que se muestre correctamente el texto, en función de la fuente asignada al control. Esta propiedad puede utilizarse conjuntamente con la propiedad PreferredWidth para asegurarse de que se muestre correctamente el texto del control Label. Se puede utilizar la propiedad AutoSize para ajustar automáticamente el alto y el ancho del control Label, en función 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 PreferredHeight 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: