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

Définition

Se produit quand l’affichage du curseur est demandé.Occurs when the cursor is requested to display. Cet événement est déclenché sur un élément chaque fois que le pointeur de la souris se déplace vers un nouvel emplacement, ce qui signifie qu’il peut être nécessaire de modifier l’objet curseur en fonction de sa nouvelle position.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 

Remarques

Cet événement crée un alias pour l' Mouse.QueryCursor événement attaché pour cette classe, afin qu' QueryCursor il fasse partie de la liste des membres ContentElement de la classe lorsque est hérité en tant qu’élément de base.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. Les gestionnaires d’événements attachés à l' QueryCursor événement sont attachés à l' Mouse.QueryCursor événement attaché sous-jacent et reçoivent la même instance de données d’événement.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.

Le curseur référencé par ce nom d’événement n’est pas nécessairement le curseur de texte (parfois appelé point d’insertion).The cursor being referred to by this event name is not necessarily the text cursor (sometimes known as the insertion point). Au lieu de cela, le curseur dans ce contexte est l’objet qui déclare l’affichage graphique à l’écran lié à plusieurs périphériques ou concepts d’entrée possibles dans la programmation 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. Cet objet est représenté par la Cursor classe dans WPF.That object is represented by the Cursor class in WPF. Le système d’entrée WPF vous permet de modifier ce curseur lorsqu’il représente la position à l’écran du pointeur de la souris.The WPF input system enables you to change this cursor when it represents the onscreen position of the mouse pointer. Vous pouvez utiliser des valeurs prédéfinies de Cursors l’énumération, ou vous pouvez déclarer un curseur personnalisé comme fichier image.You can use predefined values from the Cursors enumeration, or you can declare a custom cursor as an image file.

L’écoute de QueryCursor l’événement n’est pas une technique efficace pour la gestion des curseurs.Listening for the QueryCursor event is not an efficient technique for cursor management. Au lieu de cela, chaque élément doit définir son propre Cursor comportement ForceCursorde curseur avec et.Instead, each element should define its own cursor behavior with Cursor and ForceCursor. Vous devez uniquement compter sur QueryCursor si vous n’utilisez pas les éléments de base au niveau de l’infrastructure WPF, ou dans des circonstances exceptionnelles où la définition du comportement du curseur pour chaque élément ne répond pas à vos besoins.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. Pour plus d’informations sur l’implémentation du comportement de QueryCursorcurseur en QueryCursorEventHandlerréponse à, consultez.For more information on implementing cursor behavior in response to QueryCursor, see QueryCursorEventHandler.

Informations sur les événements acheminésRouted Event Information

Champ d’identificateurIdentifier field QueryCursorEvent
Stratégie de routageRouting strategy PropagationBubbling
déléguéDelegate QueryCursorEventHandler
  • Aucun événement de tunneling correspondant n’est défini.There is no defined corresponding tunneling event.

  • Substituez OnQueryCursor pour implémenter la gestion de classe pour cet événement dans les classes dérivées.Override OnQueryCursor to implement class handling for this event in derived classes.

S’applique à

Voir aussi