UIElement.ManipulationStarted Evento

Definição

Namespace:

Windows.UI.Xaml

Ocorre quando um dispositivo de entrada inicia uma manipulação no UIElement.

// Register
event_token ManipulationStarted(ManipulationStartedEventHandler const& handler) const;

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

// Revoke with event_revoker
UIElement::ManipulationStarted_revoker ManipulationStarted(auto_revoke_t, ManipulationStartedEventHandler const& handler) const;

public event ManipulationStartedEventHandler ManipulationStarted;

function onManipulationStarted(eventArgs) { /* Your code */ }
uIElement.addEventListener("manipulationstarted", onManipulationStarted);
uIElement.removeEventListener("manipulationstarted", onManipulationStarted);
- or -
uIElement.onmanipulationstarted = onManipulationStarted;

Public Custom Event ManipulationStarted As ManipulationStartedEventHandler 

<uiElement ManipulationStarted="eventhandler"/>

Tipo de evento

ManipulationStartedEventHandler

Comentários

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

ManipulationStarted representa que a lógica de reconhecimento de manipulação detectou o movimento do ponteiro. Nesse caso, é o segundo evento de manipulação a ser disparado em uma sequência típica, disparando após ManipulationStarting, mas antes de ManipulationDelta ou outros eventos, como ManipulationInertiaStarting.

Um elemento deve ter um valor ManipulationMode diferente de None ou System para ser uma fonte de 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 lidar com manipulações, defina ManipulationMode como All ou valores de ManipulationModes específicos. Para obter mais informações, consulte ManipulationMode.

ManipulationStarted é um evento roteado. Se o evento tiver permissão para fazer bolhas 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 ocorrência. Para saber mais, confira Visão geral de eventos e eventos roteados.

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

Confira também

• ManipulationStartedRoutedEventArgs
• OnManipulationStarted(ManipulationStartedRoutedEventArgs)
• ManipulationStarting
• Usando eventos de manipulação
• Exemplo de eventos de entrada do usuário XAML