Main Content

dataTipInteraction

データ ヒントの操作

説明

データ ヒントの操作を使うと、座標軸ツール バーのボタンを選択せずに、チャート内にデータ ヒントを表示できます。データ ヒントを有効にするには、座標軸の Interactions プロパティを dataTipInteraction オブジェクトに設定します。この操作を有効にした場合、チャート内にカーソルを移動するか、チャート内でクリックまたはタップを行うとデータ ヒントが表示されます。

複数の操作を有効にするには、Interactions プロパティをオブジェクトの配列に設定します。

作成

説明

d = dataTipInteraction は、データ ヒント操作オブジェクトを作成します。この操作を有効にした状態でクリックまたはタップすると、最も近いデータ点にデータ ヒントが表示されます。

d = dataTipInteraction('SnapToDataVertex',snap) は、データ ヒントが最も近いデータ点にスナップするかどうかを指定します。snap'off' のときにクリックまたはタップすると、代わりにカーソルの正確な位置にデータ ヒントが表示されます。

プロパティ

すべて展開する

最も近いデータ点での表示。次のいずれかの値として指定します。

  • 'on' — 最も近いデータ点にデータ ヒントを表示します。最も近いデータ点は、チャートのタイプによって異なります。たとえば、線グラフでは、最も近いデータ点は指定された位置からのユークリッド距離が最も小さいものです。

  • 'off' — カーソルの位置にデータ ヒントを表示します。

すべて折りたたむ

表面プロットを作成します。現在の座標軸を取得し、既定の操作をデータ ヒントとパンの操作に置き換えます。次に、表面にカーソルを合わせてデータ ヒントを表示します。クリックしてドラッグまたはタップしてドラッグすることで移動します。

surf(peaks)
ax = gca;
ax.Interactions = [dataTipInteraction panInteraction];

ヒント

  • データ ヒントの内容をカスタマイズするには、chart オブジェクトの DataTipTemplate プロパティを設定します。詳細については、カスタム データ ヒントの作成を参照してください。

  • ほとんどの場合、座標軸には表示しているチャートのタイプに応じた既定の操作セットがあります。既定のセットを新しい操作セットに置き換えることはできますが、既定のセットの操作にアクセスしたり、変更したりすることはできません。

バージョン履歴

R2019a で導入