UIElement.QueryCursor Evento

Definição

Namespace:

System.Windows

Assembly:

PresentationCore.dll

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.

C#

public event System.Windows.Input.QueryCursorEventHandler QueryCursor;

Tipo de evento

QueryCursorEventHandler

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

• Cursor