Xamarin.Forms 図形: ポリライン
Polyline クラスは、Shape クラスから派生し、一連の接続された直線を描画するために使用できます。 ポリラインは多角形に似ていますが、ポリライン内の最後の点が最初の点につながっていません。 Polyline クラスが Shape クラスから継承するプロパティについては、「Xamarin.Forms 図形」を参照してください。
Polyline には、次のプロパティが定義されています。
PointsはPointCollection型で、ポリラインの頂点を記述するPoint構造体の集まりです。FillRuleはFillRule型で、ポリライン内の交差する領域の結合方法を指定します。 このプロパティの既定値はFillRule.EvenOddです。
これらのプロパティは、BindableProperty オブジェクトが基になっています。つまり、これらは、データ バインディングの対象にすることができ、スタイルを設定できます。
PointsCollection 型は Point オブジェクトの ObservableCollection です。 Point 構造体は、2D 空間内の x 座標と y 座標のペアを表す double 型の X と Y プロパティを定義します。 したがって、Points プロパティは、単一のコンマまたは 1 つ以上のスペースで区切られた、ポリラインの頂点を記述する x 座標と y 座標のペアのリストに設定する必要があります。 たとえば、"40,10 70,80" と "40 10, 70 80" はどちらも有効です。
FillRule 列挙体の詳細については、「Xamarin.Forms 図形: 塗りつぶしルール」を参照してください。
ポリラインを作成する
ポリラインを描画するには、Polyline オブジェクトを作成し、その Points プロパティを図形の頂点に設定します。 ポリラインにアウトラインを設定するには、その Stroke プロパティを Brush 派生オブジェクトに設定します。 StrokeThickness プロパティは、ポリラインのアウトラインの太さを指定します。 Brush の詳細については、「Xamarin.Forms ブラシ」を参照してください。
重要
Polyline の Fill プロパティを Brush 派生オブジェクトに設定すると、始点と終点が交差しない場合でも、ポリラインの内部空間が塗りつぶされます。
次の XAML の例は、ポリラインを描画する方法を示しています。
<Polyline Points="0,0 10,30, 15,0 18,60 23,30 35,30 40,0 43,60 48,30 100,30"
Stroke="Red" />
この例では、赤いポリラインが描画されます。
次の XAML の例は、破線のポリラインを描画する方法を示しています。
<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" />
この例では、ポリラインは破線です。
破線ポリラインの描画の詳細については、「破線の図形を描画する」をご覧ください。
次の XAML の例は、既定の塗りつぶしルールを使用するポリラインを示しています。
<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" />
この例では、ポリラインの塗りつぶし動作は EvenOdd 塗りつぶしルールを使用して決定されます。
次の XAML の例は、Nonzero 塗りつぶしルールを使用するポリラインを示しています。
<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" />
この例では、ポリラインの塗りつぶし動作は Nonzero 塗りつぶしルールを使用して決定されます。