ContentElement.QueryCursor ContentElement.QueryCursor ContentElement.QueryCursor ContentElement.QueryCursor Event


カーソルの表示が要求されると発生します。Occurs when the cursor is requested to display. このイベントは、マウス ポインターが別の位置へ移動するたびに要素上で発生します。したがって、場合によってはカーソル オブジェクトを移動先の位置に基づいて変更する必要があります。This event is raised on an element each time that the mouse pointer moves to a new location, which means the cursor object might need to be changed based on its new position.

 event System::Windows::Input::QueryCursorEventHandler ^ QueryCursor;
public event System.Windows.Input.QueryCursorEventHandler QueryCursor;
member this.QueryCursor : System.Windows.Input.QueryCursorEventHandler 
Public Custom Event QueryCursor As QueryCursorEventHandler 


このイベントのエイリアスを作成する、Mouse.QueryCursor添付イベントは、このクラスのようにQueryCursor一部であるクラスのメンバーのリストContentElementは基本要素として継承されます。This event creates an alias for the Mouse.QueryCursor attached event for this class, so that QueryCursor is part of the class members list when ContentElement is inherited as a base element. イベント ハンドラーに関連付けられている、QueryCursorイベントは、基になるに関連付けられているMouse.QueryCursor添付イベントと同じイベント データ インスタンスを受信します。Event handlers that are attached to the QueryCursor event are attached to the underlying Mouse.QueryCursor attached event and receive the same event data instance.

このイベントの名前で参照されているカーソルは、必ずしも (挿入ポイントとも呼ばれる) にテキスト カーソルではありません。The cursor being referred to by this event name is not necessarily the text cursor (sometimes known as the insertion point). 代わりに、このコンテキストでのカーソルは、いくつかの可能な入力に関連するデバイスまたは Windows プログラミングの概念に関連する画面上のグラフィカル表示を宣言するオブジェクトです。Instead, the cursor in this context is the object that declares the onscreen graphical display related to several possible input-related devices or concepts in Windows programming. そのオブジェクトがによって表される、 Cursor wpf クラスです。That object is represented by the Cursor class in WPF. WPF 入力システムでは、画面上にマウス ポインターの位置を表す場合は、このカーソルを変更することができます。The WPF input system enables you to change this cursor when it represents the onscreen position of the mouse pointer. 定義済みの値を使用することができます、Cursors列挙型、または画像ファイルとしてカスタム カーソルを宣言できます。You can use predefined values from the Cursors enumeration, or you can declare a custom cursor as an image file.

リッスン、QueryCursorイベントは、カーソルの管理のための効率的な手法ではありません。Listening for the QueryCursor event is not an efficient technique for cursor management. 各要素が、独自のカーソルの動作を定義する代わりに、CursorForceCursorします。Instead, each element should define its own cursor behavior with Cursor and ForceCursor. のみに依存しないでくださいQueryCursorWPF フレームワーク レベルの基本要素を使用していないかで異常な場合に、カーソルの動作を定義する要素ごとの単位ではニーズに合わないかどうか。You should only rely on QueryCursor if you are not using the WPF framework-level base elements, or in extraordinary circumstances where defining cursor behavior on a per-element basis does not meet your needs. 応答でのカーソルの動作の実装の詳細についてはQueryCursorを参照してくださいQueryCursorEventHandlerします。For more information on implementing cursor behavior in response to QueryCursor, see QueryCursorEventHandler.

ルーティングされたイベント情報Routed Event Information

識別子フィールドです。Identifier field QueryCursorEvent
ルーティング方法Routing strategy バブルBubbling
DelegateDelegate QueryCursorEventHandler
  • 定義済みの対応するトンネル イベントはありません。There is no defined corresponding tunneling event.

  • オーバーライドOnQueryCursor派生クラスでは、このイベントに対するクラス処理を実装します。Override OnQueryCursor to implement class handling for this event in derived classes.