マウスクリックのキャプチャ

マウスクリックへの応答をコントロールするプロパティ

オブジェクトがマウスクリックに応答するか、またその応答方法を決定する 2 つのプロパティがあります。

PickableParts — オブジェクトがマウスクリックをキャプチャするかどうかを設定する。
HitTest — オブジェクトがキャプチャしたマウスクリックに応答できるかどうかを決定する、またはマウスクリックを最も近い先祖に渡す。

オブジェクトは、応答可能な別のオブジェクトに到達するまで、マウスクリックをオブジェクト階層内で最も近い先祖に渡していきます。

マウスクリックへの応答のプログラミング

オブジェクトはマウスクリックをキャプチャして応答すると、以下の動作を行います。

マウスの左クリックへの応答としてボタンダウン関数を実行する。オブジェクトで ButtonDownFcn プロパティのコールバックを定義している場合、MATLAB^® はそのコールバックを実行します。
マウスの右クリックへの応答としてコンテキストメニューを表示する。オブジェクトで ContextMenu プロパティを使用してコンテキストメニューを定義している場合、MATLAB はこのコンテキストメニューを呼び出します。

メモ

Figure には PickableParts プロパティはありません。Figure はその HitTest プロパティの設定に関係なく、ボタンコールバック関数を実行します。

メモ

座標軸の PickableParts プロパティが 'none' に設定されていると、座標軸の子オブジェクトはマウスクリックをキャプチャできません。その場合、すべてのマウスクリックは Figure によってキャプチャされます。

PickablePart 値と HitTest 値の組み合わせ

PickableParts プロパティと HitTest プロパティを使用して、以下の動作を実装できます。

クリックされたオブジェクトはマウスクリックをキャプチャし、ボタンダウンコールバックまたはコンテキストメニューで応答します。
クリックされたオブジェクトはマウスクリックをキャプチャし、ボタンダウンコールバックまたはコンテキストメニューで応答可能ないずれかの先祖にそのマウスクリックを渡します。
クリックされたオブジェクトはマウスクリックをキャプチャしません。マウスクリックは、クリックされたオブジェクトの背面にあるオブジェクトによってキャプチャすることができます。

次の表は、プロパティ値に基づくマウスクリックへの応答をまとめたものです。

座標軸の PickableParts	PickableParts	HitTest	マウスクリックの結果
visible/all	visible (既定の設定)	on (既定の設定)	オブジェクトの表示部分をクリックすると、ボタンダウンコールバックが実行されるか、コンテキストメニューが呼び出されます。
visible/all	all	on	オブジェクトの一部が表示されていない場合でもそれをクリックすると、そのオブジェクトが現在のオブジェクトになり、ボタンダウンコールバックが実行されるか、コンテキストメニューが呼び出されます。
visible/all/none	none	on/off	オブジェクトをクリックしても現在のオブジェクトにならず、ボタンダウンコールバックの実行もコンテキストメニューの呼び出しも行われません。
none	visible/all/none	on/off	座標軸の子オブジェクトをクリックしても、ボタンダウンコールバックの実行もコンテキストメニューの呼び出しも行われません。

MATLAB は、各オブジェクトの Parent プロパティを使用して、適切な先祖が見つかるか Figure に到達するまで先祖を検索します。

階層の上方へマウスクリックを渡す

次のオブジェクトの階層と、それらのオブジェクトの PickableParts および HitTest プロパティの設定を考えます。

次のコードで階層を作成します。

function pickHit
f = figure;
ax = axes;
p = patch(rand(1,3),rand(1,3),'g');
l = line([1 0],[0 1]);
set(f,'ButtonDownFcn',@(~,~)disp('figure'),...
   'HitTest','off')
set(ax,'ButtonDownFcn',@(~,~)disp('axes'),...
   'HitTest','off')
set(p,'ButtonDownFcn',@(~,~)disp('patch'),...
   'PickableParts','all','FaceColor','none')
set(l,'ButtonDownFcn',@(~,~)disp('line'),...
   'HitTest','off')
end

ラインのクリック

ラインを左クリックすると、以下の動作が行われます。

ラインは現在のオブジェクトになりますが、その HitTest プロパティが off のため、ButtonDownFcn コールバックを実行できません。
ラインはクリックを最も近い先祖 (親の座標軸) にしますが、親の座標軸はその ButtonDownFcn コールバックを実行できないためクリックを Figure に渡します。
Figure はコールバックを実行できるため、figure が MATLAB によりコマンドウィンドウに表示されます。

パッチのクリック

パッチの FaceColor プロパティの値は none です。一方、パッチの PickableParts プロパティの値は all なので、パッチの空の面とエッジをクリックしてパッチを選択できます。

パッチの HitTest プロパティは on のため、パッチは現在のオブジェクトになることができます。パッチが現在のオブジェクトになると、そのボタンダウンコールバックを実行します。