Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Estrutura Duration

Representa a duração de tempo que uma Timeline está ativa.

Namespace:  System.Windows
Assembly:  PresentationCore (em PresentationCore.dll)
XMLNS para XAML http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

[TypeConverterAttribute(typeof(DurationConverter))]
public struct Duration
<object property="[days.]hours:minutes:seconds[.fractionalSeconds]"/>- ou -<object property="[days.]hours:minutes"/>- ou -<object property="Automatic"/>- ou -<object property="Forever"/>

Valores XAML

dias

System.Int32

Um valor maior ou igual a 0 que descreve o número de dias ocupadas por essa duração.

horas

System.Int32

Um valor entre 0 e 23 que representa o número de horas abrangido por essa duração.

minutos

System.Int32

Um valor entre 0 e 59 que representa o número de minutos ocupadas por essa duração.

segundos

System.Int32

Um valor entre 0 e 59 que representa o número de segundos ocupadas por essa duração.

fractionalSeconds

System.Int32

Um valor que pode ser de 1 a 7 dígitos que representa a fração de segundo.

O tipo Duration expõe os membros a seguir.

  NomeDescrição
Método públicoDurationInicializa uma nova instância da Duration estrutura com o fornecido TimeSpan valor.
Superior

  NomeDescrição
Propriedade públicaMembro estáticoAutomaticObtém um Duration valor que é determinado automaticamente.
Propriedade públicaMembro estáticoForeverObtém um Duration valor que representa um intervalo de infinito.
Propriedade públicaHasTimeSpanObtém um valor que indica se este Duration representa uma TimeSpan valor.
Propriedade públicaTimeSpanObtém o TimeSpan valor que esse Duration representa.
Superior

  NomeDescrição
Método públicoAddAdiciona o valor da instância especificada do Duration o valor da instância atual.
Método públicoMembro estáticoCompareCompara uma Duration valor para outro.
Método públicoEquals(Duration)Determina se um especificado Duration é igual a esta instância do Duration.
Método públicoEquals(Object)Determina se um objeto especificado é igual a uma instância de Duration. (Substitui ValueType.Equals(Object).)
Método públicoMembro estáticoEquals(Duration, Duration)Determina se duas instâncias de Duration são iguais.
Método públicoGetHashCodeObtém um código hash para essa instância. (Substitui ValueType.GetHashCode().)
Método públicoGetType Obtém o Type da instância atual. (Herdado de Object.)
Método públicoMembro estáticoPlusRetorna a instância especificada do Duration.
Método públicoSubtractSubtrai o valor da instância especificada do Duration nessa instância.
Método públicoToStringConverte uma instância de Duration para um String representação. (Substitui ValueType.ToString().)
Superior

  NomeDescrição
Operador públicoMembro estáticoAdditionAdiciona duas instâncias do Duration juntos.
Operador públicoMembro estáticoEqualityDetermina se duas instâncias de Duration são iguais.
Operador públicoMembro estáticoGreaterThanDetermina se uma instância de Duration é maior do que o outro.
Operador públicoMembro estáticoGreaterThanOrEqualDetermina se uma instância de Duration é maior que ou igual a outra instância.
Operador públicoMembro estáticoImplicit(TimeSpan to Duration)Cria implicitamente um Duration de um determinado TimeSpan.
Operador públicoMembro estáticoInequalityDetermina se duas instâncias de Duration não são iguais.
Operador públicoMembro estáticoLessThanDetermina se o valor de uma instância de Duration é menor que o valor de outra instância.
Operador públicoMembro estáticoLessThanOrEqualDetermina se o valor de uma instância de Duration é menor ou igual ao valor de outra instância.
Operador públicoMembro estáticoSubtractionSubtrai o valor de uma instância de Duration de outro.
Operador públicoMembro estáticoUnaryPlusRetorna a instância especificada do Duration.
Superior

