ライン

サンプルを参照する

.NET マルチプラットフォーム アプリ UI (.NET MAUI) Line クラスは Shape クラスから派生し、線を描画するために使用できます。 Line クラスが Shape クラスから継承するプロパティについては、「図形」 を参照してください。

Line は次の特性を定義します。

• Double 型の X1 は、線の始点の x 座標を示します。 このプロパティの既定値は 0.0 です。
• Double 型の Y1 は、線の始点の y 座標を示します。 このプロパティの既定値は 0.0 です。
• Double 型の X2 は、線の終点の x 座標を示します。 このプロパティの既定値は 0.0 です。
• Double 型の Y2 は、線の終点の y 座標を示します。 このプロパティの既定値は 0.0 です。

これらのプロパティは、BindableProperty オブジェクトが基になっています。つまり、これらは、データ バインディングの対象にすることができ、スタイルを設定できます。

線端の描画方法の制御については、「線の終端を制御する」を参照してください。

行の作成

線を描画するには、Line オブジェクトを作成し、X1 プロパティと Y1 プロパティをその始点に設定し、X2 プロパティと Y2 プロパティをその終点に設定します。 さらに、輪郭のない線は表示されないため、Stroke プロパティを Brush 派生オブジェクトに設定します。 Brush オブジェクトの詳細については、「ブラシ」を参照してください。

Note

線には内部がないため、Line の Fill プロパティを設定しても効果はありません。

次の XAML 例は、線を描画する方法を示しています。

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

この例では、赤い対角線が (40,0) から (0,120) まで描画されます。

X1、Y1、X2、Y2 のプロパティの既定値は 0 であるため、最小限の構文でいくつかの行を描画できます。

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

この例では、デバイスに依存しない長さ 200 単位の水平線が定義されています。 他のプロパティは既定では 0 であるため、線は (0,0) から (200,0) まで描画されます。

次の XAML の例は、破線を描画する方法を示しています。

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

この例では、(40,0) から (0,120) までの濃い青色の破線が描画されます。

破線の描画の詳細については、「破線の図形を描画する」を参照してください。