Partilhar via


UIElement.QueryCursor Evento

Definição

Ocorre quando a exibição do cursor é solicitada. 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.

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 

Tipo de evento

Comentários

Esse evento cria um alias para o Mouse.QueryCursor evento anexado para essa classe, de modo que QueryCursor faz parte da lista de membros da classe quando UIElement é herdado como um elemento base. Os manipuladores de eventos anexados ao QueryCursor evento são anexados ao evento anexado subjacente Mouse.QueryCursor e recebem a mesma instância de dados de evento.

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). Em vez disso, o cursor nesse contexto é o objeto que declara a exibição gráfica na tela relacionada a vários possíveis dispositivos ou conceitos relacionados à entrada na programação do Windows. Esse objeto é representado pela Cursor classe no WPF. O sistema de entrada WPF permite que você altere esse cursor quando ele representa a posição na tela do ponteiro do mouse. Você pode usar valores predefinidos da Cursors enumeração ou declarar um cursor personalizado como um arquivo de imagem.

Escutar o QueryCursor evento não é uma técnica eficiente para o gerenciamento de cursor. Em vez disso, cada elemento deve definir seu próprio comportamento de cursor com Cursor e ForceCursor. Você só deve confiar se não estiver usando os elementos base no QueryCursor nível da estrutura do WPF ou em circunstâncias extraordinárias em que a definição do comportamento do cursor por elemento não atenda às suas necessidades. Para obter mais informações sobre como implementar o comportamento do cursor em resposta a QueryCursor, consulte QueryCursorEventHandler.

Informações de evento encaminhado

Campo Identificador QueryCursorEvent
Estratégia de roteamento Borbulhando
Delegar QueryCursorEventHandler
  • Não há nenhum evento de túnel correspondente definido.

  • Substitua OnQueryCursor para implementar o tratamento de classe para esse evento em classes derivadas.

Aplica-se a

Confira também