Compartilhar via


Rótulos no Xamarin.iOS

O UILabel controle é usado para exibir texto único e de várias linhas, somente leitura.

Implementando um rótulo

Um novo rótulo é criado criando uma instância de um UILabel:

UILabel label = new UILabel();

Rótulos e storyboards

Você também pode adicionar um Rótulo à interface do usuário ao usar o Designer do iOS. Pesquise Rótulo na Caixa de Ferramentas e arraste-o para o modo de exibição:

Rótulo na caixa de ferramentas

As propriedades a seguir podem ser ajustadas no painel de propriedades:

Painel de propriedades label

  • Contexto de Texto – Simples ou Atribuído. O texto sem formatação permite definir os atributos de formatação em toda a cadeia de caracteres. Os textos atribuídos permitem definir a formatação para caracteres ou palavras diferentes na cadeia de caracteres.
  • Cor, Fonte, Alinhamento – Atributos de Formatação que podem ser aplicados ao rótulo.
  • Linhas – define o número de linhas que o rótulo pode abranger. Defina isso como 0 para permitir que o rótulo use quantas linhas forem necessárias.
  • Comportamento – pode ser definido como Habilitado ou Realçado. Habilitado é definido por padrão, o texto desabilitado será exibido em uma cor cinza mais clara. Realçado é desabilitado por padrão e permite que o rótulo seja redesenhado com um estado realçado quando selecionado por um usuário.
  • Quebra de linha e raia de base
    • O Basline determina como o texto será posicionado se os tamanhos de fonte forem diferentes do especificado.
    • Quebras de linha determinam como uma cadeia de caracteres será encapsulada ou truncada se for maior que uma única linha.
  • Autoshrink – determina como o tamanho da fonte será minimizado dentro de um rótulo, se necessário.
  • Realçado, Sombra, Deslocamento – permite definir a cor Hightlighted e Shadow e o deslocamento de sombra.

Truncamento e disposição

Para obter informações sobre como usar as quebras de linha no iOS, consulte a receita Truncar e Quebrar texto .

Formatação de texto e rótulo

Para formatar a cadeia de caracteres usada em um rótulo, você pode definir atributos de formatação em toda a cadeia de caracteres ou usar cadeias de caracteres atribuídas. Os exemplos a seguir mostram como implementá-los:

label = new UILabel(){
                Text = "Hello, this is a string",
                Font = UIFont.FromName("Papyrus", 20f),
                TextColor = UIColor.Magenta,
                TextAlignment = UITextAlignment.Center
            };
label.AttributedText = new NSAttributedString(
                "This is some formatted text",
                font: UIFont.FromName("GillSans", 16.0f),
                foregroundColor: UIColor.Blue,
                backgroundColor: UIColor.White
            );

Para obter mais informações sobre o estilo de texto usando NSAttributedString , consulte a receita de Texto de Estilo .

Por padrão, os rótulos têm o Enabled definido como true, mas é possível defini-lo como desabilitado para dar ao usuário uma dica de que um determinado controle está desabilitado:

label.Enabled = false;

Isso define o rótulo como uma cor cinza clara, conforme ilustrado na imagem de exemplo a seguir da tela Restrições no iOS:

Botão Desabilitado no iOS

Você também pode definir as cores de texto Realce e Sombra para o texto do rótulo para efeitos adicionais:

label.Highlighted = true;
label.HighlightedTextColor = UIColor.Cyan;

label.ShadowColor = UIColor.Black;
label.ShadowOffset = new CoreGraphics.CGSize(1.0f, 1.0f);

O que exibe o texto desta forma:

Realce e Sombra definidos no texto

Para obter mais informações sobre como alterar a fonte de um UILabel, consulte a receita Alterar a fonte .