UIElement.TryStartDirectManipulation(Pointer) Método

Definição

Retoma o processamento de manipulação direta (movimento panorâmico/zoom definido pelo sistema) em qualquer pai ScrollViewer que contenha o UIElement atual.

public:
 static bool TryStartDirectManipulation(Pointer ^ value);
 static bool TryStartDirectManipulation(Pointer const& value);
public static bool TryStartDirectManipulation(Pointer value);
function tryStartDirectManipulation(value)
Public Shared Function TryStartDirectManipulation (value As Pointer) As Boolean

Parâmetros

value
Pointer

O ponto de toque ativo que iniciou a manipulação.

Retornos

Boolean

bool

true se um pai ScrollViewer existir e definir o valor resultou na retomada da ação de movimento panorâmico/zoom. false se chamar o método não resultar em nenhuma ação.

Comentários

Por padrão, as interações de entrada por toque em elementos ScrollViewer são manipuladas pelo mecanismo de Manipulação Direta fora do thread da interface do usuário. Um aplicativo não pode processar diretamente os eventos de ponteiro associados após o início do processamento de Manipulação Direta . Você pode chamar CancelDirectManipulations no início de uma ScrollViewer interação e manipular os eventos de ponteiro no thread da interface do usuário, o que lhe dá a oportunidade de fazer o tratamento de entrada personalizado em um ScrollViewer.

Se você cancelar o processamento de Manipulação Direta no início de uma interação do ScrollViewer , poderá chamar TryStartDirectManipulation para retomar o processo de Manipulação Direta no fluxo de entrada. Isso permite que você faça o processamento de entrada personalizado primeiro e, em seguida, retome o tratamento da Manipulação Direta para tornar seu aplicativo mais responsivo às interações por toque, como rolagem e zoom.

Somente contatos de toque ativos podem ser passados para a Manipulação Direta. O uso de contatos não ativos ou não sensíveis ao toque faz com que uma exceção seja gerada.

Especificar um contato de toque para passar para a Manipulação Direta resulta na estrutura subindo a cadeia pai e definindo o contato no visor de Manipulação Direta de cada ScrollViewer encontrado em ordem, até que a caminhada atinja qualquer elemento (incluindo o elemento de destino original) que não tenha um ManipulationMode que contenha ManipulationModes.System. Um determinado contato por toque só pode ser associado a uma única cadeia de visuais de cada vez. Chamar TryStartDirectManipulation mais de uma vez no mesmo contato resulta na liberação de qualquer cadeia anterior.

Aplica-se a

Confira também