ContentElement.QueryCursor Событие

Определение

Происходит при запросе отображения курсора.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.

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 

Комментарии

Это событие создает псевдоним для 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. Вместо этого каждый элемент должен определять собственное поведение курсора с Cursor и ForceCursor.Instead, each element should define its own cursor behavior with Cursor and ForceCursor. Следует полагаться только на QueryCursor, если не используются базовые элементы уровня среды WPF или в исключительных обстоятельствах, когда определение поведения курсора для отдельных элементов не соответствует вашим потребностям.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
делегатDelegate QueryCursorEventHandler
  • Не определено соответствующее событие туннелирования.There is no defined corresponding tunneling event.

  • Переопределите OnQueryCursor, чтобы реализовать обработку класса для этого события в производных классах.Override OnQueryCursor to implement class handling for this event in derived classes.

Применяется к

Дополнительно