UIElement.ManipulationStarting Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Ocorre quando o processador de manipulação é criado.
public:
virtual event ManipulationStartingEventHandler ^ ManipulationStarting;// Register
event_token ManipulationStarting(ManipulationStartingEventHandler const& handler) const;
// Revoke with event_token
void ManipulationStarting(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::ManipulationStarting_revoker ManipulationStarting(auto_revoke_t, ManipulationStartingEventHandler const& handler) const;public event ManipulationStartingEventHandler ManipulationStarting;function onManipulationStarting(eventArgs) { /* Your code */ }
uIElement.addEventListener("manipulationstarting", onManipulationStarting);
uIElement.removeEventListener("manipulationstarting", onManipulationStarting);
- or -
uIElement.onmanipulationstarting = onManipulationStarting;Public Custom Event ManipulationStarting As ManipulationStartingEventHandler <uiElement ManipulationStarting="eventhandler"/>
Tipo de evento
Comentários
Para controles personalizados e experiências de interação, consulte GestureRecognizer.
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.
ManipulationStarting é acionado basicamente sempre que um ponteiro interage com um elemento em que o elemento habilita a manipulação. Isso inclui casos em que a manipulação é interpretada como um gesto e os ponteiros nunca se movem, por exemplo, um gesto de Tocar ou Segurar . Se os ponteiros se moverem, ManipulationStarted normalmente será acionado posteriormente.
ManipulationStarting é 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.
ManipulationStarting 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 teve um problema ao disparar esse evento se vários gestos ocorreram em um curto período de tempo. Por exemplo, o Windows 8 só pode disparar ManipulationStarting para o primeiro gesto e não o segundo. O problema foi corrigido começando com Windows 8.1; vários gestos iniciais processados pelo sistema de entrada disparam um evento ManipulationStarting distinto.
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.