UIElement.ManipulationStarting Evento

Definição

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Ocorre quando o processador de manipulação é criado.

public:
 event EventHandler<System::Windows::Input::ManipulationStartingEventArgs ^> ^ ManipulationStarting;

public event EventHandler<System.Windows.Input.ManipulationStartingEventArgs> ManipulationStarting;

member this.ManipulationStarting : EventHandler<System.Windows.Input.ManipulationStartingEventArgs> 

Public Custom Event ManipulationStarting As EventHandler(Of ManipulationStartingEventArgs) 

Tipo de evento

EventHandler<ManipulationStartingEventArgs>

Exemplos

O exemplo a seguir mostra o manipulador de eventos do ManipulationStarting evento e define o ManipulationContainer como o elemento pai que recebe os eventos de manipulação para que as coordenadas da manipulação sejam relativas ao elemento pai. Este exemplo faz parte de um exemplo maior em Passo a passo: Criando seu primeiro aplicativo touch.

void Window_ManipulationStarting(object sender, ManipulationStartingEventArgs e)
{
    e.ManipulationContainer = this;
    e.Handled = true;
}

Private Sub Window_ManipulationStarting(ByVal sender As Object, ByVal e As ManipulationStartingEventArgs)
    e.ManipulationContainer = Me
    e.Handled = True
End Sub

Comentários

O ManipulationStarting evento ocorre em um elemento que tem a IsManipulationEnabled propriedade definida como true quando o usuário coloca um dedo nele. Por padrão, eventos de manipulação subsequentes relatam a posição da manipulação em relação ao elemento definido IsManipulationEnabled como true. Você pode especificar que a posição deve ser relativa a outro elemento definindo a ManipulationContainer propriedade . Por exemplo, você pode tornar a manipulação relativa ao pai do elemento.

Você também pode fazer o seguinte em um manipulador de eventos para ManipulationStarting:

• Especifique se o usuário precisa de mais de um dedo para executar as manipulações definindo a ManipulationStartingEventArgs.IsSingleTouchEnabled propriedade .

• Especifique quais tipos de manipulação estão habilitados definindo a ManipulationStartingEventArgs.Mode propriedade como uma ManipulationModes enumeração.

• Especifique o centro de uma rotação de dedo único definindo a ManipulationStartingEventArgs.Pivot propriedade .

• Cancele a manipulação chamando o ManipulationStartingEventArgs.Cancel método .

Para obter mais informações sobre manipulações, consulte Visão geral de entrada. Para obter um exemplo de um aplicativo que responde a manipulações, consulte Passo a passo: criando seu primeiro aplicativo touch.

Informações de evento encaminhado

Campo Identificador	ManipulationStartingEvent
Estratégia de roteamento	Borbulhando
Delegar	EventHandler<TEventArgs> do tipo ManipulationStartingEventArgs.