バージョン

針の構成 (XamLinearGauge)

トピックの概要

目的

このトピックではコード例を使用して、 XamLinearGauge コントロールの針を構成する方法を説明します。説明には、針が示す値、幅、位置、および書式設定が含まれます。

前提条件

本トピックの理解を深めるために、以下のトピックを参照することをお勧めします。

トピック 目的

このトピックでは、主要機能、最小要件、ユーザー機能など、 XamLinearGauge コントロールに関する概念的な情報を提供します。

このトピックでは、XamLinearGauge コントロールを Xamarin.Forms アプリケーションに追加する方法を説明します。

針を構成 – 概念的概要

針構成の概要

針を構成するには、針の図形、サイズ、スケールでの位置を指定します。境界線の幅、色、塗りつぶし色などの針のルック アンド フィールを構成し、ツールチップを提供することも可能です。針の図形を指定するには、 NeedleShape プロパティを定義済みの針図形タイプまたはカスタム針タイプに設定します。定義済みの針図形は:

  • 長方形

  • 台形

  • 三角形

デフォルトの針図形は、長方形の針本体と三角形のポイントを持つ針です。

XamLinearGauge Configuring the Needle 1.png

カスタムな針図形タイプを指定するには、NeedleShape プロパティを “Custom” に設定します。

定義済みの図形をカスタマイズできます。図形をカスタマイズしないで定義済みの針図形を使用する場合、基本針を使用しています。カスタム図形を選択するか、定義済みの図形を範囲タイプまたは幅プロパティによってカスタマイズする場合、カスタム針の構成になります。

スケールで、針は Value プロパティによって指定した値に配置されます。

スケール全域のディメンションでの針位置は、 NeedleInnerExtent および NeedleOuterExtent プロパティにより、グラフ領域の端に対して構成できます。針図形は NeedleShape プロパティによって構成されます。針で使用する複数の定義済みの図形があります。カスタムな図形もサポートされます。

XamLinearGauge Overview 10.png

針のルック アンド フィールは、各プロパティ ( NeedleBrushNeedleOutline および NeedleStrokeThickness) を使用して塗りつぶし色、境界線の色および境界線の線幅をカスタマイズできます。

針構成の概要表

以下の表で、XamLinearGauge コントロールの針で構成できる要素を簡単に説明し、それらを管理に使用するプロパティにマップします。

構成可能な点 詳細 プロパティ デフォルト値

図形タイプ

針図形を示す値

名前

針の名前 ( の表示用)

設定なし

表示する値

針で示された値

設定なし

スケール全域のサイズおよび位置

針の内部端の位置

デフォルトのテーマで定義済み

針の外部端の位置

デフォルトのテーマで定義済み

バーの塗りつぶし色

デフォルトのテーマで定義済み

針の境界線の幅

ピクセル単位

1.0

針の境界線の色

デフォルトのテーマで定義済み

プロパティ設定

以下の表では、任意の動作と各プロパティ設定のマップを示します。

構成の目的: 使用するプロパティ: 設定の選択肢:

図形タイプ

定義済みの図形または「Custom」

名前

針の名前を表す文字列

表示する値

スケールのメジャーにおける任意の値

スケール全域のサイズおよび位置

方向に応じた チャート領域の高さと幅の相対部分として定義した針の内部端の位置。小数で指定されます (例: 0.2)。

方向に応じた チャート領域の高さと幅の相対部分として定義した針の外部端の位置。小数で指定されます (例: 0.2)。

塗りつぶし色

任意の色

境界線の線幅

任意の値 (ピクセル)

境界線の色

任意の色

針図形の構成

針図形構成の概要

定義済みの図形またはカスタムな図形の針図形を構成できます。カスタムな図形の場合、新しい針図形を作成する必要があります。

針図形を構成するには、幅と範囲を制御するプロパティを設定します。このプロパティは、針図形の 3 つの基本部分を定義します。基本部分 (垂直方向に上から下) は:

  • Outer 部分 – 針のスケールから一番遠い部分。

  • Middle 部分 – Outer 部分および Inner 部分の間にある部分。幅に関連するプロパティは 2 つのセグメントと共有されます。

  • Inner 部分 – 針のスケールに一番近い部分。

以下の画像は、水平方向が使用される場合、針図形に関連するプロパティを表示します。プロパティの詳細については、プロパティ リファレンスを参照してください。

XamLinearGauge Configuring the Needle 2.png

プロパティ カテゴリ

