Label Classe

Definição

Um View que exibe texto.

[Xamarin.Forms.ContentProperty("Text")]
[Xamarin.Forms.RenderWith(typeof(Xamarin.Forms.Platform._LabelRenderer))]
public class Label : Xamarin.Forms.View, Xamarin.Forms.IDecorableTextElement, Xamarin.Forms.IElementConfiguration<Xamarin.Forms.Label>, Xamarin.Forms.Internals.IFontElement
type Label = class
    inherit View
    interface IFontElement
    interface IElementConfiguration<Label>
    interface IDecorableTextElement
Herança
Atributos
Implementações

Comentários

Um rótulo é usado para exibir elementos de texto de linha única, bem como blocos de texto de várias linhas.

O exemplo a seguir, adaptado da solução Xamarin. Forms padrão, mostra um uso básico:

public class App : Application
{
    public App ()
    {
    MainPage = new ContentPage { 
        Content = new Label {
            Text = "Hello, Forms!",
            FontSize = Device.GetNamedSize (NamedSize.Large, typeof(Label)),
            VerticalOptions = LayoutOptions.CenterAndExpand,
            HorizontalOptions = LayoutOptions.CenterAndExpand,
        },
    };
}

O exemplo FormsGallery, que pode ser encontrado na página , tem um arquivo LabelDemoPage.cs. Esse arquivo contém um exemplo mais longo e mais completo.

Construtores

Label()

Inicializa uma nova instância da classe Label.

Campos

CharacterSpacingProperty
FontAttributesProperty

Repositório de backup para a propriedade FontAttributes.

FontFamilyProperty

Repositório de backup para a propriedade FontFamily.

FontProperty

Repositório de backup para a propriedade associável de Fonte.

FontSizeProperty

Repositório de backup para a propriedade FontSize.

FormattedTextProperty

Repositório de backup para a propriedade FormattedText.

HorizontalTextAlignmentProperty

Identifica a propriedade associável HorizontalTextAlignment

LineBreakModeProperty

Repositório de backup par a propriedade associável LineBreakMode.

LineHeightProperty

Repositório de backup da propriedade associável LineHeight.

MaxLinesProperty

Método estático fornecendo o BindableProperty para MaxLines.

PaddingProperty
TextColorProperty

Repositório de backup para a propriedade associável TextColor.

TextDecorationsProperty

Método estático fornecendo o BindableProperty associado com TextDecorations.

TextProperty

Repositório de backup para a propriedade associável Text.

TextTransformProperty
TextTypeProperty

Repositório de backup para a propriedade ligável TextType.

VerticalTextAlignmentProperty

Identifica a propriedade associável VerticalTextAlignment.

XAlignProperty
Obsoleto.

Repositório de backup para a propriedade associável XAlign.

YAlignProperty
Obsoleto.

Repositório de backup para a propriedade associável YAlign.

Propriedades

AnchorX

Obtém ou define o componente X do ponto central para qualquer transformação relativa aos limites do elemento. Esta é uma propriedade associável.

(Herdado de VisualElement)
AnchorY

Obtém ou define o componente Y do ponto central para qualquer transformação relativa aos limites do elemento. Esta é uma propriedade associável.

(Herdado de VisualElement)
AutomationId

Obtém ou define um valor que permite à estrutura de automação encontrar e interagir com esse elemento.

(Herdado de Element)
Background (Herdado de VisualElement)
BackgroundColor

Obtém ou define a cor que preencherá a tela de fundo de um VisualElement. Esta é uma propriedade associável.

(Herdado de VisualElement)
Batched

Para uso interno pela plataforma do Xamarin.Forms.

(Herdado de VisualElement)
Behaviors

Obtém a lista de Comportamentos associados a este elemento. Esta é uma propriedade associável.

(Herdado de VisualElement)
BindingContext

Obtém ou define o objeto que contém as propriedades que serão o destino das propriedades associadas que pertencem a este BindableObject.

(Herdado de BindableObject)
Bounds

Obtém os limites do elemento.

(Herdado de VisualElement)
CharacterSpacing
class (Herdado de NavigableElement)
ClassId

Obtém ou define um valor usado para identificar uma coleção de elementos semanticamente semelhantes.

(Herdado de Element)
Clip (Herdado de VisualElement)
DisableLayout

Para uso interno pela plataforma do Xamarin.Forms.

(Herdado de VisualElement)
Dispatcher (Herdado de BindableObject)
EffectControlProvider

Para uso interno pela plataforma do Xamarin.Forms.

(Herdado de Element)
Effects

Uma lista dos efeitos que são aplicados a este item.

(Herdado de Element)
FlowDirection

Obtém ou define a direção do fluxo de layout.

(Herdado de VisualElement)
Font
Obsoleto.

Obtém ou define a Fonte do Rótulo. Esta é uma propriedade associável.

FontAttributes

Obtém um valor que indica se a fonte para o rótulo está em negrito, itálico ou nenhum.

FontFamily

Obtém ou define a família de fontes à qual pertence a fonte para o rótulo.

FontSize

Obtém o tamanho da fonte para o rótulo.

FormattedText

Obtém ou define o texto formatado para o rótulo. Esta é uma propriedade associável.

GestureController

Obtém o controlador de gestos da exibição.

(Herdado de View)
GestureRecognizers

A coleção de identificadores de gesto associados à exibição.

(Herdado de View)
Height

Obtém a altura renderizada atual desse elemento. Essa é uma propriedade associável somente leitura.

(Herdado de VisualElement)
HeightRequest

Obtém ou define a substituição de altura desejada deste elemento.

(Herdado de VisualElement)
HorizontalOptions

Obtém ou define o LayoutOptions que define como o elemento é colocado em um ciclo de layout. Esta é uma propriedade associável.

(Herdado de View)
HorizontalTextAlignment

Obtém ou define o alinhamento horizontal da propriedade Text. Esta é uma propriedade associável.

Id

Obtém um valor que pode ser usado para identificar exclusivamente um elemento por meio da execução de um aplicativo.

(Herdado de Element)
InputTransparent

Obtém ou define um valor que indica se esse elemento deve ser envolvido no ciclo de interação do usuário. Esta é uma propriedade associável.

(Herdado de VisualElement)
IsEnabled

Obtém ou define um valor que indica se esse elemento está habilitado na interface do usuário. Esta é uma propriedade associável.

(Herdado de VisualElement)
IsFocused

Obtém um valor que indica se esse elemento está focalizado atualmente. Esta é uma propriedade associável.

(Herdado de VisualElement)
IsInNativeLayout

Para uso interno pela plataforma do Xamarin.Forms.

(Herdado de VisualElement)
IsNativeStateConsistent

Para uso interno pela plataforma do Xamarin.Forms.

(Herdado de VisualElement)
IsPlatformEnabled

Para uso interno pela plataforma do Xamarin.Forms.

(Herdado de VisualElement)
IsTabStop

Obtém ou define um valor que indica se este elemento está incluído na navegação pela tecla Tab. Esta é uma propriedade associável.

(Herdado de VisualElement)
IsVisible

Obtém ou define um valor que determina se esses elementos devem fazer parte da árvore visual ou não. Esta é uma propriedade associável.

(Herdado de VisualElement)
LineBreakMode

Obtém ou define o LineBreakMode para o Rótulo. Esta é uma propriedade associável.

LineHeight

Obtém ou define o multiplicador a aplicar à altura de linha padrão ao exibir texto.

LogicalChildren

Para uso interno pela plataforma do Xamarin.Forms.

(Herdado de Element)
Margin

Obtém ou define a margem para a exibição.

(Herdado de View)
MaxLines

Obtém ou define o número máximo de linhas permitidas em Label.

MinimumHeightRequest

Obtém ou define um valor que substitui a altura mínima que o elemento solicitará durante o layout.

(Herdado de VisualElement)
MinimumWidthRequest

Obtém ou define um valor que substitui a largura mínima que o elemento solicitará durante o layout.

(Herdado de VisualElement)
Navigation (Herdado de NavigableElement)
NavigationProxy (Herdado de NavigableElement)
Opacity

Obtém ou define o valor de opacidade aplicado ao elemento quando ele é renderizado. Esta é uma propriedade associável.

(Herdado de VisualElement)
Padding
Parent

Obtém ou define o elemento pai do elemento.

(Herdado de Element)
ParentView
Obsoleto.

Obtém o elemento que é o ancestral mais próximo desse elemento que é um VisualElement.

(Herdado de Element)
Platform
Obsoleto.
(Herdado de Element)
RealParent

Para uso interno pela plataforma do Xamarin.Forms.

(Herdado de Element)
Resources

Obtém ou define o dicionário de recursos locais.

(Herdado de VisualElement)
Rotation

Obtém ou define a rotação (em graus) sobre o eixo Z (rotação afim) quando o elemento é renderizado.

(Herdado de VisualElement)
RotationX

Obtém ou define a rotação (em graus) sobre o eixo X (rotação de perspectiva) quando o elemento é renderizado.

(Herdado de VisualElement)
RotationY

Obtém ou define a rotação (em graus) sobre o eixo Y (rotação de perspectiva) quando o elemento é renderizado.

(Herdado de VisualElement)
Scale

Obtém ou define o fator de escala aplicado ao elemento.

(Herdado de VisualElement)
ScaleX

Obtém ou define um valor de escala para aplicar à direção X.

(Herdado de VisualElement)
ScaleY

Obtém ou define um valor de escala para aplicar à direção Y.

(Herdado de VisualElement)
Style (Herdado de NavigableElement)
StyleClass (Herdado de NavigableElement)
StyleId

Obtém ou define um valor definido pelo usuário para identificar exclusivamente o elemento.

(Herdado de Element)
TabIndex (Herdado de VisualElement)
Text

Obtém ou define o texto do Rótulo. Esta é uma propriedade associável.

TextColor

Obtém ou define o Color para o texto deste Rótulo. Esta é uma propriedade associável.

TextDecorations

Obtém ou define o TextDecorations aplicado ao Text.

TextTransform
TextType

Determina se o rótulo deve exibir texto sem formatação ou HTML.

TranslationX

Obtém ou define o delta de translação de X do elemento.

(Herdado de VisualElement)
TranslationY

Obtém ou define o delta de translação de Y do elemento.

(Herdado de VisualElement)
Triggers

Obtém a lista de Gatilho associado a este elemento. Esta é uma propriedade associável.

(Herdado de VisualElement)
VerticalOptions

Obtém ou define o LayoutOptions que define como o elemento é colocado em um ciclo de layout. Esta é uma propriedade associável.

(Herdado de View)
VerticalTextAlignment

Obtém ou define o alinhamento vertical da propriedade Text. Esta é uma propriedade associável.

Visual (Herdado de VisualElement)
Width

Obtém a largura renderizada atual deste elemento. Essa é uma propriedade associável somente leitura.

(Herdado de VisualElement)
WidthRequest

Obtém ou define a substituição de largura desejada deste elemento.

(Herdado de VisualElement)
X

Obtém a posição X atual desse elemento. Essa é uma propriedade associável somente leitura.

(Herdado de VisualElement)
XAlign
Obsoleto.

Obtém ou define o alinhamento horizontal do texto dentro do rótulo associado.

Y

Obtém a posição Y atual desse elemento. Essa é uma propriedade associável somente leitura.

(Herdado de VisualElement)
YAlign
Obsoleto.

Obtém ou define o alinhamento vertical do Texto dentro do Rótulo associado.

Métodos

ApplyBindings()

Aplicar as associações a BindingContext.

(Herdado de BindableObject)
BatchBegin()

Sinaliza o início de um lote de alterações às propriedades de elementos.

(Herdado de VisualElement)
BatchCommit()

Sinaliza o término de um lote de comandos para o elemento e que esses comandos agora devem ser confirmados.

(Herdado de VisualElement)
ChangeVisualState()

Para uso interno pela plataforma do Xamarin.Forms.

(Herdado de VisualElement)
ClearValue(BindableProperty)

Limpa qualquer valor definido por SetValue para property.

(Herdado de BindableObject)
ClearValue(BindablePropertyKey)

Limpa qualquer valor definido por SetValue para a propriedade identificada por propertyKey.

(Herdado de BindableObject)
CoerceValue(BindableProperty) (Herdado de BindableObject)
CoerceValue(BindablePropertyKey) (Herdado de BindableObject)
Descendants()

Para uso interno pela plataforma do Xamarin.Forms.

(Herdado de Element)
EffectIsAttached(String)

Para uso interno pela plataforma do Xamarin.Forms.

(Herdado de Element)
FindByName(String)

Retorna o elemento que tem o nome especificado.

(Herdado de Element)
Focus()

Tenta definir o foco para esse elemento.

(Herdado de VisualElement)
GetChildElements(Point)

Retorna os elementos filho que estão embaixo do ponto especificado.

GetSizeRequest(Double, Double)
Obsoleto.

Retorna o SizeRequest do elemento. Chamar esse método começa a passagem de medida de um ciclo de layout.

(Herdado de VisualElement)
GetValue(BindableProperty)

Retorna o valor contido na BindableProperty.

(Herdado de BindableObject)
GetValues(BindableProperty, BindableProperty)
Obsoleto.

Para uso interno pela plataforma do Xamarin.Forms.

(Herdado de BindableObject)
GetValues(BindableProperty, BindableProperty, BindableProperty)
Obsoleto.

Para uso interno pela plataforma do Xamarin.Forms.

(Herdado de BindableObject)
InvalidateMeasure()

Método chamado para invalidar o layout desse VisualElement. Aciona o evento MeasureInvalidated.

(Herdado de VisualElement)
InvalidateMeasureNonVirtual(InvalidationTrigger)

Para uso interno pela plataforma do Xamarin.Forms.

(Herdado de VisualElement)
IsSet(BindableProperty)

Retornará true se a propriedade de destino existir e tiver sido definida.

(Herdado de BindableObject)
Layout(Rectangle)

Atualiza os limites do elemento durante o ciclo de layout.

(Herdado de VisualElement)
Measure(Double, Double, MeasureFlags)

Retorna o tamanho mínimo que um elemento visual precisa ter para ser exibido no dispositivo.

(Herdado de VisualElement)
NativeSizeChanged()

Para uso interno pela plataforma do Xamarin.Forms.

(Herdado de VisualElement)
On<T>()

Retorna a instância específica da plataforma desse Label, em que um método específico de plataforma pode ser chamado.

OnBindingContextChanged()

Método chamado quando o contexto de associação é alterado.

OnChildAdded(Element)

Os desenvolvedores de aplicativos podem substituir este método para responder quando um filho é adicionado.

(Herdado de VisualElement)
OnChildRemoved(Element)
Obsoleto.

Os desenvolvedores de aplicativos podem substituir este método para responder quando um filho é removido.

(Herdado de VisualElement)
OnChildRemoved(Element, Int32) (Herdado de VisualElement)
OnChildrenReordered()

Invocado sempre que o evento ChildrenReordered está prestes a ser emitido. Implemente esse método para adicionar tratamento de classe a esse evento.

(Herdado de VisualElement)
OnMeasure(Double, Double)

Método chamado quando ocorre uma medida de layout.

(Herdado de VisualElement)
OnParentSet() (Herdado de NavigableElement)
OnPropertyChanged(String)

Método chamado quando uma propriedade associada é alterada.

(Herdado de Element)
OnPropertyChanging(String)

Chame esse método de uma classe filho para notificar que uma alteração vai acontecer em uma propriedade.

(Herdado de BindableObject)
OnSizeAllocated(Double, Double)

Esse método é chamado quando o tamanho do elemento é definido durante um ciclo de layout. Esse método é chamado diretamente antes de o evento SizeChanged ser emitido. Implemente esse método para adicionar tratamento de classe a esse evento.

(Herdado de VisualElement)
OnSizeRequest(Double, Double)
Obsoleto.

Esse método é chamado durante a passagem de medida de um ciclo de layout para obter o tamanho desejado de um elemento.

(Herdado de VisualElement)
OnTabIndexPropertyChanged(Int32, Int32) (Herdado de VisualElement)
OnTabStopPropertyChanged(Boolean, Boolean) (Herdado de VisualElement)
RemoveBinding(BindableProperty)

Remove uma associação definida anteriormente.

(Herdado de BindableObject)
RemoveDynamicResource(BindableProperty)

Remove um recurso dinâmico definido anteriormente

(Herdado de Element)
SetBinding(BindableProperty, BindingBase)

Atribui uma associação a uma propriedade.

(Herdado de BindableObject)
SetDynamicResource(BindableProperty, String)

Define a propriedade BindableProperty desse elemento a ser atualizada por meio de DynamicResource com a chave fornecida.

(Herdado de Element)
SetValue(BindableProperty, Object)

Define o valor da propriedade especificada.

(Herdado de BindableObject)
SetValue(BindablePropertyKey, Object)

Define o valor da propertyKey.

(Herdado de BindableObject)
SetValueCore(BindableProperty, Object, SetValueFlags)

Para uso interno pela plataforma do Xamarin.Forms.

(Herdado de BindableObject)
SetValueFromRenderer(BindableProperty, Object)

Para uso interno pela plataforma do Xamarin.Forms.

(Herdado de Element)
SetValueFromRenderer(BindablePropertyKey, Object)

Para uso interno pela plataforma do Xamarin.Forms.

(Herdado de Element)
SizeAllocated(Double, Double)

SizeAllocated é chamado durante um ciclo de layout para sinalizar o início de um layout de subárvore.

(Herdado de VisualElement)
TabIndexDefaultValueCreator() (Herdado de VisualElement)
TabStopDefaultValueCreator() (Herdado de VisualElement)
UnapplyBindings()

Cancela a aplicação de todas as associações definidas anteriormente.

(Herdado de BindableObject)
Unfocus()

Remove o foco desse elemento.

(Herdado de VisualElement)
UpdateFormsText(String, TextTransform)

Eventos

BatchCommitted

Para uso interno pela plataforma do Xamarin.Forms.

(Herdado de VisualElement)
BindingContextChanged

Gerado sempre que a propriedade BindingContext muda.

(Herdado de BindableObject)
ChildAdded

Ocorre sempre que um elemento filho é adicionado ao elemento.

(Herdado de Element)
ChildRemoved

Ocorre sempre que um elemento filho é removido do elemento.

(Herdado de Element)
ChildrenReordered

Ocorre quando os Filhos de um VisualElement foram reordenados.

(Herdado de VisualElement)
DescendantAdded

Ocorre sempre que um elemento filho é adicionado à subárvore dos elementos.

(Herdado de Element)
DescendantRemoved

Ocorre sempre que um elemento filho é removido da subárvore de elementos.

(Herdado de Element)
FocusChangeRequested

Para uso interno pela plataforma do Xamarin.Forms.

(Herdado de VisualElement)
Focused

Ocorre quando o elemento recebe o foco.

(Herdado de VisualElement)
MeasureInvalidated

Evento gerado quando o layout de um elemento visual é invalidado.

(Herdado de VisualElement)
PlatformSet
Obsoleto.
(Herdado de Element)
PropertyChanged

Gerado quando uma propriedade foi alterada.

(Herdado de BindableObject)
PropertyChanging

Gerado quando uma propriedade está prestes a mudar.

(Herdado de BindableObject)
SizeChanged

Ocorre quando a propriedade Width ou Height muda o valor nesse elemento.

(Herdado de VisualElement)
Unfocused

Ocorre quando um elemento perde o foco.

(Herdado de VisualElement)

Implantações explícitas de interface

IDynamicResourceHandler.SetDynamicResource(BindableProperty, String)

Para uso interno pela plataforma do Xamarin.Forms.

(Herdado de BindableObject)
IElementController.SetValueFromRenderer(BindableProperty, Object)

Para uso interno pela plataforma do Xamarin.Forms.

(Herdado de Element)
IFontElement.FontSizeDefaultValueCreator()

Para uso interno pela plataforma do Xamarin.Forms.

IFontElement.OnFontAttributesChanged(FontAttributes, FontAttributes)

Para uso interno pela plataforma do Xamarin.Forms.

IFontElement.OnFontChanged(Font, Font)

Para uso interno pela plataforma do Xamarin.Forms.

IFontElement.OnFontFamilyChanged(String, String)

Para uso interno pela plataforma do Xamarin.Forms.

IFontElement.OnFontSizeChanged(Double, Double)

Para uso interno pela plataforma do Xamarin.Forms.

IGestureController.CompositeGestureRecognizers

Para uso interno pela plataforma do Xamarin.Forms.

(Herdado de View)
INameScope.RegisterName(String, Object)

Somente para uso interno.

(Herdado de Element)
IVisualElementController.EffectiveFlowDirection

Obtém a direção do fluxo de visual em vigor para o elemento na plataforma, levando em conta a localidade e as configurações de fluxo lógico.

(Herdado de VisualElement)
IVisualElementController.InvalidateMeasure(InvalidationTrigger)

Esse método é para uso interno.

(Herdado de VisualElement)

Métodos de Extensão

AbortAnimation(IAnimatable, String)

Interrompe a animação.

Animate(IAnimatable, String, Action<Double>, Double, Double, UInt32, UInt32, Easing, Action<Double,Boolean>, Func<Boolean>)

Define os parâmetros especificados e inicia a animação.

Animate(IAnimatable, String, Action<Double>, UInt32, UInt32, Easing, Action<Double,Boolean>, Func<Boolean>)

Define os parâmetros especificados e inicia a animação.

Animate(IAnimatable, String, Animation, UInt32, UInt32, Easing, Action<Double,Boolean>, Func<Boolean>)

Define os parâmetros especificados e inicia a animação.

Animate<T>(IAnimatable, String, Func<Double,T>, Action<T>, UInt32, UInt32, Easing, Action<T,Boolean>, Func<Boolean>)

Define os parâmetros especificados e inicia a animação.

AnimateKinetic(IAnimatable, String, Func<Double,Double,Boolean>, Double, Double, Action)

Define os parâmetros especificados e inicia a animação cinética.

AnimationIsRunning(IAnimatable, String)

Retorna um valor booliano que indica se a animação especificada pelo handle está ou não em execução.

Batch(IAnimatable)
GetPropertyIfSet<T>(BindableObject, BindableProperty, T)
SetAppThemeColor(BindableObject, BindableProperty, Color, Color)
SetBinding(BindableObject, BindableProperty, String, BindingMode, IValueConverter, String)

Cria e aplica uma associação a uma propriedade.

SetBinding<TSource>(BindableObject, BindableProperty, Expression<Func<TSource,Object>>, BindingMode, IValueConverter, String)
Obsoleto.

Cria e aplica uma associação de uma expressão.

SetOnAppTheme<T>(BindableObject, BindableProperty, T, T)
FindByName<T>(Element, String)

Retorna a instância do tipo T que tem o nome name no escopo que inclui element.

FindNextElement(ITabStopElement, Boolean, IDictionary<Int32,List<ITabStopElement>>, Int32)
GetSortedTabIndexesOnParentPage(VisualElement)
GetTabIndexesOnParentPage(ITabStopElement, Int32)
FadeTo(VisualElement, Double, UInt32, Easing)

Retorna uma tarefa que executa o esmaecimento descrito pelos parâmetros opacity, length e easing.

LayoutTo(VisualElement, Rectangle, UInt32, Easing)

Retorna uma tarefa que facilita os limites do VisualElement especificado por view para o retângulo especificado pelo parâmetro bounds.

RelRotateTo(VisualElement, Double, UInt32, Easing)

Gira o VisualElement especificado por view de sua rotação atual em drotation.

RelScaleTo(VisualElement, Double, UInt32, Easing)

Retorna uma tarefa que dimensiona o VisualElement especificado por view de sua escala atual para dscale.

RotateTo(VisualElement, Double, UInt32, Easing)

Retorna uma tarefa que executa a rotação descrita pelos parâmetros rotation, length e easing.

RotateXTo(VisualElement, Double, UInt32, Easing)

Retorna uma tarefa que distorce o eixo Y por opacity, obtendo length de tempo e usando easing.

RotateYTo(VisualElement, Double, UInt32, Easing)

Retorna uma tarefa que distorce o eixo X por opacity, obtendo length de tempo e usando easing.

ScaleTo(VisualElement, Double, UInt32, Easing)

Retorna uma tarefa que dimensiona o VisualElement especificado por view para o fator de escala absoluto scale.

ScaleXTo(VisualElement, Double, UInt32, Easing)
ScaleYTo(VisualElement, Double, UInt32, Easing)
TranslateTo(VisualElement, Double, Double, UInt32, Easing)

Anima as propriedades TranslationX e TranslationY de um elemento de seus valores atuais para os novos valores de elementos. Isso garante que o layout de entrada esteja na mesma posição que o layout visual.

HasVisualStateGroups(VisualElement)

Retornará true se element tiver um ou mais grupos de estado visual associados a ele. Caso contrário, retornará false.

Aplica-se a