DoubleAnimation.By Propriedade

Definição

Namespace:

System.Windows.Media.Animation

Assembly:

PresentationCore.dll

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

Nullable<Double>

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

Confira também

• From
• To