DiscreteObjectKeyFrame Classe

Definição

Namespace:

Windows.UI.Xaml.Media.Animation

Anima do valor object do quadro-chave anterior para seu próprio Valor usando valores discretos.

public ref class DiscreteObjectKeyFrame sealed : ObjectKeyFrame

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class DiscreteObjectKeyFrame final : ObjectKeyFrame

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class DiscreteObjectKeyFrame : ObjectKeyFrame

Public NotInheritable Class DiscreteObjectKeyFrame
Inherits ObjectKeyFrame

<DiscreteObjectKeyFrame ...>
  <DiscreteObjectKeyFrame.Value>
    objectValue
  </DiscreteObjectKeyFrame.Value>
</DiscreteObjectKeyFrame ...>
-or-
</DiscreteObjectKeyFrame Value="objectAsAttribute"...>

Herança

Object Platform::Object IInspectable DependencyObject ObjectKeyFrame DiscreteObjectKeyFrame

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

As animações de quadro chave permitem mais de um valor de destino, que é atingido em um ponto ao longo da linha do tempo da animação. Em outras palavras, cada quadro chave pode especificar um valor intermediário diferente e o último quadro chave atingido é o valor de animação final. Especificando vários valores a serem animados, você pode criar animações mais complexas.

DiscreteObjectKeyFrame é o único tipo de quadro-chave permitido em um ObjectAnimationUsingKeyFrames. Não há interpolações lineares ou outra lógica de interpolação que seja possível para alterar valores de objeto à medida que a animação é executada. O objeto antigo é removido no KeyTime e o novo objeto que é o valor do quadro-chave pelo qual KeyTime o substitui.

Há vários cenários em que usar ObjectAnimationUsingKeyFrames em vez de uma animação tipada é útil. Alguns deles são:

• Criando o Storyboard para um estado visual e usando um valor que é uma referência de extensão de marcação {StaticResource} , em vez de um dos valores tipado. Isso oferece a capacidade de referenciar recursos de tema do sistema de um estado visual. Para obter mais informações , consulte Animações storyboarded para estados visuais.
• Animando valores de bytes ou int.
• Animando estruturas usadas em definições de interface do usuário e estados visuais, como GridLength. Você não pode animar as propriedades da estrutura, mas pode trocar todo o valor da estrutura por um DiscreteObjectKeyFrame e um novo GridLength.

Para obter mais informações sobre como usar animações de quadro-chave, consulte Animações de quadro-chave e animações de função easing.

Construtores

DiscreteObjectKeyFrame()

Inicializa uma nova instância da classe DiscreteObjectKeyFrame .

Propriedades

Dispatcher	Obtém o CoreDispatcher ao qual esse objeto está associado. O CoreDispatcher representa uma instalação que pode acessar DependencyObject no thread da interface do usuário mesmo que o código seja iniciado por um thread que não seja da interface do usuário. (Herdado de DependencyObject)
KeyTime	Obtém ou define a hora em que o Valor de destino do quadro-chave deve ser atingido. (Herdado de ObjectKeyFrame)
Value	Obtém ou define o valor de destino do quadro chave. (Herdado de ObjectKeyFrame)

Métodos

ClearValue(DependencyProperty)	Limpa o valor local de uma propriedade de dependência. (Herdado de DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Retorna qualquer valor base estabelecido para uma propriedade de dependência, que se aplicaria nos casos em que uma animação não está ativa. (Herdado de DependencyObject)
GetValue(DependencyProperty)	Retorna o valor efetivo atual de uma propriedade de dependência de um DependencyObject. (Herdado de DependencyObject)
ReadLocalValue(DependencyProperty)	Retorna o valor local de uma propriedade de dependência, se um valor local for definido. (Herdado de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra uma função de notificação para escutar alterações em uma DependencyProperty específica nesta instância dependencyObject . (Herdado de DependencyObject)
SetValue(DependencyProperty, Object)	Define o valor local de uma propriedade de dependência em um DependencyObject. (Herdado de DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Cancela uma notificação de alteração que foi registrada anteriormente chamando RegisterPropertyChangedCallback. (Herdado de DependencyObject)

Confira também

• ObjectKeyFrame
• ObjectAnimationUsingKeyFrames
• Animações com storyboard
• Animações de quadro chave e animações com função de easing
• Animações de storyboard para estados visuais