UIElement.QueryCursor Evento

Definição

Ocorre quando a exibição do cursor é solicitada.Occurs when the cursor is requested to display. Este evento é gerado em um elemento toda vez que o ponteiro do mouse se move para uma nova localização, o que significa que o objeto de cursor talvez precise ser alterado de acordo com sua nova posição.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 

Comentários

Esse evento cria um alias para o evento Mouse.QueryCursor anexado para essa classe, de modo que QueryCursor faz parte da lista de membros da classe quando UIElement é herdado como um elemento 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 UIElement is inherited as a base element. Os manipuladores de eventos anexados ao evento QueryCursor são anexados ao evento subjacente Mouse.QueryCursor anexado e recebem a mesma instância de dados de evento.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.

O cursor que está sendo referenciado por esse nome de evento não é necessariamente o cursor de texto (às vezes conhecido como ponto de inserção).The cursor being referred to by this event name is not necessarily the text cursor (sometimes known as the insertion point). Em vez disso, o cursor nesse contexto é o objeto que declara a exibição gráfica na tela relacionada a vários dispositivos ou conceitos relacionados à entrada possíveis na programação do 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. Esse objeto é representado pela classe Cursor no WPF.That object is represented by the Cursor class in WPF. O sistema de entrada do WPF permite que você altere esse cursor quando ele representa a posição na tela do ponteiro do mouse.The WPF input system enables you to change this cursor when it represents the onscreen position of the mouse pointer. Você pode usar valores predefinidos da enumeração Cursors ou pode declarar um cursor personalizado como um arquivo de imagem.You can use predefined values from the Cursors enumeration, or you can declare a custom cursor as an image file.

A escuta do evento de QueryCursor não é uma técnica eficiente para o gerenciamento de cursores.Listening for the QueryCursor event is not an efficient technique for cursor management. Em vez disso, cada elemento deve definir seu próprio comportamento de cursor com Cursor e ForceCursor.Instead, each element should define its own cursor behavior with Cursor and ForceCursor. Você só deve contar com QueryCursor se não estiver usando elementos base no nível de estrutura do WPF ou em circunstâncias extraordinárias em que a definição do comportamento do cursor em uma base por elemento não atenda às suas necessidades.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. Para obter mais informações sobre como implementar o comportamento do cursor em resposta a QueryCursor, consulte QueryCursorEventHandler.For more information on implementing cursor behavior in response to QueryCursor, see QueryCursorEventHandler.

Informações Sobre Eventos RoteadosRouted Event Information

Campo de identificadorIdentifier field QueryCursorEvent
Estratégia de roteamentoRouting strategy PropagaçãoBubbling
DelegadoDelegate QueryCursorEventHandler
  • Não há nenhum evento de túnel correspondente definido.There is no defined corresponding tunneling event.

  • Substitua OnQueryCursor para implementar a manipulação de classe para esse evento em classes derivadas.Override OnQueryCursor to implement class handling for this event in derived classes.

Aplica-se a

Veja também