Compartilhar via


Control.OnPointerEntered(PointerRoutedEventArgs) Método

Definição

Chamado antes que o evento PointerEntered ocorra.

protected:
 virtual void OnPointerEntered(PointerRoutedEventArgs ^ e) = OnPointerEntered;
void OnPointerEntered(PointerRoutedEventArgs const& e);
protected virtual void OnPointerEntered(PointerRoutedEventArgs e);
function onPointerEntered(e)
Protected Overridable Sub OnPointerEntered (e As PointerRoutedEventArgs)

Parâmetros

e
PointerRoutedEventArgs

Os dados de evento do evento.

Comentários

Comportamento do Windows 8

Para o Windows 8, geralmente o evento PointerEntered não será acionado se o cursor na tela (ou caneta ou touchpoint) não se moveu de fato. Por exemplo, PointerEntered não será acionado se o mouse e seu cursor na tela permanecerem estacionários e um objeto com um manipulador PointerEntered tiver sua posição traduzida ou ajustada de outra forma para se mover sob o cursor na tela. Ou PointerEntered não será acionado se um elemento como um pop-up ou submenu desaparecer e o ponteiro agora estiver sobre um novo elemento (mas o ponteiro ainda não foi movido). Relacionado a isso está o comportamento PointerExited . Por exemplo, se um pop-up for ignorado programaticamente, ele não disparará PointerExited se o ponteiro não se mover como a causa de ignorá-lo. Você ainda obteria um evento PointerEntered se o ponteiro se movesse sobre o elemento recém-revelado, mas isso depende do usuário se isso vai acontecer, e isso acontece no momento da movimentação, não no momento da demissão. Resumindo, tentar usar o último elemento que disparou PointerEntered para determinar o estado do ponteiro na interface do usuário do aplicativo não é abrangente no Windows 8 e há muitos cenários em que PointerEntered e PointerExited não serão emparelhados. Isso afeta os estados visuais para controles que usam PointerEntered e PointerExited como gatilhos também.

Começando com Windows 8.1, PointerExited é acionado para qualquer caso em que o ponteiro tenha disparado ao mesmo tempo um evento PointerEntered, mas ocorre alguma alteração de estado da interface do usuário em que o ponteiro não está mais dentro desse elemento. Isso inclui casos em que todo o elemento desaparece. E se o ponteiro estiver agora sobre um elemento diferente porque um elemento anterior desapareceu, esse elemento disparará PointerEntered, mesmo que o ponteiro nunca se mova. Elementos que definem sua Visibilidade como Recolhido programaticamente são uma maneira de os elementos desaparecerem da interface do usuário, e o comportamento do Windows 8.1 é responsável por isso e disparará PointerExited para o elemento **Collapsed ** e PointerEntered para o elemento recém-revelado.

Se você migrar o código do aplicativo do Windows 8 para Windows 8.1 talvez queira considerar essa alteração de comportamento, pois isso resulta em PointerExited e PointerEntered sendo acionados nos casos em que eles não teriam sido disparados antes.

Os aplicativos que foram compilados para Windows 8, mas estão sendo executados no Windows 8.1, continuam a adotar o comportamento do Windows 8.

Aplica-se a

Confira também