UIElement.QueryCursor Zdarzenie

Definicja

Występuje po zażądaniu wyświetlenia kursora.Occurs when the cursor is requested to display. To zdarzenie jest wywoływane na elemencie za każdym razem, gdy wskaźnik myszy jest przenoszony do nowej lokalizacji, co oznacza, że obiekt kursora może wymagać zmiany na podstawie jego nowej pozycji.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 

Typ zdarzenia

QueryCursorEventHandler

Uwagi

To zdarzenie tworzy alias dla Mouse.QueryCursor dołączonego zdarzenia dla tej klasy, więc QueryCursor jest częścią listy składowych klasy, gdy UIElement jest dziedziczona jako element podstawowy.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. Programy obsługi zdarzeń dołączone do QueryCursor zdarzenia są dołączone do powiązanego Mouse.QueryCursor dołączonego zdarzenia i odbierają to samo wystąpienie danych zdarzenia.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.

Kursor, do którego odwołuje się ta nazwa zdarzenia, nie musi być kursorem tekstu (czasami znanym jako punkt wstawiania).The cursor being referred to by this event name is not necessarily the text cursor (sometimes known as the insertion point). Zamiast tego kursor w tym kontekście jest obiektem, który deklaruje wyświetlacz graficzny Onscreen związany z kilkoma możliwymi urządzeniami wejściowymi lub koncepcjami w programowaniu systemu 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. Ten obiekt jest reprezentowany przez Cursor klasę w WPF.That object is represented by the Cursor class in WPF. System wprowadzania WPF umożliwia zmianę tego kursora, gdy reprezentuje pozycję na ekranie wskaźnika myszy.The WPF input system enables you to change this cursor when it represents the onscreen position of the mouse pointer. Można użyć wstępnie zdefiniowanych wartości z Cursors wyliczenia lub można zadeklarować niestandardowy kursor jako plik obrazu.You can use predefined values from the Cursors enumeration, or you can declare a custom cursor as an image file.

Nasłuchiwanie dla QueryCursor zdarzenia nie jest efektywną techniką dla zarządzania kursorem.Listening for the QueryCursor event is not an efficient technique for cursor management. Zamiast tego każdy element powinien definiować własne zachowanie kursora z Cursor i ForceCursor .Instead, each element should define its own cursor behavior with Cursor and ForceCursor. Należy się zależeć tylko, QueryCursor Jeśli nie korzystasz z podstawowych elementów platformy WPF Framework lub w sytuacjach wyjątkowych, gdy Definiowanie zachowania kursora dla poszczególnych elementów nie spełnia Twoich potrzeb.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. Aby uzyskać więcej informacji na temat implementowania zachowania kursora w odpowiedzi na QueryCursor , zobacz QueryCursorEventHandler .For more information on implementing cursor behavior in response to QueryCursor, see QueryCursorEventHandler.

Informacje dotyczące kierowanego zdarzeniaRouted Event Information

Pole identyfikatoraIdentifier field QueryCursorEvent
Strategia routinguRouting strategy PropagacjaBubbling
DelegatDelegate QueryCursorEventHandler
  • Nie zdefiniowano odpowiedniego zdarzenia tunelowania.There is no defined corresponding tunneling event.

  • Przesłoń OnQueryCursor , aby zaimplementować obsługę klasy dla tego zdarzenia w klasach pochodnych.Override OnQueryCursor to implement class handling for this event in derived classes.

Dotyczy

Zobacz też