Linha

Navegue pelo exemplo

A classe .NET Multi-platform App UI (.NET MAUI) Line 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 Formas.

Line define as propriedades a seguir:

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

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

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

Criar uma linha

Para desenhar uma linha, crie um Line objeto e defina suas X1 propriedades e para seu ponto inicial e Y1 suas X2 propriedades e Y2 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 Pincéis.

Observação

Definir a Fill propriedade de um 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):

Como as X1propriedades , , e Y2 têm valores padrão de 0, Y1X2é 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 escuro é desenhada de (40,0) a (0,120):

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