軸タイトルの構成

トピックの概要

目的

このトピックでは、 XamDataChart™ コントロールでの軸タイトルの設定に関する情報を提供します。

前提条件

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

トピック	目的
データチャートを使用した作業の開始	XamDataChart は、コントロールの DataContext プロパティにマップされるデータオブジェクトモデルを必要とします。ここでは、簡単なデータオブジェクトモデルを提供しますが、自分自身で作成し、このサンプルコードの代わりに使用することができます。
軸ラベル設定の構成	このトピックでは、軸ラベルの外観プロパティの設定に関する情報を提供します。

このトピックの内容

このトピックは、以下のセクションで構成されます。

軸タイトル
関連コンテンツ

軸タイトル

概要

XamDataChart コントロールの軸タイトル機能は、XamDataChart コントロールの x および y 軸にコンテキスト情報を追加できます。

軸タイトルは、角度、フォントサイズおよび位置といった TitleSettings オブジェクトのプロパティを指定することでカスタマイズできます。

プレビュー

以下のスクリーンショットは、タイトルを y 軸に設定した XamDataChart コントロールのプレビューです。

プロパティ

Title プロパティは、軸の情報領域の値を設定します。

プロパティ名	プロパティタイプ	説明
タイトル	`文字列`	軸のタイトルを定義します。

以下の表で、軸の TitleSettings プロパティが利用できる TitleSettings オブジェクトのプロパティを簡単に説明します。

プロパティ名	プロパティタイプ	説明
TitleSettings	`TitleSettings`	軸タイトルの前景、フォント、配置、マージン、方角など外観設定を定義します。
TitleSettings.Position	`AxisTitlePosition`	ラベルの位置に応じて、タイトルの位置を定義します。このプロパティはデフォルトで Auto に設定されています。これは、軸タイトルが常に軸ストロークおよび軸ラベルの反対側になることを意味します。つまり、軸ラベルは位置を変更しても、常に軸タイトルと軸ストロークの間になります。たとえば、軸ラベルの位置を OutsideRight に変更すると、軸タイトルの位置は自動的に軸ラベルの右側になります。
TitleSettings.Angle	`double`	軸タイトルを中心としたタイトルの回転を度数で定義します。たとえば、90 の値はタイトルを垂直に回転させ、0 の値はタイトルを水平に描画します。
TitleSettings.Effect	`Effect`	軸タイトルに適用する効果を定義します。
TitleSettings.Foreground	`Brush`	軸タイトルの前景に適用する色を定義します。
TitleSettings.FontFamily	`FontFamily`	軸タイトルのテキストに適用するフォントを定義します。
TitleSettings.FontSize	`double`	軸タイトルのテキストに使用するフォントサイズを定義します。
TitleSettings.FontStretch	`FontStretch`	正体、長体、または平体などの書体を定義します。
TitleSettings.FontStyle	`FontStyle`	Regular、Bold、Italic など、軸タイトルテキストの描画に使用されるフォント属性を定義します。
TitleSettings.FontWeight	`FontWeight`	太字や正体など、軸タイトルのテキストに使用する文字の太さを定義します。
TitleSettings.HorizontalAlignment	`HorizontalAlignment`	軸情報パネル上の軸タイトルの水平方向の配列を定義します。このプロパティは x 軸のタイトルのみに適用されます。
TitleSettings.VerticalAlignment	`VerticalAlignment`	軸情報パネル上の軸タイトルの垂直方向の配列を定義します。このプロパティは y 軸のタイトルのみに適用されます。
TitleSettings.Opacity	`double`	軸タイトルの不透明度を定義します。
TitleSettings.OpacityMask	`Brush`	軸タイトルの不透明度マスクを定義します。
TitleSettings.Margin	`Thickness`	軸タイトル周囲に設定する余白のサイズを定義します。

例

表の下のスクリーンショットは、以下の設定の結果、軸 Title を設定した XamDataChart コントロールの外観がどのようになるか示しています。

プロパティ	値
タイトル	Terawatt Hours (TWh)
TitleSettings.Position	Bottom
TitleSettings.Angle	270
TitleSettings.FontSize	15

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

XAML の場合:

<ig:NumericYAxis x:Name="yAxis" Title="Terawatt Hours (TWh)">
      <ig:NumericYAxis.TitleSettings >
         <ig:TitleSettings  FontSize="15" Angle="270" Position="Bottom" />
      </ig:NumericYAxis.TitleSettings>
</ig:NumericYAxis>

C# の場合:

var yAxis = new NumericYAxis();
yAxis.Title = "Terawatt Hours (TWh)";
yAxis.TitleSettings = new AxisTitleSettings();
yAxis.TitleSettings.Position = AxisTitlePosition.Bottom;
yAxis.TitleSettings.Angle = 270;
yAxis.TitleSettings.FontSize = 15;

Visual Basic の場合:

Dim yAxis As New NumericYAxis()
yAxis.Title = "Terawatt Hours (TWh)"
yAxis.TitleSettings = new AxisTitleSettings()
yAxis.TitleSettings.Position = AxisTitlePosition.Bottom
yAxis.TitleSettings.Angle = 270
yAxis.TitleSettings.FontSize = 15

WPF | ヘルプ トピック