Passando argumentos em XAML

  • Artigo

Baixar exemplo Baixar o exemplo

Este artigo demonstra como usar os atributos XAML que podem ser usados para passar argumentos para construtores não padrão, chamar métodos de fábrica e especificar o tipo de um argumento genérico.

Visão geral

Geralmente, é necessário instanciar objetos com construtores que exigem argumentos ou chamando um método de criação estático. Isso pode ser obtido em XAML usando os x:Arguments atributos e x:FactoryMethod :

  • O x:Arguments atributo é usado para especificar argumentos de construtor para um construtor não padrão ou para uma declaração de objeto de método de fábrica. Para obter mais informações, consulte Passando argumentos de construtor.
  • O x:FactoryMethod atributo é usado para especificar um método de fábrica que pode ser usado para inicializar um objeto . Para obter mais informações, consulte Chamando métodos de fábrica.

Além disso, o x:TypeArguments atributo pode ser usado para especificar os argumentos de tipo genérico para o construtor de um tipo genérico. Para obter mais informações, consulte Especificando um argumento de tipo genérico.

Passando argumentos de construtor

Os argumentos podem ser passados para um construtor não padrão usando o x:Arguments atributo . Cada argumento de construtor deve ser delimitado dentro de um elemento XML que representa o tipo do argumento. Xamarin.Forms dá suporte aos seguintes elementos para tipos básicos:

  • x:Array
  • x:Boolean
  • x:Byte
  • x:Char
  • x:DateTime
  • x:Decimal
  • x:Double
  • x:Int16
  • x:Int32
  • x:Int64
  • x:Object
  • x:Single
  • x:String
  • x:TimeSpan

O exemplo de código a seguir demonstra como usar o x:Arguments atributo com três Color construtores:

<BoxView HeightRequest="150" WidthRequest="150" HorizontalOptions="Center">
  <BoxView.Color>
    <Color>
      <x:Arguments>
        <x:Double>0.9</x:Double>
      </x:Arguments>
    </Color>
  </BoxView.Color>
</BoxView>
<BoxView HeightRequest="150" WidthRequest="150" HorizontalOptions="Center">
  <BoxView.Color>
    <Color>
      <x:Arguments>
        <x:Double>0.25</x:Double>
        <x:Double>0.5</x:Double>
        <x:Double>0.75</x:Double>
      </x:Arguments>
    </Color>
  </BoxView.Color>
</BoxView>
<BoxView HeightRequest="150" WidthRequest="150" HorizontalOptions="Center">
  <BoxView.Color>
    <Color>
      <x:Arguments>
        <x:Double>0.8</x:Double>
        <x:Double>0.5</x:Double>
        <x:Double>0.2</x:Double>
        <x:Double>0.5</x:Double>
      </x:Arguments>
    </Color>
  </BoxView.Color>
</BoxView>

O número de elementos dentro da x:Arguments marca e os tipos desses elementos devem corresponder a um dos Color construtores. O Colorconstrutor com um único parâmetro requer um valor de escala de cinza de 0 (preto) a 1 (branco). O Colorconstrutor com três parâmetros requer um valor vermelho, verde e azul variando de 0 a 1. O Colorconstrutor com quatro parâmetros adiciona um canal alfa como o quarto parâmetro.

As capturas de tela a seguir mostram o resultado da chamada de cada Color construtor com os valores de argumento especificados:

BoxView.Color especificado com x:Arguments

Chamando métodos de fábrica

Os métodos de fábrica podem ser chamados em XAML especificando o nome do método usando o x:FactoryMethod atributo e seus argumentos usando o x:Arguments atributo . Um método de fábrica é um public static método que retorna objetos ou valores do mesmo tipo que a classe ou estrutura que define os métodos.

A Color estrutura define vários métodos de fábrica e o exemplo de código a seguir demonstra a chamada de três deles:

<BoxView HeightRequest="150" WidthRequest="150" HorizontalOptions="Center">
  <BoxView.Color>
    <Color x:FactoryMethod="FromRgba">
      <x:Arguments>
        <x:Int32>192</x:Int32>
        <x:Int32>75</x:Int32>
        <x:Int32>150</x:Int32>                        
        <x:Int32>128</x:Int32>
      </x:Arguments>
    </Color>
  </BoxView.Color>
</BoxView>
<BoxView HeightRequest="150" WidthRequest="150" HorizontalOptions="Center">
  <BoxView.Color>
    <Color x:FactoryMethod="FromHsla">
      <x:Arguments>
        <x:Double>0.23</x:Double>
        <x:Double>0.42</x:Double>
        <x:Double>0.69</x:Double>
        <x:Double>0.7</x:Double>
      </x:Arguments>
    </Color>
  </BoxView.Color>
</BoxView>
<BoxView HeightRequest="150" WidthRequest="150" HorizontalOptions="Center">
  <BoxView.Color>
    <Color x:FactoryMethod="FromHex">
      <x:Arguments>
        <x:String>#FF048B9A</x:String>
      </x:Arguments>
    </Color>
  </BoxView.Color>
</BoxView>

O número de elementos dentro da x:Arguments marca e os tipos desses elementos devem corresponder aos argumentos do método de fábrica que está sendo chamado. O FromRgba método de fábrica requer quatro Int32 parâmetros, que representam os valores vermelho, verde, azul e alfa, variando de 0 a 255, respectivamente. O FromHsla método de fábrica requer quatro Double parâmetros, que representam os valores matiz, saturação, luminosidade e alfa, variando de 0 a 1, respectivamente. O FromHex método de fábrica requer um String que representa a cor hexadecimal (A)RGB.

As capturas de tela a seguir mostram o resultado da chamada de cada Color método de fábrica com os valores de argumento especificados:

BoxView.Color especificado com x:FactoryMethod e x:Arguments

Especificando um argumento de tipo genérico

Argumentos de tipo genérico para o construtor de um tipo genérico podem ser especificados usando o x:TypeArguments atributo , conforme demonstrado no exemplo de código a seguir:

<ContentPage ...>
  <StackLayout>
    <StackLayout.Margin>
      <OnPlatform x:TypeArguments="Thickness">
        <On Platform="iOS" Value="0,20,0,0" />
        <On Platform="Android" Value="5, 10" />
        <On Platform="UWP" Value="10" />
      </OnPlatform>
    </StackLayout.Margin>
  </StackLayout>
</ContentPage>

A OnPlatform classe é uma classe genérica e deve ser instanciada com um x:TypeArguments atributo que corresponda ao tipo de destino. On Na classe , o Platform atributo pode aceitar um único string valor ou vários valores delimitados por vírgulasstring. Neste exemplo, a StackLayout.Margin propriedade é definida como uma específica Thicknessda plataforma.

Para obter mais informações sobre argumentos de tipo genérico, consulte Genéricos em Xamarin.Forms XAML.