針を構成するプロパティは、針の幅またはスケールからの範囲を構成するかどうかに基づいて 2 つのタイプがあります。

チャート領域の内部端に相対してスケール ディメンションで針の図形と位置を構成します。値は、スケール ディメンションでチャート領域の範囲の相対部分を表します。小数で指定されます (0.2 など)。0 はチャート領域の内部端で、1 は外部端です。

NeedleBreadth プロパティに設定される基本値の相対する部分として定義される設定を示します。相対する部分は小数で指定されます。たとえば、 NeedleBreadth20 に設定し、NeedleOuterBaseWidth0.5 に設定される場合、外部の基本セグメントの実際サイズは 10 ピクセル (20 x 0.5 = 10) になります。

プロパティ サブセット

カスタム図形を構成する ( NeedleShape プロパティが “Custom” の) 場合、すべてのプロパティが適用されます。定義済み図形タイプの場合、この図形の描画が 3 つの基本図形をすべて使用しないため、この幅と範囲のサブセットのみを適用します。

部分毎のプロパティ サブセット

以下のリストは、カスタム針の基本部分を構成するために必要なプロパティです。

針図形タイプのプロパティ サブセット

以下の表では、特定の針図形タイプをカスタマイズする場合に設定する図形構成プロパティを表示します。プロパティおよびその設定の詳細については、プロパティ リファレンスを参照してください。

針図形タイプ プロパティ

カスタム

  • NeedleBreadth

  • NeedleInnerExtent

  • NeedleInnerPointExtent

  • NeedleInnerPointWidth

  • NeedleOuterBaseWidth

  • NeedleOuterExtent

  • NeedleOuterPointWidth

長方形

  • NeedleBreadth

  • NeedleInnerBaseWidth

  • NeedleInnerExtent

  • NeedleOuterBaseWidth

  • NeedleOuterExtent

台形

  • NeedleBreadth

  • NeedleInnerBaseWidth

  • NeedleInnerExtent

  • NeedleOuterBaseWidth

  • NeedleOuterExtent

三角形

  • NeedleBreadth

  • NeedleInnerExtent

  • NeedleOuterBaseWidth

  • NeedleOuterExtent

プロパティ リファレンス

以下の表は、針図形を構成するプロパティを説明し、適用する図形タイプおよび部分にマップします。プロパティはアルファベット順に紹介します。

プロパティ 部分 詳細 適用する NeedleShape の設定

すべて

幅に関連するプロパティを定義するために使用される基本幅 (ピクセル単位)。有効な値は 0 より大きいの数値です。大きい値の場合、針は非常に大きくなります。

  • "Custom"

  • “Needle”

  • “Rectangle”

  • “Trapezoid

  • “Triangle”

Inner

針の内部端の Inner 基本セグメントの幅。

  • “Custom’

  • “Rectangle”

  • “Trapezoid”

Inner

方向に応じた チャート領域の高さと幅の相対部分として定義した内部基本セグメントの内部端の位置。小数で指定されます (例: 0.2)。

NeedleInnerPointExtent プロパティと Inner 部分のスケールの範囲および位置を指定します。

  • "Custom"

  • “Needle”

  • “Rectangle”

  • “Trapezoid”

  • “Triangle”

Inner/Middle

スケール全体での位置:

  • Inner 部分の外部端

  • Middle 部分の内部端

位置はチャート領域の幅の相対部分として定義されます。小数で指定 (例: 0.2)

NeedleInnerExtent プロパティと Inner 部分のスケールの範囲および位置を指定します。

NeedleOuterPointExtent プロパティと Middle 部分のスケールの範囲および位置を指定します。方向に応じたチャート領域の高さと幅の相対部分として定義した針 (ポイント) の内部ポイントの位置。小数で指定されます (例: 0.2)。

  • "Custom"

  • “Needle”

Inner/

Middle

以下の要素の幅:

  • 針の Inner 部分の外部端

  • Middle 部分の内部端

  • "Custom"

  • “Needle”

Outer

Outer 部分の外部端の幅。

  • "Custom"

  • “Needle”

  • “Rectangle”

  • “Trapezoid”

  • “Triangle”

Inner

方向に応じたチャート領域の高さと幅の相対部分として定義した外部基本セグメントの位置。小数で指定されます (例: 0.2)。

チャート領域の幅の相対部分として定義した Outer 部分の外部端の位置。小数で指定されます (例: 0.2)。NeedleOuterPointExtent プロパティと Inner 部分のスケールの範囲および位置を指定します。

  • "Custom"

  • “Needle”

  • “Rectangle”

  • “Trapezoid”

  • "Triangle"

