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

Label (Clase)

Actualización: noviembre 2007

Representa una etiqueta estándar de Windows.

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

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
[DefaultBindingPropertyAttribute("Text")]
[ComVisibleAttribute(true)]
public class Label : Control
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */
/** @attribute DefaultBindingPropertyAttribute("Text") */
/** @attribute ComVisibleAttribute(true) */
public class Label extends Control
public class Label extends Control

Los controles Label se utilizan normalmente para proporcionar texto descriptivo de un control. Por ejemplo, se puede utilizar un objeto Label para agregar texto descriptivo para un control TextBox e informar al usuario del tipo de datos que se espera tener en el control. Los controles Label se pueden utilizar también para agregar texto descriptivo a un Form para proporcionar al usuario información útil. Por ejemplo, se puede agregar Label en la parte superior de Form que proporciona al usuario instrucciones sobre cómo especificar datos en los controles del formulario. Los controles Label se pueden utilizar también para mostrar información en tiempo de ejecución sobre el estado de una aplicación. Por ejemplo, se puede agregar un control Label a un formulario para mostrar el estado de cada archivo cuando se procesa una lista de archivos.

Label participa en el orden de tabulación de un formulario, pero no recibe el foco (el siguiente control del orden de tabulación recibe el enfoque). Por ejemplo, si la propiedad UseMnemonic está establecida en true y se especifica un carácter mnemotécnico (el primer carácter después del símbolo &) en la propiedad Text del control, cuando el usuario presiona ALT + la tecla mnemotécnica, el foco se mueve hacia el siguiente control del orden de tabulación. Esta característica permite navegar por un formulario mediante el teclado. Además de mostrar texto, el control Label puede mostrar asimismo una imagen mediante la propiedad Image, o una combinación de las propiedades ImageIndex y ImageList.

cca0ee09.alert_note(es-es,VS.90).gifNota:

Para que Label sea transparente, hay que establecer la propiedad BackColor en Color.Transparent. Al utilizar una etiqueta transparente, hay que utilizar sólo el sistema de coordenadas del dispositivo actual para dibujar en el contenedor; en caso contrario, es posible que se pinte incorrectamente el fondo de Label.

En el siguiente ejemplo de código se muestra cómo crear un control Label que tenga un borde tridimensional y una imagen. La imagen 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 correctamente el tamaño del control Label. En este ejemplo se requiere que se haya creado una propiedad ImageList denominada imageList1 y que ésta 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...
}



Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

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

.NET Compact Framework

Compatible con: 3.5, 2.0, 1.0
Mostrar: