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:
As propriedades a seguir podem ser ajustadas no painel de propriedades:
- 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:
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:
Para obter mais informações sobre como alterar a fonte de um UILabel, consulte a receita Alterar a fonte .