Freigeben über


MatrixAnimationUsingPath.IsAdditive Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob der aktuelle Wert der Zieleigenschaft zum Anfangswert dieser Animation hinzugefügt werden soll, oder legt diesen Wert fest.

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

Eigenschaftswert

true, wenn der aktuelle Wert der Zieleigenschaft zum Anfangswert dieser Animation hinzugefügt werden soll, andernfalls false. Der Standardwert ist false.

Beispiele

Im folgenden Beispiel werden zwei ähnliche MatrixAnimationUsingPath Animationen verwendet, um dasselbe Rechteck zu animieren. Die Eigenschaft der IsAdditive ersten Animation ist auf falsefestgelegt, sodass das Rechteck immer von (0,0) animiert wird, dem Startwert der Animation. Die zweite Animation hat die gleichen Zielwerte (ihre PathGeometry Einstellungen sind identisch), ihre Eigenschaft ist jedoch IsAdditive auf truefestgelegt. Dadurch wird das Rechteck von der Position animiert, an der es sich befindet, wenn die Animation angewendet wird.

<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>

Hinweise

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld IsAdditiveProperty
Metadateneigenschaften auf true festgelegt Keine

Hinweis

Diese Abhängigkeitseigenschaft ist ungewöhnlich, da das Bezeichnerfeld dafür von AnimationTimeline verschiedenen abgeleiteten Klassen verwendet wird.

Gilt für: