Share via


DoubleAnimation.By Propriedade

Definição

Obtém ou define a quantidade total pela 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>

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

Comentários

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

A tabela a seguir resume como o , Toe By as Frompropriedades 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 From propriedade 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 From propriedade para o valor especificado pela To propriedade.
From e By A animação progride do valor especificado pela From propriedade para o valor especificado pela soma e From By pelas propriedades.
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 To propriedade.
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 By propriedade.

Observação

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

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

Uso do Atributo XAML

<Objeto By ="Double"/>

- ou -

<Objeto By ="{}"/>

Informações da propriedade de dependência

Campo identificador ByProperty
Propriedades de metadados definidas como true Nenhum

Aplica-se a

Confira também