Um Timeline representa um segmento de tempo e o comprimento daquele segmento é determinado pela Duration da linha do tempo. Quando um Timeline chega ao final de sua duração, sua execução é interrompida. Se o Timeline tiver outras linhas do tempo como suas filhas, sua execução é interrompida também. No caso de uma animação, a Duration especifica quanto tempo a animação leva para fazer a transição do seu valor inicial ao seu valor final.

Você pode especificar um Duration com um tempo finito e específico, ou os valores especiais Automatic ou Forever. A duração de uma animação deve sempre ser um valor de tempo, porque uma animação deve sempre ter um comprimento finito e definido—caso contrário, a animação não saberia como fazer a transição entre seus valores inicial e final. Linhas de tempo contêineres (objetos TimelineGroup), tais como Storyboard e ParallelTimeline, têm uma duração padrão de Automatic, o que significa que elas automaticamente terminam quando seu último filho termina de executar.

No exemplo a seguir, a largura, altura, e cor de preenchimento de um Rectangle são animadas. Durações são definidas para animações e linhas de tempo contêiner, o que resulta em efeitos de animação que incluem o controle da velocidade percebida de uma animação e a sobrescrita da duração das linhas de tempo filhas com a duração da linha de tempo contêiner.


<Page 
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
  <StackPanel Margin="20">

    <Rectangle Width="100" Height="100" Name="myRectangle">
      <Rectangle.Fill>
        <SolidColorBrush x:Name="MyAnimatedBrush" Color="Black" />
      </Rectangle.Fill>
      <Rectangle.Triggers>

        <!-- Animates the rectangle fill to yellow and width to 300. -->
        <EventTrigger RoutedEvent="Rectangle.Loaded">
          <BeginStoryboard>

            <!-- By default, TimelineGroup objects like Storyboard and ParallelTimeline have 
            a Duration of "Automatic". A TimelineGroup's automatic duration encompasses its 
            last-ending child. In this example, there is only one child of the Storyboard, the
            ParallelTimeline, so when the ParallelTimeline ends, the Storyboard duration will
            automatically end. -->
            <Storyboard>

              <!-- This ParallelTimeline has overriden its default duration of "Automatic" with
              a finite duration of half a second. This will force this Timeline to end after half a
              second even though its child Timelines have a longer duration (2 and 4 seconds respectively). 
              This cuts off the animation prematurely and the rectangle's fill will not go all the way to 
              yellow nor will the rectangle width get all the way to 300. Again, the default duration of a
              ParallelTimeline is "Automatic" so if you remove the finite duration, the ParallelTimeline
              will wait for its child timelines to end before it ends. -->

              <!-- Note: To specify a finite time in XAML, use the syntax of "days:hours:seconds". As mentioned,
              this ParallelTimeline has a duration of half a second. -->
              <ParallelTimeline Duration="0:0:0.5">

                <!-- For Animation Timelines like DoubleAnimation, the duration is one factor that
                determines the rate at which an animation appears to progress. For example, the DoubleAnimation
                below that animates the rectangle height will complete in only one second while the animation
                that animates the width willwill complete in 2 seconds which is relatively fast compared to the DoubleAnimation
                which animates the rectangle width over 4 seconds. -->
                <DoubleAnimation
                  Storyboard.TargetName="myRectangle"
                  Storyboard.TargetProperty="Height"
                  To="300" Duration="0:0:1" />

                <DoubleAnimation
                  Storyboard.TargetName="myRectangle"
                  Storyboard.TargetProperty="Width"
                  To="300" Duration="0:0:4" />

                <ColorAnimation
                  Storyboard.TargetName="MyAnimatedBrush"
                  Storyboard.TargetProperty="Color"
                  To="Yellow" Duration="0:0:2" />

              </ParallelTimeline>
            </Storyboard>
          </BeginStoryboard>
        </EventTrigger>

      </Rectangle.Triggers>
    </Rectangle>
  </StackPanel>
</Page>


.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Qualquer estático (Shared no Visual Basic) membro público desse tipo é thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft