Storyboard.GetCurrentState Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém o estado do relógio do Storyboard.
public:
virtual ClockState GetCurrentState() = GetCurrentState;
ClockState GetCurrentState();
public ClockState GetCurrentState();
function getCurrentState()
Public Function GetCurrentState () As ClockState
Retornos
Um dos valores de enumeração. Pode ser: Ativo, Preenchendo ou Parado.
Comentários
Esse método será útil se você quiser modificar as propriedades de uma animação em runtime, antes que a animação seja iniciada. Uma animação interrompida (GetCurrentState retorna ClockState.Stopped) ainda pode ser modificada. Uma animação em execução (GetCurrentState retorna ClockState.Active ou ClockState.Filling) não pode ser modificada e você receberá um erro se tentar.
Anotações para versões anteriores
Windows 8
Uma animação pode ter um valor begintime opcional, que modifica quando a animação realmente começa a afetar valores em comparação com quando o storyboard de controle é iniciado. Mesmo que o tempo de execução ainda não tenha chegado ao BeginTime , é ilegal modificar as propriedades da animação depois que o storyboard a iniciar. Para Windows 8, chamar GetCurrentState para uma animação em execução em que o tempo de execução não atingiu BeginTime sempre retorna ClockState.Stopped. Normalmente, é legal modificar as propriedades de uma animação Parada , mas nesse caso específico não é, portanto, usar GetCurrentState para determinar se é legal modificar a animação nem sempre é preciso. Começando com Windows 8.1, chamar GetCurrentState para uma animação iniciada por seu storyboard sempre retorna ClockState.Active, mesmo que o valor BeginTime exista e não tenha sido alcançado. As circunstâncias em que GetCurrentState retorna ClockState.Filling permanecem as mesmas.
Os aplicativos que foram compilados para Windows 8, mas estão sendo executados no Windows 8.1, continuam a adotar o comportamento do Windows 8.