UIElement.ManipulationCompleted Evento

Definição

Namespace:

Windows.UI.Xaml

Ocorre quando uma manipulação no UIElement é concluída.

public:
 virtual event ManipulationCompletedEventHandler ^ ManipulationCompleted;

// Register
event_token ManipulationCompleted(ManipulationCompletedEventHandler const& handler) const;

// Revoke with event_token
void ManipulationCompleted(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::ManipulationCompleted_revoker ManipulationCompleted(auto_revoke_t, ManipulationCompletedEventHandler const& handler) const;

public event ManipulationCompletedEventHandler ManipulationCompleted;

function onManipulationCompleted(eventArgs) { /* Your code */ }
uIElement.addEventListener("manipulationcompleted", onManipulationCompleted);
uIElement.removeEventListener("manipulationcompleted", onManipulationCompleted);
- or -
uIElement.onmanipulationcompleted = onManipulationCompleted;

Public Custom Event ManipulationCompleted As ManipulationCompletedEventHandler 

<uiElement ManipulationCompleted="eventhandler"/>

Tipo de evento

ManipulationCompletedEventHandler

Comentários

Para controles personalizados e experiências de interação, consulte GestureRecognizer.ManipulationCompleted.

Um elemento deve ter um valor ManipulationMode diferente de None ou System para ser uma origem do evento de manipulação. O valor padrão de ManipulationMode é System, que permite que a lógica de controle interna processe manipulações, mas não permite que o código do aplicativo manipule eventos de manipulação. Se você quiser manipular manipulações, defina ManipulationMode como All ou como valores ManipulationModes específicos. Para obter mais informações, consulte ManipulationMode.

ManipulationCompleted é um evento roteado. Se o evento tiver permissão para surgir até os elementos pai porque ele fica sem tratamento, é possível manipular o evento em elementos pai, mesmo que ManipulationMode seja None ou System no elemento pai. Para obter mais informações sobre o conceito de evento roteado, consulte Visão geral de eventos e eventos roteado.

Para ações de toque e também para eventos específicos de interação ou de manipulação resultantes de uma ação de toque, é preciso que o elemento esteja visível para teste de clique, para ser a origem do evento e acionar o evento associado à ação. UIElement.Visibility deve ser Visível. Outras propriedades de tipos derivados também afetam a visibilidade do teste de clique. Para saber mais, confira Visão geral de eventos e eventos roteados.

ManipulationCompleted dá suporte à capacidade de anexar manipuladores de eventos à rota que será invocada mesmo se os dados do evento estiverem marcados como Manipulados. Consulte AddHandler.

Comportamento do Windows 8

O Windows 8 não dispara ManipulationCompleted nos casos em que a fase inercial foi iniciada (e ManipulationInertiaStarting foi acionada), mas o usuário tocou no item antes de terminar a rolagem, o que cancela a fase inercial visualmente. O problema foi corrigido começando com Windows 8.1; ManipulationCompleted é acionado assim que a ação de toque cancela a fase inercial.

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.

Confira também

• ManipulationCompletedRoutedEventArgs
• ManipulationStarted
• ManipulationStarting
• OnManipulationCompleted(ManipulationCompletedRoutedEventArgs)
• Usando eventos de manipulação
• Exemplo de eventos de entrada do usuário XAML