UIElement.TryStartDirectManipulation(Pointer) Método

  • Referência

Definição

Namespace:
Microsoft.UI.Xaml
Editar

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 nos 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 da 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 oferece 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 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 a manipulação de Manipulação Direta para tornar seu aplicativo mais responsivo a interações por toque, como rolagem e zoom.

Somente contatos de toque ativos podem ser passados para Manipulação Direta. O uso de contatos não ativos ou não touch 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 na 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 por vez. Chamar TryStartDirectManipulation mais de uma vez no mesmo contato resulta na liberação de qualquer cadeia anterior.

Aplica-se a

Confira também