バージョン

コードを使用してチャートをナビゲート

トピックの概要

目的

このトピックは、 UltraDataChart コントロールでコンテンツをナビゲートする方法を提供します。

前提条件

以下の表は、このトピックを理解するための前提条件として必要なトピックを示しています。

トピック 目的

このトピックでは、 UltraDataChart コントロールの主な機能の概要を提供します。

このトピックでは、 UltraDataChart コントロールでナビゲーションを使用する上での情報を提供します。

このトピックの内容

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

UltraDataChart コントロールはチャートでパンまたはズームのアクションが実行されるたびに更新される複数のナビゲーション プロパティを提供します。以下の表では、チャート コントロールでのビゲーション プロパティを示しています。

プロパティ タイプ 説明 デフォルト値

double

UltraDataChart コントロールによって表示されるコンテンツ表示長方形の X 部分。

NaN

X 軸の左側に配置されたチャート コンテンツを表示します。

double

UltraDataChart コントロールによって表示されるコンテンツ表示長方形の Y 部分。

NaN

Y 軸の上に配置されたチャート コンテンツを表示します。

Rect

UltraDataChart の現在表示されている部分

0, 0, 1, 1

チャート コンテンツ全体を表示します。

double

UltraDataChart コントロールによって表示されるコンテンツ表示長方形の幅部分。

NaN

X 軸に沿って配置されたチャート コンテンツを表示します。

double

UltraDataChart コントロールによって表示されるコンテンツ表示長方形の高さ部分。

NaN

Y 軸に沿ってチャート コンテンツを表示します。

xamDataChart RT Chart Navigation 01.png

図 1: ナビゲーション プロパティの値が可視に設定されている UltraDataChart コントロール

コード例

UltraDataChart コントロールのナビゲーションは、表 2 に示されたプロパティ値を変更することで、コード ビハインドから管理できます。以下のコードは、コード ビハインドからチャートのズームおよびパンを行う方法を示します。

Visual Basic の場合:

'  0.05 の係数でズーム イン
Me.DataChart.WindowScaleHorizontal -= 0.05
Me.DataChart.WindowScaleVertical -= 0.05
' 0.05 の係数でズーム アウト
Me.DataChart.WindowScaleHorizontal += 0.05
Me.DataChart.WindowScaleVertical += 0.05
' 0.05 の係数でパンアップ(北方向)します
Me.DataChart.WindowPositionVertical -= 0.05
' 0.05 の係数でパンダウン(南方向)します
Me.DataChart.WindowPositionVertical += 0.05
' 0.05 の係数でパンレフト(西方向)します
Me.DataChart.WindowPositionHorizontal -= 0.05
' 0.05 の係数でパンライト(東方向)します
Me.DataChart.WindowPositionHorizontal += 0.05

C# の場合:

// 0.05 の係数でズーム イン
this.DataChart.WindowScaleHorizontal -= 0.05;
this.DataChart.WindowScaleVertical -= 0.05;
// 0.05 の係数でズーム アウト
this.DataChart.WindowScaleHorizontal += 0.05;
this.DataChart.WindowScaleVertical += 0.05;
// 0.05 の係数でパンアップ(北方向)します
this.DataChart.WindowPositionVertical -= 0.05;
// 0.05 の係数でパンダウン(南方向)します
this.DataChart.WindowPositionVertical += 0.05;
// 0.05 の係数でパンレフト(西方向)します
this.DataChart.WindowPositionHorizontal -= 0.05;
// 0.05 の係数でパンライト(東方向)します
this.DataChart.WindowPositionHorizontal += 0.05;

カテゴリ軸および数値軸に 2 つのメソッドがあり、コードによって指定した項目または範囲へ移動するために呼び出すことができます。このメソッドは ScrollIntoView および ScrollRangeIntoView と呼ばれます。指定した項目または範囲を中央に表示するためにチャートの WindowRect を自動的に更新します。

CategoryXAxis および CategoryYAxis の場合、ScrollIntoView は表示するカテゴリのデータ項目を取得します。ScrollRangeIntoView は、表示する最小および最大のカテゴリ インデックスを取得します。インデックスは、ItemsSource 内の項目と関連します。

CategoryDateTimeXAxis の場合、ScrollIntoView メソッドのみが利用可能ですが、表示する日付の最大および最小の範囲を使用できます。

NumericXAxis および NumericYAxis の場合、ScrollRangeIntoView のみ利用可能です。このメソッドは、表示する軸の最大値および最小値を取得します。

関連コンテンツ

トピック

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

トピック 目的

このトピックは情報を提供します