Outer/Middle

スケール全体での位置:

  • Middle 部分の外部端

  • Outer 部分の内部端

位置はチャート領域の幅の相対部分として定義されます。小数で指定 (例: 0.2)

NeedleInnerPointExtent プロパティと Middle 部分のスケールの範囲および位置を指定します。

NeedleOuterExtent プロパティと Outer 部分のスケールの範囲および位置を指定します。方向に応じたチャート領域の高さと幅の相対部分として定義した Middle 部分の外部端の位置。小数で指定されます (例: 0.2)。

"Custom"

Outer/Middle

以下の要素の幅:

  • Middle 部分の外部端

  • Outer 部分の内部端

  • "Custom"

  • “Needle”

図形タイプに基づきます。

針の図形デフォルトの値は “Needle” です。長方形の針本体と三角形のポイントを定義します。有効な設定は以下のとおりです。

  • "Custom"

  • Needle ” (デフォルト値)

  • Rectangle”

  • “Trapezoid

  • Triangle”

NeedleShape プロパティに適用できません。

コード例の概要

コード例の概要表

以下の表は、このトピックで使用したコード例をまとめたものです。

説明

この例は、カスタム ルック アンド フィール (3 ピクセル幅の茶色の境界線、オレンジの塗りつぶし) でデフォルトの針を設定する方法を紹介します。

この例は、カスタムなチョウ図形の針を定義する方法を紹介します。

コード例: 基本針の構成

説明

この例は、カスタム ルック アンド フィール (3 ピクセル幅の茶色の境界線、オレンジの塗りつぶし) でデフォルトの針を設定する方法を紹介します。

以下のスクリーンショットは、下記設定の結果、XamLinearGauge の外観がどのようになるかを示しています。

プロパティ

"85"

Orange

Brown

"3"

XamLinearGauge Configuring the Needle 3 17 1.png

コード

以下のコードはこの例を実装します。

XAML の場合:

<ig:XamLinearGauge x:Name="linearGauge"
               Value="85"
               NeedleBrush="Orange"
               NeedleOutline="Brown"
               NeedleStrokeThickness="3"/>

C# の場合:

linearGauge.NeedleBrush = new SolidColorBrush(Color.FromRgb(255, 128, 0));
linearGauge.NeedleOutline = new SolidColorBrush(Color.FromRgb(102, 51, 0));
linearGauge.NeedleStrokeThickness = 3;
linearGauge.Value = 85;

コード例: カスタム針の構成

説明

以下のスクリーンショットは、以下の設定の結果、カスタムなチョウ形の針を定義したことを示しています。

XamLinearGauge Configuring the Needle 4 17 1.png

コード

以下のコードはこの例を実装します。

XAML の場合:

<ig:XamLinearGauge x:Name="linearGauge"
                     NeedleShape="Custom"
                     Value="50"
                     NeedleInnerExtent=".4"
                     NeedleOuterExtent=".6"
                     NeedleInnerPointExtent="0.1"
                     NeedleOuterPointExtent=".9"
                     NeedleInnerBaseWidth="0"
                     NeedleOuterBaseWidth=".1"
                     NeedleInnerPointWidth=".3"
                     NeedleOuterPointWidth=".35"/>

C# の場合:

linearGauge.NeedleShape = LinearGraphNeedleShape.Custom;
linearGauge.Value = 50;
linearGauge.NeedleInnerExtent = .4;
linearGauge.NeedleOuterExtent = .6;
linearGauge.NeedleInnerPointExtent = .1;
linearGauge.NeedleOuterPointExtent = .9;
linearGauge.NeedleInnerBaseWidth = 0;
linearGauge.NeedleOuterBaseWidth = .1;
linearGauge.NeedleInnerPointWidth = .3;
linearGauge.NeedleOuterPointWidth = .35;

関連コンテンツ

このトピックの追加情報については、以下のトピックも合わせてご参照ください。

トピック 目的

このトピックではコード例を使用して、 XamLinearGauge コントロールのスケールを構成する方法を説明します。説明には、コントロール内のスケールの配置、スケールの目盛およびラベルの構成が含まれます。

このトピックではコード例を使用して、 XamLinearGauge コントロールの範囲を構成する方法を説明します。説明には、範囲の数、位置、長さ、幅、および書式設定が含まれます。

このトピックではコード例を使用して、リニア ゲージの背景を構成する方法を説明します。説明には、背景のサイズ、位置、色、および境界線の設定が含まれます。