MatrixAnimationUsingPath.IsAdditive Proprietà

Definizione

Spazio dei nomi:

System.Windows.Media.Animation

Assembly:

PresentationCore.dll

Ottiene o imposta un valore che indica se il valore corrente della proprietà di destinazione deve essere aggiunto al valore iniziale dell'animazione.

public:
 property bool IsAdditive { bool get(); void set(bool value); };

public bool IsAdditive { get; set; }

member this.IsAdditive : bool with get, set

Public Property IsAdditive As Boolean

Valore della proprietà

Boolean

true se il valore corrente della proprietà di destinazione deve essere aggiunto al valore iniziale dell'animazione; in caso contrario, false. Il valore predefinito è false.

Esempio

Nell'esempio seguente vengono usate due animazioni simili MatrixAnimationUsingPath per animare lo stesso rettangolo. La proprietà della IsAdditive prima animazione è impostata su false, quindi anima sempre il rettangolo da (0,0), il valore iniziale dell'animazione. La seconda animazione ha gli stessi valori di destinazione (le impostazioni PathGeometry sono identiche), ma la relativa IsAdditive proprietà è impostata su true; di conseguenza, anima il rettangolo da qualsiasi posizione in cui si trova quando viene applicata l'animazione.

<Page 
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"  
  xmlns:PresentationOptions="http://schemas.microsoft.com/winfx/2006/xaml/presentation/options" 
  xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
  mc:Ignorable="PresentationOptions">
  <StackPanel>
      
    <!-- The Rectangle that is animated across the screen by animating
         the MatrixTransform applied to the button. -->
    <Rectangle 
      Width="50" Height="20"
      Fill="Blue"
      HorizontalAlignment="Left"
      VerticalAlignment="Top">
      <Rectangle.RenderTransform>
        <MatrixTransform x:Name="myMatrixTransform">
          <MatrixTransform.Matrix >
            <Matrix OffsetX="10" OffsetY="100"/>
          </MatrixTransform.Matrix>
        </MatrixTransform>
      </Rectangle.RenderTransform>
    </Rectangle>
    
    <StackPanel Margin="0,200,0,0" Orientation="Horizontal">
    <Button Content="Animate with IsAdditive set to False"
      HorizontalAlignment="Left" Padding="5">
      <Button.Triggers>
        <EventTrigger RoutedEvent="Button.Click">
          <BeginStoryboard>
            <Storyboard>
            
              <!-- This animation always moves the 
                   rectangle back to (0,0). -->
              <MatrixAnimationUsingPath
                Storyboard.TargetName="myMatrixTransform"
                Storyboard.TargetProperty="Matrix"
                Duration="0:0:2" 
                DoesRotateWithTangent="True" 
                IsAdditive="False">
                <MatrixAnimationUsingPath.PathGeometry>
                  <PathGeometry 
                    Figures="M 0,0 C 35,0 135,0 160,100 180,190 285,200 310,100" />
                </MatrixAnimationUsingPath.PathGeometry>
              </MatrixAnimationUsingPath>
            </Storyboard>
          </BeginStoryboard>
        </EventTrigger>
      </Button.Triggers>   
    </Button>
    
     <Button Content="Animate with IsAdditive set to True"
      HorizontalAlignment="Left" 
      Padding="5">
      <Button.Triggers>
        <EventTrigger RoutedEvent="Button.Click">
          <BeginStoryboard>
            <Storyboard>
            
              <!-- This animation moves the rectangle from 
                   its current position. -->
              <MatrixAnimationUsingPath
                Storyboard.TargetName="myMatrixTransform"
                Storyboard.TargetProperty="Matrix"
                Duration="0:0:2" 
                DoesRotateWithTangent="True"
                IsAdditive="True">
                <MatrixAnimationUsingPath.PathGeometry>
                  <PathGeometry 
                    Figures="M 0,0 C 35,0 135,0 160,100 180,190 285,200 310,100" />
                </MatrixAnimationUsingPath.PathGeometry>
              </MatrixAnimationUsingPath>
            </Storyboard>
          </BeginStoryboard>
        </EventTrigger>
      </Button.Triggers>   
    </Button>   
    </StackPanel>
    
    
  </StackPanel>
</Page>

Commenti

Informazioni proprietà di dipendenza

Campo Identificatore	IsAdditiveProperty
Proprietà dei metadati impostate su true	Nessuno

Nota

Questa proprietà di dipendenza è insolita perché il campo dell'identificatore proviene da AnimationTimeline ed è condiviso da varie classi derivate.