Exportar (0) Imprimir
Expandir todo

Label (Clase)

Representa una etiqueta estándar de Windows.

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

'Declaración
<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
Public Class Label
	Inherits Control
'Uso
Dim instance As Label

/** @attribute ComVisibleAttribute(true) */ 
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ 
public class Label extends Control
ComVisibleAttribute(true) 
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
public class Label extends Control
No aplicable.

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 desplazarse 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.

NotaNota:

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 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


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...
}


Los miembros estáticos públicos (Shared en Visual Basic) 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 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

.NET Compact Framework

Compatible con: 2.0, 1.0
Mostrar:
© 2014 Microsoft