Partilhar via


DoubleAnimation.By Propriedade

Definição

Obtém ou define o valor total pelo qual a animação altera seu valor inicial.

public:
 property Nullable<double> By { Nullable<double> get(); void set(Nullable<double> value); };
public double? By { get; set; }
member this.By : Nullable<double> with get, set
Public Property By As Nullable(Of Double)

Valor da propriedade

O valor total pelo qual a animação altera seu valor inicial. O valor padrão é nulo.

Comentários

Use a propriedade By quando quiser animar um valor "por" uma determinada quantidade, em vez de especificar um valor inicial ou final. Você também pode usar a propriedade By com a propriedade From.

A tabela a seguir resume como as propriedades From, Toe By podem ser usadas em conjunto ou separadamente para determinar os valores de destino de uma animação.

Propriedades especificadas Comportamento resultante
From A animação progride do valor especificado pela propriedade From para o valor base da propriedade que está sendo animada ou para o valor de saída de uma animação anterior, dependendo de como a animação anterior é configurada.
From e To A animação progride do valor especificado pela propriedade From para o valor especificado pela propriedade To.
From e By A animação progride do valor especificado pela propriedade From para o valor especificado pela soma das propriedades From e By.
To A animação progride do valor base da propriedade animada ou do valor de saída de uma animação anterior para o valor especificado pela propriedade To.
By A animação progride do valor base da propriedade que está sendo animada ou do valor de saída de uma animação anterior para a soma desse valor e o valor especificado pela propriedade By.

Nota

Se você definir as propriedades To e By, a propriedade To terá precedência e a propriedade By será ignorada.

Para usar outros métodos de interpolação ou animar entre mais de dois valores de destino, use um objeto DoubleAnimationUsingKeyFrames.

Uso do atributo XAML

< objetoBy="Double"/>

-ou-

< objetoBy="{}"/>

Informações da propriedade Dependency

Campo identificador ByProperty
Propriedades de metadados definidas como true Nenhum

Aplica-se a

Confira também