ツールチップの作業

ツールチップは、ダッシュボード表示形式でエンドユーザーがシリーズをホバーまたはクリックしたときに表示されるメッセージです。

ダッシュボード表示形式にツールチップが表示されている場合、RevealView.TooltipShowing イベントが呼び出されます。このイベントを処理すると、ツールチップ データの読み取りやツールチップの表示防止が可能になります。

<rv:RevealView x:Name="_revealView"
               TooltipShowing="RevealView_TooltipShowing"/>

private void RevealView_TooltipShowing(object sender, TooltipShowingEventArgs e)
{

}

TooltipShowingEventArgs クラスには次のプロパティがあります:

• Cell - ツールチップに関連付けられたデータ ポイントを取得します。
• Row - ツールチップで提供されるセルデータのコレクションを取得します。
• Visualization - ツールチップを表示する表示形式を取得します。

備考

RevealView.TooltipShowing イベントは、グリッドやゲージなどのツールチップをサポートしない表示形式ではトリガーされません。

ツールチップ データの読み取り

TooltipShowingEventArgs.Cell および TooltipShowingEventArgs.Row プロパティなど、TooltipShowingEventArgs クラスによって公開されるプロパティを使用することによって、ツールチップの表示に使用されるデータを読み取ることができます。

TooltipShowingEventArgs.Row プロパティは、ツールチップの各データ ポイントを表す RVDataCell オブジェクトのコレクションを提供することを理解することが重要です。

RVDataCell クラスには次のプロパティがあります:

• ColumnLabel - データ ポイントに属する列のラベルまたはカスタム名称
• ColumnName - データ ポイントに属する列の名前
• FormattedValue - データ ポイントの書式設定された値
• Value - データ ポイントの元の値

以下の画像は、RVCell のプロパティがツールチップに表示されるデータにマップする方法を示しています。

ツールチップを表示しないようにする

すべての表示形式または特定の表示形式でツールチップが表示されないようにするには、TooltipShowingEventArgs.Cancel プロパティを true に設定します。

この例では、RVVisualization.Title プロパティが Sales であるかどうかを確認し、TooltipShowingEventArgs.Cancel プロパティを true に設定してツールチップを表示しないようにします。

private void RevealView_TooltipShowing(object sender, TooltipShowingEventArgs e)
{
    if (e.Visualization.Title == "Sales")
    {
        e.Cancel = true;
    }
}

コードの取得

このサンプルのソース コードは GitHub にあります。