Linha poligonal

Navegue pelo exemplo

A classe .NET Multi-platform App UI (.NET MAUI) Polyline deriva da classe e pode ser usada para desenhar uma série de linhas retas Shape conectadas. Uma polilinha é semelhante a um polígono, exceto que o último ponto em uma polilinha não está conectado ao primeiro ponto. Para obter informações sobre as propriedades que a Polyline classe herda da Shape classe, consulte Formas.

Polyline define as propriedades a seguir:

• Points, do tipo PointCollection, que é uma coleção de estruturas que descrevem os pontos de Point vértice da polilinha.
• FillRule, do tipo FillRule, que especifica como as áreas de intersecção na polilinha são combinadas. O valor padrão dessa propriedade é FillRule.EvenOdd.

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

O PointsCollection tipo é um ObservableCollection dos Point objetos. A Point estrutura define X e propriedades, do tipo double, que representam um par de coordenadas x e Y y no espaço 2D. Portanto, a Points propriedade deve ser definida como uma lista de pares de coordenadas x e coordenadas y que descrevem os pontos de vértice polilineares, delimitados por uma única vírgula e/ou um ou mais espaços. Por exemplo, "40,10 70,80" e "40 10, 70 80" são ambos válidos.

Para obter mais informações sobre a FillRule enumeração, consulte Regras de preenchimento.

Criar uma Polyline

Para desenhar uma polilinha, crie um Polyline objeto e defina sua Points propriedade como os vértices de uma forma. Para dar à polilinha um contorno, defina sua Stroke propriedade como um Brushobjeto derivado. A StrokeThickness propriedade especifica a espessura do contorno de polilinha. Para obter mais informações sobre Brush objetos, consulte Pincéis.

Importante

Se você definir a propriedade de a Fill Polyline para um Brushobjeto derivado, o espaço interno da polilinha será pintado, mesmo que o ponto inicial e o ponto final não se cruzem.

O exemplo XAML a seguir mostra como desenhar uma polilinha:

<Polyline Points="0,0 10,30 15,0 18,60 23,30 35,30 40,0 43,60 48,30 100,30"
          Stroke="Red" />

Neste exemplo, uma polilinha vermelha é desenhada:

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

<Polyline Points="0,0 10,30 15,0 18,60 23,30 35,30 40,0 43,60 48,30 100,30"
          Stroke="Red"
          StrokeThickness="2"
          StrokeDashArray="1,1"
          StrokeDashOffset="6" />

Neste exemplo, a polilinha é tracejada:

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

O exemplo XAML a seguir mostra uma polilinha que usa a regra de preenchimento padrão:

<Polyline Points="0 48, 0 144, 96 150, 100 0, 192 0, 192 96, 50 96, 48 192, 150 200 144 48"
          Fill="Blue"
          Stroke="Red"
          StrokeThickness="3" />

Neste exemplo, o comportamento de preenchimento da polilinha é determinado usando a EvenOdd regra de preenchimento.

O exemplo XAML a seguir mostra uma polilinha que usa a Nonzero regra de preenchimento:

<Polyline Points="0 48, 0 144, 96 150, 100 0, 192 0, 192 96, 50 96, 48 192, 150 200 144 48"
          Fill="Black"
          FillRule="Nonzero"
          Stroke="Yellow"
          StrokeThickness="3" />

Neste exemplo, o comportamento de preenchimento da polilinha é determinado usando a Nonzero regra de preenchimento.