UIElement.QueryCursor Ereignis

Definition

Tritt auf, wenn die Anzeige des Cursors angefordert wird.Occurs when the cursor is requested to display. Dieses Ereignis wird immer dann für ein Element ausgelöst, wenn der Mauszeiger an eine neue Position bewegt wird, d  h., das Cursorobjekt muss möglicherweise in Abhängigkeit von seiner neuen Position geändert werden.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.

public:
 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 

Hinweise

Dieses Ereignis erstellt einen Alias für das Mouse.QueryCursor angefügte Ereignis für diese Klasse, sodass QueryCursor Teil der Klassenmembers-Liste ist, wenn UIElement als Basiselement geerbt wird.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 UIElement is inherited as a base element. Ereignishandler, die an das QueryCursor Ereignis angefügt sind, werden an das zugrunde liegende Mouse.QueryCursor angefügte Ereignis angefügt und empfangen die gleiche Ereignisdaten Instanz.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.

Der Cursor, auf den dieser Ereignis Name verweist, ist nicht notwendigerweise der Textcursor (manchmal auch als Einfügemarke bezeichnet).The cursor being referred to by this event name is not necessarily the text cursor (sometimes known as the insertion point). Stattdessen ist der Cursor in diesem Kontext das-Objekt, das die grafische Bildschirm Anzeige auf mehreren möglichen Eingabe bezogenen Geräten oder Konzepten in der Windows-Programmierung deklariert.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. Dieses Objekt wird durch die Cursor-Klasse in WPF dargestellt.That object is represented by the Cursor class in WPF. Mit dem WPF-Eingabe System können Sie diesen Cursor ändern, wenn er die Bildschirmposition des Mauszeigers darstellt.The WPF input system enables you to change this cursor when it represents the onscreen position of the mouse pointer. Sie können vordefinierte Werte aus der Cursors-Enumeration verwenden, oder Sie können einen benutzerdefinierten Cursor als Bilddatei deklarieren.You can use predefined values from the Cursors enumeration, or you can declare a custom cursor as an image file.

Das Lauschen auf das QueryCursor Ereignis ist keine effiziente Methode für die Cursor Verwaltung.Listening for the QueryCursor event is not an efficient technique for cursor management. Stattdessen sollte jedes Element sein eigenes Cursor Verhalten mit Cursor und ForceCursordefinieren.Instead, each element should define its own cursor behavior with Cursor and ForceCursor. Sie sollten sich nur auf QueryCursor verlassen, wenn Sie nicht die Basiselemente der WPF-Frameworkebene verwenden oder in außergewöhnlichen Fällen, in denen das Definieren des Cursor Verhaltens auf einer einzelnen Element Basis nicht Ihren Anforderungen entspricht.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. Weitere Informationen zum Implementieren des Cursor Verhaltens als Reaktion auf QueryCursorfinden Sie unter QueryCursorEventHandler.For more information on implementing cursor behavior in response to QueryCursor, see QueryCursorEventHandler.

Informationen zum RoutingereignisRouted Event Information

BezeichnerfeldIdentifier field QueryCursorEvent
Routing StrategieRouting strategy BlasenBubbling
delegateDelegate QueryCursorEventHandler
  • Es ist kein entsprechendes tunnelingereignis definiert.There is no defined corresponding tunneling event.

  • Überschreiben Sie OnQueryCursor, um die Klassen Behandlung für dieses Ereignis in abgeleiteten Klassen zu implementieren.Override OnQueryCursor to implement class handling for this event in derived classes.

Gilt für:

Siehe auch