Compartilhar via


UIElement.ManipulationStarting Evento

Definição

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.

Aplica-se a

Confira também