このトピックは、 UltraDataChart コントロールでコンテンツをナビゲートする方法を提供します。
以下の表は、このトピックを理解するための前提条件として必要なトピックを示しています。
UltraDataChart コントロールはチャートでパンまたはズームのアクションが実行されるたびに更新される複数のナビゲーション プロパティを提供します。以下の表では、チャート コントロールでのビゲーション プロパティを示しています。
図 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 のみ利用可能です。このメソッドは、表示する軸の最大値および最小値を取得します。
このトピックの追加情報については、以下のトピックも合わせてご参照ください。