Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês
Esta documentação foi arquivada e não está sendo atualizada.

Classe Label

Representa um rótulo padrão do Windows.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (em System.Windows.Forms.dll)

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
[DefaultBindingPropertyAttribute("Text")]
[ComVisibleAttribute(true)]
public class Label : Control

Label controles são normalmente usados para fornecer um texto descritivo para um controle. Por exemplo, você pode usar um Label Para adicionar texto descritivo para um TextBox controle para informar ao usuário sobre o tipo de dado esperado no controle. Label controles também podem ser usados para adicionar texto descritivo para um Form para fornecer ao usuário informações úteis. Por exemplo, você pode adicionar um Label na parte superior de um Form que fornece instruções para o usuário sobre como inserir dados em controles no formulário. Label controles também podem ser usado para executar vídeo time as informações sobre o status de um aplicativo. Por exemplo, você pode adicionar um Label controle a um formulário para exibir o status de cada arquivo sistema autônomo uma lista de arquivos é processada.

A Label participa a ordem de tabulação de um formulário, mas não recebe foco (o próximo controle na ordem de tabulação recebe foco). Por exemplo, se o UseMnemonic propriedade é conjunto para truee um caractere mnemônico — o primeiro caractere após um e comercial (&) — é especificado na Text propriedade do controle, quando o usuário pressionar a tecla ALT + uma tecla mnemônica, foco se move para o próximo controle na ordem de tabulação. Esse recurso fornece navegação pelo teclado para um formulário.Além disso, para exibir texto, a Label controle também pode exibir uma imagem usando o Image propriedade ou uma combinação da ImageIndex e ImageList Propriedades.

ObservaçãoObservação:

A Label pode ser transformado transparente, definindo sua BackColor propriedade para Color.Transparent. Quando você usa um rótulo transparente, use somente o corrente sistema de coordenada de dispositivo para desenhar no contêiner ou o Label plano de fundo pode pintar incorretamente.

O exemplo de código a seguir demonstra como criar um Label controle que tem uma borda tridimensional e contém uma imagem. A imagem é exibida usando o ImageList e ImageIndex Propriedades. O controle também possui uma legenda com um caractere mnemônico especificado.O código de exemplo usa o PreferredHeight e PreferredWidth propriedades para dimensionar corretamente o Label controle. Este exemplo requer que um ImageList foi criado e nomeado imageList1 e que ele foi carregado duas imagens. O exemplo também requer que o código está dentro de um formulário que tenha o System.Drawing espaço para nome adicionado ao seu código.

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



Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

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 for Smartphone, Windows Mobile for Pocket PC

o.NET Framework e.NET Compact Framework não oferecem suporte a todas as versões de cada plataforma. Para obter uma lista de versões suportadas, consulte Requisitos de sistema do .NET framework.

.NET Framework

Compatível com: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatível com: 3.5, 2.0, 1.0
Mostrar: