VisualInteractionSource Classe

Definição

Namespace:

Microsoft.UI.Composition.Interactions

Objeto para configurar a entrada para o InteractionTracker em relação a um visual.

O VisualInteractionSource foi projetado para ser usado apenas com InteractionTracker e define qual entrada será enviada ao InteractionTracker para impulsionar seu estado e propriedades. Essa classe contém o visual a ser usado para teste de clique, bem como uma variedade de propriedades de configuração para as quais gestos e tipos de entrada serão enviados para o InteractionTracker.

[WebHostHidden]
public ref class VisualInteractionSource : CompositionObject, ICompositionInteractionSource

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
[WebHostHidden]
class VisualInteractionSource : CompositionObject, ICompositionInteractionSource

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
public class VisualInteractionSource : CompositionObject, ICompositionInteractionSource

Public Class VisualInteractionSource
Inherits CompositionObject
Implements ICompositionInteractionSource

Herança

Object Platform::Object IInspectable CompositionObject VisualInteractionSource

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

ICompositionInteractionSource

Exemplos

void SetupSimpleInteractionTracker(Visual viewportVisual, Visual contentVisual)
{
  //
  // Create the InteractionTracker and set its min/max position and scale.  These could 
  // also be bound to expressions.  Note: The scrollable area can be changed from either 
  // end to facilitate content updates/virtualization.
  //

  _tracker = InteractionTracker.Create(_compositor);

  _tracker.MaxPosition = new Vector3(
    contentVisual.Size.X - viewportVisual.Size.X,
    contentVisual.Size.Y - viewportVisual.Size.Y,
    0.0f);

  _tracker.MinScale = 0.5f;
  _tracker.MaxScale = 4.0f;


  //
  // Configure the interaction source.  Enable input with inertia on all axis.
  //

  var interactionSource = VisualInteractionSource.Create(viewportVisual);

  interactionSource.PositionXSourceMode = InteractionSourceMode.EnabledWithInertia;
  interactionSource.PositionYSourceMode = InteractionSourceMode.EnabledWithInertia;
  interactionSource.ScaleSourceMode = InteractionSourceMode.EnabledWithInertia;

  _tracker.InteractionSources.Add(interactionSource);


  //
  // Bind the InteractionTracker outputs to the contentVisual.
  //

  var positionExpression = _compositor.CreateExpressionAnimation("-tracker.Position");
  positionExpression.SetReferenceParameter("tracker", _tracker);

  contentVisual.StartAnimation("Offset", positionExpression);


  var scaleExpression = _compositor.CreateExpressionAnimation("Vector3(tracker.Scale, tracker.Scale, 1.0)");

  scaleExpression.SetReferenceParameter("tracker", _tracker);

  contentVisual.StartAnimation("Scale", scaleExpression);
}

Comentários

O VisualInteractionSource é usado para definir propriedades importantes sobre os tipos de interações que devem impulsionar o estado e as propriedades do InteractionTracker. A propriedade de origem é usada para teste de clique, bem como o espaço de coordenadas para detecção de gestos. Como resultado, é importante usar um Visual que não estará em movimento durante a manipulação. Vários VisualInteractionSources podem ser associados ao mesmo InteractionTracker se houver várias regiões de teste de clique, mas os casos mais comuns exigem apenas um VisualInteractionSource para um determinado InteractionTracker.

VisualInteractionSource é a classe para configurar quais tipos de gestos devem ser considerados para conduzir o InteractionTracker. As posições X e Y estão associadas ao movimento panorâmico horizontal e vertical, respectivamente. A escala é detectada com um gesto de pinçagem, geralmente associado ao zoom. Esses três modos de origem são configuráveis para entrada touch e Precision Touchpad. Cada um desses modos de origem pode ser habilitado com ou sem inércia:

• Habilitar a inércia indica que a posição ou a escala serão naturalmente interpoladas da velocidade de liberação para nenhuma velocidade durante o estado de inércia.

• Desabilitar a inércia indica que a velocidade de posição ou escala irá imediatamente para 0 após a conclusão da interação. Quando a entrada que direciona a posição ou a escala é roteada para o InteractionTracker, a propriedade InteractionTracker de mesmo nome será atualizada adequadamente.

As configurações de trilhos indicam como o gesto será detectado. Os trilhos, por padrão, estão ativados e indicam que a panela horizontal ou vertical será bloqueada para um eixo específico quando iniciada principalmente nesse eixo. Isso é explicado mais detalhadamente nas páginas de propriedades de grade.

A configuração de encadeamento indica se a entrada processada por um VisualInteractionSource pode fluir para outra entidade quando o InteractionTracker atinge o mínimo ou o máximo nessa direção. Essa configuração permitirá que a entrada encadeie para outro InteractionTracker por meio de outro VisualInteractionSource ou para um ScrollViewer se o visual de origem do VisualInteractionSource for filho do ScrollViewer.

Propriedades

Comment	Uma cadeia de caracteres a ser associada ao CompositionObject. (Herdado de CompositionObject)
Compositor	O Compositor usado para criar este CompositionObject. (Herdado de CompositionObject)
DeltaPosition	A quantidade de alteração de posição a ser aplicada durante o próximo quadro. Assume o padrão de 0. Legível somente por meio de expressão/animação.
DeltaScale	A quantidade de alteração de escala a ser aplicada durante o próximo quadro. Multiplicativo. O valor padrão é 1. Legível somente por meio de expressão/animação.
DispatcherQueue	Obtém o DispatcherQueue para o CompositionObject. (Herdado de CompositionObject)
ImplicitAnimations	A coleção de animações implícitas anexadas a esse objeto. (Herdado de CompositionObject)
IsPositionXRailsEnabled	Indica se o movimento panorâmico no eixo x está gradeado. A propriedade IsPositionXRailsEnabled define a configuração de grade para quando o movimento panorâmico do eixo X é enviado para o InteractionTracker correspondente. Quando habilitada, se a parte inicial da panorâmica for angulada em um intervalo específico em relação ao eixo X, o componente Y da panela será ignorado e considerado uma panorâmica horizontal perfeita. Essa propriedade geralmente é habilitada em situações em que uma experiência de rolagem X e Y está habilitada, mas também requer um movimento panorâmico horizontal confiável e perfeito.
IsPositionYRailsEnabled	Indica se o movimento panorâmico no eixo y está restrito. A propriedade IsPositionYRailsEnabled define a configuração de grade para quando o movimento panorâmico do eixo Y é enviado para o InteractionTracker correspondente. Quando habilitado, se a parte inicial da panorâmica for angulada em um intervalo específico em relação ao eixo Y, o componente X da panela será ignorado e considerado uma panorâmica vertical perfeita. Essa propriedade geralmente é habilitada em situações em que uma experiência de rolagem X e Y está habilitada, mas também requer um movimento panorâmico vertical confiável e perfeito.
ManipulationRedirectionMode	Indica qual entrada deve ser redirecionada para o InteractionTracker.
PointerWheelConfig	Obtém a configuração para entrada de roda de ponteiro.
Position	A quantidade total de alteração de posição desde o início da interação. Assume o padrão de 0. Legível somente por meio de expressão/animação.
PositionVelocity	A taxa instantânea de alteração de posição na interação, em pixels por segundo. Assume o padrão de 0. Legível somente por meio de expressão/animação.
PositionXChainingMode	A propriedade PositionXChainingMode define o comportamento de encadeamento para um InteractionSource na direção X. Há três tipos InteractionChainingMode : Auto Always Never Quando o encadeamento na direção X estiver habilitado, a entrada fluirá para o VisualInteractionSource do ancestral mais próximo sempre que a interação (como movimento panorâmico) tomar a posição do InteractionTracker após sua posição X mínima ou máxima.
PositionXSourceMode	Modo de origem para o eixo X. A propriedade PositionXSourceMode define como as interações são processadas para um VisualInteractionSource no eixo X. Há três tipos InteractionSourceMode para escolher: As interações estão desabilitadas EnabledWithInertia EnabledWithoutInertia Essa propriedade deve ser habilitada para permitir que o VisualInteractionSource envie dados do eixo X para o InteractionTracker.
PositionYChainingMode	A propriedade PositionYChainingMode define o comportamento de encadeamento para um InteractionSource na direção Y. Há três tipos de InteractionChainingMode s: Auto , Always , Never . Quando o encadeamento na direção Y estiver habilitado, a entrada fluirá para o VisualInteractionSource do ancestral mais próximo sempre que a interação (como movimento panorâmico) tomar a posição do InteractionTracker após sua posição mínima ou máxima Y.
PositionYSourceMode	Modo de origem para o eixo Y. A propriedade PositionYSourceMode define como as interações são processadas para um VisualInteractionSource no eixo Y. Há três tipos InteractionSourceMode para escolher: As interações estão desabilitadas EnabledWithInertia EnabledWithoutInertia Essa propriedade deve ser habilitada para permitir que o VisualInteractionSource envie dados do eixo Y para o InteractionTracker.
Properties	A coleção de propriedades associadas ao CompositionObject. (Herdado de CompositionObject)
Scale	A diferença percentual total em escala desde o início da interação. Multiplicativo. O valor padrão é 1. Legível somente por meio de expressão/animação.
ScaleChainingMode	A propriedade ScaleChainingMode define o comportamento de encadeamento de um InteractionSource na direção escala. Há três tipos de InteractionChainingMode s: Auto, Always, Never. Quando o encadeamento de escala estiver habilitado, a entrada fluirá para o VisualInteractionSource do ancestral mais próximo sempre que a interação (como movimento panorâmico) assumir a posição do InteractionTracker após a posição mínima ou máxima de Escala.
ScaleSourceMode	Define como as interações são processadas para um VisualInteractionSource no eixo de escala. Há três tipos InteractionSourceMode para escolher: Desabilitado EnabledWithInertia EnabledWithoutInertia Essa propriedade deve ser habilitada para permitir que o VisualInteractionSource envie dados de escala para o InteractionTracker.
ScaleVelocity	A taxa instantânea de alteração de escala na interação, em porcentagem por segundo. Aditivo. Assume o padrão de 0. Legível somente por meio de expressão/animação.
Source	O visual usado para teste de clique e define o espaço de coordenação para o reconhecimento de gestos.

Métodos

Close()	Fecha o CompositionObject e libera os recursos do sistema. (Herdado de CompositionObject)
ConfigureCenterPointXModifiers(IIterable<CompositionConditionalValue>)	Usa uma lista ordenada de CompositionConditionalValue. Em um quadro, o primeiro CompositionConditionalValue a ter seu ". Condition" evaluate to true substitui o valor de zoom CenterPointX que o VisualInteractionSource fornece com seu ". Valor". Se nenhum for avaliado como true, o CenterPointX não será substituído por esse quadro.
ConfigureCenterPointYModifiers(IIterable<CompositionConditionalValue>)	Usa uma lista ordenada de CompositionConditionalValue. Em um quadro, o primeiro CompositionConditionalValue a ter seu ". Condition" evaluate to true substitui o valor de zoom CenterPointY que o VisualInteractionSource fornece com seu ". Valor". Se nenhum for avaliado como true, o CenterPointY não será substituído por esse quadro.
ConfigureDeltaPositionXModifiers(IIterable<CompositionConditionalValue>)	Usa uma lista ordenada de CompositionConditionalValue. Em um quadro, o primeiro CompositionConditionalValue a ter seu ". Condition" evaluate to true substitui o valor DeltaPositionX que o VisualInteractionSource fornece por seu ". Valor". Se nenhum for avaliado como true, o DeltaPositionX não será substituído por esse quadro.
ConfigureDeltaPositionYModifiers(IIterable<CompositionConditionalValue>)	Usa uma lista ordenada de CompositionConditionalValue. Em um quadro, o primeiro CompositionConditionalValue a ter seu ". Condition" evaluate to true substitui o valor DeltaPositionY que o VisualInteractionSource fornece por seu ". Valor". Se nenhum for avaliado como true, o DeltaPositionY não será substituído por esse quadro.
ConfigureDeltaScaleModifiers(IIterable<CompositionConditionalValue>)	Usa uma lista ordenada de CompositionConditionalValue. Em um quadro, o primeiro CompositionConditionalValue a ter seu ". Condition" evaluate to true substitui o valor DeltaScale que o VisualInteractionSource fornece por seu ". Valor". Se nenhum for avaliado como true, o DeltaScale não será substituído por esse quadro.
Create(Visual)	Cria uma instância do VisualInteractionSource.
CreateFromIVisualElement(IVisualElement)	Cria uma instância do VisualInteractionSource de um elemento que implementa IVisualElement.
Dispose()	Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados. (Herdado de CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Define uma propriedade que pode ser animada. (Herdado de CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	Conecta uma animação com a propriedade especificada do objeto e inicia a animação. (Herdado de CompositionObject)
StartAnimation(String, CompositionAnimation)	Conecta uma animação com a propriedade especificada do objeto e inicia a animação. (Herdado de CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Inicia um grupo de animação. O método StartAnimationGroup em CompositionObject permite iniciar CompositionAnimationGroup. Todas as animações no grupo serão iniciadas ao mesmo tempo no objeto . (Herdado de CompositionObject)
StopAnimation(String)	Desconecta uma animação da propriedade especificada e interrompe a animação. (Herdado de CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Interrompe um grupo de animação. (Herdado de CompositionObject)
TryGetAnimationController(String)	Retorna um AnimationController para a animação em execução na propriedade especificada. (Herdado de CompositionObject)
TryRedirectForManipulation(PointerPoint)	Tenta enviar manipulações configuradas para o fluxo de ponteiro fornecido para o InteractionTracker, não para o thread de interface do usuário do aplicativo, começando no PointerPoint fornecido. Importante Esse método só deve ser chamado com um PointerDeviceType de Touch.

Confira também

• CompositionObject
• ICompositionInteractionSource
• IClosable