Partilhar via


Xamarin.Forms Formas: Linha

A Line classe deriva da Shape classe e pode ser usada para desenhar linhas. Para obter informações sobre as propriedades que a Line classe herda da Shape classe, consulte Xamarin.Forms Formas.

Line define as propriedades a seguir:

  • X1, do tipo double, indica a coordenada x do ponto inicial da linha. O valor padrão desta propriedade é 0.0.
  • Y1, do tipo double, indica a coordenada y do ponto inicial da linha. O valor padrão desta propriedade é 0.0.
  • X2, do tipo double, indica a coordenada x do ponto final da linha. O valor padrão desta propriedade é 0.0.
  • Y2, do tipo double, indica a coordenada y do ponto final da linha. O valor padrão desta propriedade é 0.0.

Essas propriedades são apoiadas por objetos BindableProperty, o que significa que podem ser alvos de associações de dados e ser estilizada.

Para obter informações sobre como controlar como as extremidades da linha são desenhadas, consulte Controlar as extremidades da linha.

Criar uma linha

Para desenhar uma linha, crie um Line objeto e defina suas X1 propriedades e Y1 para seu ponto inicial e suas X2 Y propriedades para seu ponto final. Além disso, defina sua Stroke propriedade como um Brushobjeto derivado porque uma linha sem traçado é invisível. Para obter mais informações sobre Brush objetos, consulte Xamarin.Forms Pincéis.

Observação

Definir a Fill propriedade de a Line não tem efeito, porque uma linha não tem interior.

O exemplo XAML a seguir mostra como desenhar uma linha:

<Line X1="40"
      Y1="0"
      X2="0"
      Y2="120"
      Stroke="Red" />

Neste exemplo, uma linha diagonal vermelha é desenhada de (40,0) a (0,120):

Linha diagonal

Como as X1propriedades , Y1, X2e Y2 e têm valores padrão de 0, é possível desenhar algumas linhas com sintaxe mínima:

<Line Stroke="Red"
      X2="200" />

Neste exemplo, uma linha horizontal com 200 unidades independentes de dispositivo é definida. Como as outras propriedades são 0 por padrão, uma linha é desenhada de (0,0) a (200,0).

O exemplo XAML a seguir mostra como desenhar uma linha tracejada:

<Line X1="40"
      Y1="0"
      X2="0"
      Y2="120"
      Stroke="DarkBlue"
      StrokeDashArray="1,1"
      StrokeDashOffset="6" />

Neste exemplo, uma linha diagonal tracejada azul escura é desenhada de (40,0) a (0,120):

Linha tracejada

Para obter mais informações sobre como desenhar uma linha tracejada, consulte Desenhar formas tracejadas.