-
Notifications
You must be signed in to change notification settings - Fork 1.5k
/
SingleAnimation.xml
753 lines (697 loc) · 56.3 KB
/
SingleAnimation.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
<Type Name="SingleAnimation" FullName="System.Windows.Media.Animation.SingleAnimation">
<TypeSignature Language="C#" Value="public class SingleAnimation : System.Windows.Media.Animation.SingleAnimationBase" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi SingleAnimation extends System.Windows.Media.Animation.SingleAnimationBase" FrameworkAlternate="netframework-3.0;netframework-3.5;netframework-4.0;netframework-4.5;netframework-4.5.1;netframework-4.5.2;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8;netframework-4.8.1" />
<TypeSignature Language="DocId" Value="T:System.Windows.Media.Animation.SingleAnimation" />
<TypeSignature Language="VB.NET" Value="Public Class SingleAnimation
Inherits SingleAnimationBase" />
<TypeSignature Language="F#" Value="type SingleAnimation = class
 inherit SingleAnimationBase" />
<TypeSignature Language="C++ CLI" Value="public ref class SingleAnimation : System::Windows::Media::Animation::SingleAnimationBase" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit SingleAnimation extends System.Windows.Media.Animation.SingleAnimationBase" FrameworkAlternate="windowsdesktop-3.0;windowsdesktop-3.1;windowsdesktop-5.0;windowsdesktop-6.0;windowsdesktop-7.0;windowsdesktop-8.0;windowsdesktop-9.0" />
<AssemblyInfo>
<AssemblyName>PresentationCore</AssemblyName>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Windows.Media.Animation.SingleAnimationBase</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<summary>Animates the value of a <see cref="T:System.Single" /> property between two target values using linear interpolation over a specified <see cref="P:System.Windows.Media.Animation.Timeline.Duration" />.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
An animation updates the value of a property over a period of time. An animation effect can be subtle, such as moving a <xref:System.Windows.Shapes.Shape> a few pixels left and right, or dramatic, such as enlarging an object to 200 times its original size while spinning it and changing its color. To create an animation in Windows Presentation Foundation (WPF), you associate an animation with an object's property value.
## Target Values
The <xref:System.Windows.Media.Animation.SingleAnimation> class creates a transition between two target values. To set its target values, use its <xref:System.Windows.Media.Animation.SingleAnimation.From%2A>, <xref:System.Windows.Media.Animation.SingleAnimation.To%2A>, and <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> properties. The following table summarizes how the <xref:System.Windows.Media.Animation.SingleAnimation.From%2A>, <xref:System.Windows.Media.Animation.SingleAnimation.To%2A>, and <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> properties may be used together or separately to determine an animation's target values.
|Properties specified|Resulting behavior|
|--------------------------|------------------------|
|<xref:System.Windows.Media.Animation.SingleAnimation.From%2A>|The animation progresses from the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.From%2A> property to the base value of the property being animated or to a previous animation's output value, depending on how the previous animation is configured.|
|<xref:System.Windows.Media.Animation.SingleAnimation.From%2A> and <xref:System.Windows.Media.Animation.SingleAnimation.To%2A>|The animation progresses from the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.From%2A> property to the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.To%2A> property.|
|<xref:System.Windows.Media.Animation.SingleAnimation.From%2A> and <xref:System.Windows.Media.Animation.SingleAnimation.By%2A>|The animation progresses from the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.From%2A> property to the value specified by the sum of the <xref:System.Windows.Media.Animation.SingleAnimation.From%2A> and <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> properties.|
|<xref:System.Windows.Media.Animation.SingleAnimation.To%2A>|The animation progresses from the animated property's base value or a previous animation's output value to the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.To%2A> property.|
|<xref:System.Windows.Media.Animation.SingleAnimation.By%2A>|The animation progresses from the base value of the property being animated or a previous animation's output value to the sum of that value and the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> property.|
> [!NOTE]
> If you set both the <xref:System.Windows.Media.Animation.SingleAnimation.To%2A> and <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> properties, the <xref:System.Windows.Media.Animation.SingleAnimation.To%2A> property takes precedence and the <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> property is ignored.
To use other interpolation methods or animate between more than two target values, use a <xref:System.Windows.Media.Animation.SingleAnimationUsingKeyFrames> object.
For information about applying multiple animations to a single property, see [Key-Frame Animations Overview](/dotnet/framework/wpf/graphics-multimedia/key-frame-animations-overview).
## Freezable Features
Because the <xref:System.Windows.Media.Animation.SingleAnimation> class inherits from <xref:System.Windows.Freezable>, <xref:System.Windows.Media.Animation.SingleAnimation> objects gain several special features, which include the following: they can be declared as [resources](/dotnet/desktop-wpf/fundamentals/xaml-resources-define), shared among multiple objects, made read-only to improve performance, cloned, and made thread-safe. For more information about the different features provided by <xref:System.Windows.Freezable> objects, see the [Freezable Objects Overview](/dotnet/framework/wpf/advanced/freezable-objects-overview).
]]></format>
</remarks>
<altmember cref="T:System.Windows.Media.Animation.SingleAnimationUsingKeyFrames" />
<altmember cref="T:System.Windows.Freezable" />
</Docs>
<Members>
<MemberGroup MemberName=".ctor">
<AssemblyInfo>
<AssemblyName>PresentationCore</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Docs>
<summary>Initializes a new instance of the <see cref="T:System.Windows.Media.Animation.SingleAnimation" /> class.</summary>
</Docs>
</MemberGroup>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SingleAnimation ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberSignature Language="DocId" Value="M:System.Windows.Media.Animation.SingleAnimation.#ctor" />
<MemberSignature Language="VB.NET" Value="Public Sub New ()" />
<MemberSignature Language="C++ CLI" Value="public:
 SingleAnimation();" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyName>PresentationCore</AssemblyName>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute FrameworkAlternate="netframework-4.0">
<AttributeName Language="C#">[System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")]</AttributeName>
<AttributeName Language="F#">[<System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")>]</AttributeName>
</Attribute>
</Attributes>
<Parameters />
<Docs>
<summary>Initializes a new instance of the <see cref="T:System.Windows.Media.Animation.SingleAnimation" /> class.</summary>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SingleAnimation (float toValue, System.Windows.Duration duration);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(float32 toValue, valuetype System.Windows.Duration duration) cil managed" />
<MemberSignature Language="DocId" Value="M:System.Windows.Media.Animation.SingleAnimation.#ctor(System.Single,System.Windows.Duration)" />
<MemberSignature Language="VB.NET" Value="Public Sub New (toValue As Single, duration As Duration)" />
<MemberSignature Language="F#" Value="new System.Windows.Media.Animation.SingleAnimation : single * System.Windows.Duration -> System.Windows.Media.Animation.SingleAnimation" Usage="new System.Windows.Media.Animation.SingleAnimation (toValue, duration)" />
<MemberSignature Language="C++ CLI" Value="public:
 SingleAnimation(float toValue, System::Windows::Duration duration);" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyName>PresentationCore</AssemblyName>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="toValue" Type="System.Single" />
<Parameter Name="duration" Type="System.Windows.Duration" />
</Parameters>
<Docs>
<param name="toValue">The destination value of the animation.</param>
<param name="duration">The length of time the animation takes to play from start to finish, once. See the <see cref="P:System.Windows.Media.Animation.Timeline.Duration" /> property for more information.</param>
<summary>Initializes a new instance of the <see cref="T:System.Windows.Media.Animation.SingleAnimation" /> class that animates to the specified value over the specified duration. The starting value for the animation is the base value of the property being animated or the output from another animation.</summary>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SingleAnimation (float fromValue, float toValue, System.Windows.Duration duration);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(float32 fromValue, float32 toValue, valuetype System.Windows.Duration duration) cil managed" />
<MemberSignature Language="DocId" Value="M:System.Windows.Media.Animation.SingleAnimation.#ctor(System.Single,System.Single,System.Windows.Duration)" />
<MemberSignature Language="VB.NET" Value="Public Sub New (fromValue As Single, toValue As Single, duration As Duration)" />
<MemberSignature Language="F#" Value="new System.Windows.Media.Animation.SingleAnimation : single * single * System.Windows.Duration -> System.Windows.Media.Animation.SingleAnimation" Usage="new System.Windows.Media.Animation.SingleAnimation (fromValue, toValue, duration)" />
<MemberSignature Language="C++ CLI" Value="public:
 SingleAnimation(float fromValue, float toValue, System::Windows::Duration duration);" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyName>PresentationCore</AssemblyName>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="fromValue" Type="System.Single" />
<Parameter Name="toValue" Type="System.Single" />
<Parameter Name="duration" Type="System.Windows.Duration" />
</Parameters>
<Docs>
<param name="fromValue">The starting value of the animation.</param>
<param name="toValue">The destination value of the animation.</param>
<param name="duration">The length of time the animation takes to play from start to finish, once. See the <see cref="P:System.Windows.Media.Animation.Timeline.Duration" /> property for more information.</param>
<summary>Initializes a new instance of the <see cref="T:System.Windows.Media.Animation.SingleAnimation" /> class that animates from the specified starting value to the specified destination value over the specified duration.</summary>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SingleAnimation (float toValue, System.Windows.Duration duration, System.Windows.Media.Animation.FillBehavior fillBehavior);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(float32 toValue, valuetype System.Windows.Duration duration, valuetype System.Windows.Media.Animation.FillBehavior fillBehavior) cil managed" />
<MemberSignature Language="DocId" Value="M:System.Windows.Media.Animation.SingleAnimation.#ctor(System.Single,System.Windows.Duration,System.Windows.Media.Animation.FillBehavior)" />
<MemberSignature Language="VB.NET" Value="Public Sub New (toValue As Single, duration As Duration, fillBehavior As FillBehavior)" />
<MemberSignature Language="F#" Value="new System.Windows.Media.Animation.SingleAnimation : single * System.Windows.Duration * System.Windows.Media.Animation.FillBehavior -> System.Windows.Media.Animation.SingleAnimation" Usage="new System.Windows.Media.Animation.SingleAnimation (toValue, duration, fillBehavior)" />
<MemberSignature Language="C++ CLI" Value="public:
 SingleAnimation(float toValue, System::Windows::Duration duration, System::Windows::Media::Animation::FillBehavior fillBehavior);" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyName>PresentationCore</AssemblyName>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="toValue" Type="System.Single" />
<Parameter Name="duration" Type="System.Windows.Duration" />
<Parameter Name="fillBehavior" Type="System.Windows.Media.Animation.FillBehavior" />
</Parameters>
<Docs>
<param name="toValue">The destination value of the animation.</param>
<param name="duration">The length of time the animation takes to play from start to finish, once. See the <see cref="P:System.Windows.Media.Animation.Timeline.Duration" /> property for more information.</param>
<param name="fillBehavior">Specifies how the animation behaves when it is not active.</param>
<summary>Initializes a new instance of the <see cref="T:System.Windows.Media.Animation.SingleAnimation" /> class that animates to the specified value over the specified duration and has the specified fill behavior. The starting value for the animation is the base value of the property being animated or the output from another animation.</summary>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public SingleAnimation (float fromValue, float toValue, System.Windows.Duration duration, System.Windows.Media.Animation.FillBehavior fillBehavior);" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor(float32 fromValue, float32 toValue, valuetype System.Windows.Duration duration, valuetype System.Windows.Media.Animation.FillBehavior fillBehavior) cil managed" />
<MemberSignature Language="DocId" Value="M:System.Windows.Media.Animation.SingleAnimation.#ctor(System.Single,System.Single,System.Windows.Duration,System.Windows.Media.Animation.FillBehavior)" />
<MemberSignature Language="VB.NET" Value="Public Sub New (fromValue As Single, toValue As Single, duration As Duration, fillBehavior As FillBehavior)" />
<MemberSignature Language="F#" Value="new System.Windows.Media.Animation.SingleAnimation : single * single * System.Windows.Duration * System.Windows.Media.Animation.FillBehavior -> System.Windows.Media.Animation.SingleAnimation" Usage="new System.Windows.Media.Animation.SingleAnimation (fromValue, toValue, duration, fillBehavior)" />
<MemberSignature Language="C++ CLI" Value="public:
 SingleAnimation(float fromValue, float toValue, System::Windows::Duration duration, System::Windows::Media::Animation::FillBehavior fillBehavior);" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyName>PresentationCore</AssemblyName>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Parameters>
<Parameter Name="fromValue" Type="System.Single" />
<Parameter Name="toValue" Type="System.Single" />
<Parameter Name="duration" Type="System.Windows.Duration" />
<Parameter Name="fillBehavior" Type="System.Windows.Media.Animation.FillBehavior" />
</Parameters>
<Docs>
<param name="fromValue">The starting value of the animation.</param>
<param name="toValue">The destination value of the animation.</param>
<param name="duration">The length of time the animation takes to play from start to finish, once. See the <see cref="P:System.Windows.Media.Animation.Timeline.Duration" /> property for more information.</param>
<param name="fillBehavior">Specifies how the animation behaves when it is not active.</param>
<summary>Initializes a new instance of the <see cref="T:System.Windows.Media.Animation.SingleAnimation" /> class that animates from the specified starting value to the specified destination value over the specified duration and has the specified fill behavior.</summary>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName="By">
<MemberSignature Language="C#" Value="public float? By { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance valuetype System.Nullable`1<float32> By" />
<MemberSignature Language="DocId" Value="P:System.Windows.Media.Animation.SingleAnimation.By" />
<MemberSignature Language="VB.NET" Value="Public Property By As Nullable(Of Single)" />
<MemberSignature Language="F#" Value="member this.By : Nullable<single> with get, set" Usage="System.Windows.Media.Animation.SingleAnimation.By" />
<MemberSignature Language="C++ CLI" Value="public:
 property Nullable<float> By { Nullable<float> get(); void set(Nullable<float> value); };" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyName>PresentationCore</AssemblyName>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Nullable<System.Single></ReturnType>
</ReturnValue>
<Docs>
<summary>Gets or sets the total amount by which the animation changes its starting value.</summary>
<value>The total amount by which the animation changes its starting value. The default value is <see langword="null" />.</value>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
Use the <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> property when you want to animate a value "by" a certain amount, rather than specifying a starting or ending value. You may also use the <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> property with the <xref:System.Windows.Media.Animation.SingleAnimation.From%2A> property. The following table summarizes how the <xref:System.Windows.Media.Animation.SingleAnimation.From%2A>, <xref:System.Windows.Media.Animation.SingleAnimation.To%2A>, and <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> properties may be used together or separately to determine an animation's target values.
|Properties Specified|Resulting Behavior|
|--------------------------|------------------------|
|<xref:System.Windows.Media.Animation.SingleAnimation.From%2A>|The animation progresses from the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.From%2A> property to the base value of the property being animated or to a previous animation's output value, depending on how the previous animation is configured.|
|<xref:System.Windows.Media.Animation.SingleAnimation.From%2A> and <xref:System.Windows.Media.Animation.SingleAnimation.To%2A>|The animation progresses from the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.From%2A> property to the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.To%2A> property.|
|<xref:System.Windows.Media.Animation.SingleAnimation.From%2A> and <xref:System.Windows.Media.Animation.SingleAnimation.By%2A>|The animation progresses from the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.From%2A> property to the value specified by the sum of the <xref:System.Windows.Media.Animation.SingleAnimation.From%2A> and <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> properties.|
|<xref:System.Windows.Media.Animation.SingleAnimation.To%2A>|The animation progresses from the animated property's base value or a previous animation's output value to the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.To%2A> property.|
|<xref:System.Windows.Media.Animation.SingleAnimation.By%2A>|The animation progresses from the base value of the property being animated or a previous animation's output value to the sum of that value and the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> property.|
**Note** If you set both the <xref:System.Windows.Media.Animation.SingleAnimation.To%2A> and <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> properties, the <xref:System.Windows.Media.Animation.SingleAnimation.To%2A> property takes precedence and the <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> property is ignored.
To use other interpolation methods or animate between more than two target values, use a <xref:System.Windows.Media.Animation.SingleAnimationUsingKeyFrames> object.
<a name="xamlAttributeUsage_By"></a>
## XAML Attribute Usage
<*object* `By`="<xref:System.Single>"/>
-or-
<*object* `By`="{[x:Null Markup Extension](/dotnet/framework/xaml-services/x-null-markup-extension)}"/>
<a name="dependencyPropertyInfo_By"></a>
## Dependency Property Information
|||
|-|-|
|Identifier field|<xref:System.Windows.Media.Animation.SingleAnimation.ByProperty>|
|Metadata properties set to `true`|None|
]]></format>
</remarks>
<altmember cref="P:System.Windows.Media.Animation.SingleAnimation.From" />
<altmember cref="P:System.Windows.Media.Animation.SingleAnimation.To" />
</Docs>
</Member>
<Member MemberName="ByProperty">
<MemberSignature Language="C#" Value="public static readonly System.Windows.DependencyProperty ByProperty;" />
<MemberSignature Language="ILAsm" Value=".field public static initonly class System.Windows.DependencyProperty ByProperty" />
<MemberSignature Language="DocId" Value="F:System.Windows.Media.Animation.SingleAnimation.ByProperty" />
<MemberSignature Language="VB.NET" Value="Public Shared ReadOnly ByProperty As DependencyProperty " />
<MemberSignature Language="F#" Value=" staticval mutable ByProperty : System.Windows.DependencyProperty" Usage="System.Windows.Media.Animation.SingleAnimation.ByProperty" />
<MemberSignature Language="C++ CLI" Value="public: static initonly System::Windows::DependencyProperty ^ ByProperty;" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyName>PresentationCore</AssemblyName>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Windows.DependencyProperty</ReturnType>
</ReturnValue>
<Docs>
<summary>Identifies the <see cref="P:System.Windows.Media.Animation.SingleAnimation.By" /> dependency property.</summary>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName="Clone">
<MemberSignature Language="C#" Value="public System.Windows.Media.Animation.SingleAnimation Clone ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig instance class System.Windows.Media.Animation.SingleAnimation Clone() cil managed" />
<MemberSignature Language="DocId" Value="M:System.Windows.Media.Animation.SingleAnimation.Clone" />
<MemberSignature Language="VB.NET" Value="Public Function Clone () As SingleAnimation" />
<MemberSignature Language="F#" Value="override this.Clone : unit -> System.Windows.Media.Animation.SingleAnimation" Usage="singleAnimation.Clone " />
<MemberSignature Language="C++ CLI" Value="public:
 System::Windows::Media::Animation::SingleAnimation ^ Clone();" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>PresentationCore</AssemblyName>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Windows.Media.Animation.SingleAnimation</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Creates a modifiable clone of this <see cref="T:System.Windows.Media.Animation.SingleAnimation" />, making deep copies of this object's values. When copying dependency properties, this method copies resource references and data bindings (but they might no longer resolve) but not animations or their current values.</summary>
<returns>A modifiable clone of the current object. The cloned object's <see cref="P:System.Windows.Freezable.IsFrozen" /> property will be <see langword="false" /> even if the source's <see cref="P:System.Windows.Freezable.IsFrozen" /> property was <see langword="true" />.</returns>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
This method is used to produce modifiable copies of frozen <xref:System.Windows.Freezable> objects (or any <xref:System.Windows.Freezable> object). For convenience, this method shadows the inherited version with a strongly typed implementation.
For more information, see <xref:System.Windows.Freezable.Clone%2A?displayProperty=nameWithType>.
]]></format>
</remarks>
</Docs>
</Member>
<Member MemberName="CreateInstanceCore">
<MemberSignature Language="C#" Value="protected override System.Windows.Freezable CreateInstanceCore ();" />
<MemberSignature Language="ILAsm" Value=".method familyhidebysig virtual instance class System.Windows.Freezable CreateInstanceCore() cil managed" />
<MemberSignature Language="DocId" Value="M:System.Windows.Media.Animation.SingleAnimation.CreateInstanceCore" />
<MemberSignature Language="VB.NET" Value="Protected Overrides Function CreateInstanceCore () As Freezable" />
<MemberSignature Language="F#" Value="override this.CreateInstanceCore : unit -> System.Windows.Freezable" Usage="singleAnimation.CreateInstanceCore " />
<MemberSignature Language="C++ CLI" Value="protected:
 override System::Windows::Freezable ^ CreateInstanceCore();" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>PresentationCore</AssemblyName>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Windows.Freezable</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Creates a new instance of the <see cref="T:System.Windows.Media.Animation.PointAnimationUsingKeyFrames" />.</summary>
<returns>The new instance.</returns>
<remarks>To be added.</remarks>
<altmember cref="M:System.Windows.Freezable.CreateInstanceCore" />
</Docs>
</Member>
<Member MemberName="EasingFunction">
<MemberSignature Language="C#" Value="public System.Windows.Media.Animation.IEasingFunction EasingFunction { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance class System.Windows.Media.Animation.IEasingFunction EasingFunction" />
<MemberSignature Language="DocId" Value="P:System.Windows.Media.Animation.SingleAnimation.EasingFunction" />
<MemberSignature Language="VB.NET" Value="Public Property EasingFunction As IEasingFunction" />
<MemberSignature Language="F#" Value="member this.EasingFunction : System.Windows.Media.Animation.IEasingFunction with get, set" Usage="System.Windows.Media.Animation.SingleAnimation.EasingFunction" />
<MemberSignature Language="C++ CLI" Value="public:
 property System::Windows::Media::Animation::IEasingFunction ^ EasingFunction { System::Windows::Media::Animation::IEasingFunction ^ get(); void set(System::Windows::Media::Animation::IEasingFunction ^ value); };" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyName>PresentationCore</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Windows.Media.Animation.IEasingFunction</ReturnType>
</ReturnValue>
<Docs>
<summary>Gets or sets the easing function applied to this animation.</summary>
<value>The easing function applied to this animation.</value>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
Easing functions allow you to create a variety of specialized animation effects including bouncing, spring oscillations, and various magnitude acceleration and deceleration animations.
]]></format>
</remarks>
<altmember cref="T:System.Windows.Media.Animation.IEasingFunction" />
</Docs>
</Member>
<Member MemberName="EasingFunctionProperty">
<MemberSignature Language="C#" Value="public static readonly System.Windows.DependencyProperty EasingFunctionProperty;" />
<MemberSignature Language="ILAsm" Value=".field public static initonly class System.Windows.DependencyProperty EasingFunctionProperty" />
<MemberSignature Language="DocId" Value="F:System.Windows.Media.Animation.SingleAnimation.EasingFunctionProperty" />
<MemberSignature Language="VB.NET" Value="Public Shared ReadOnly EasingFunctionProperty As DependencyProperty " />
<MemberSignature Language="F#" Value=" staticval mutable EasingFunctionProperty : System.Windows.DependencyProperty" Usage="System.Windows.Media.Animation.SingleAnimation.EasingFunctionProperty" />
<MemberSignature Language="C++ CLI" Value="public: static initonly System::Windows::DependencyProperty ^ EasingFunctionProperty;" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyName>PresentationCore</AssemblyName>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Windows.DependencyProperty</ReturnType>
</ReturnValue>
<Docs>
<summary>Identifies the <see cref="P:System.Windows.Media.Animation.SingleAnimation.EasingFunction" /> dependency property.</summary>
<remarks>To be added.</remarks>
<altmember cref="T:System.Windows.Media.Animation.IEasingFunction" />
</Docs>
</Member>
<Member MemberName="From">
<MemberSignature Language="C#" Value="public float? From { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance valuetype System.Nullable`1<float32> From" />
<MemberSignature Language="DocId" Value="P:System.Windows.Media.Animation.SingleAnimation.From" />
<MemberSignature Language="VB.NET" Value="Public Property From As Nullable(Of Single)" />
<MemberSignature Language="F#" Value="member this.From : Nullable<single> with get, set" Usage="System.Windows.Media.Animation.SingleAnimation.From" />
<MemberSignature Language="C++ CLI" Value="public:
 property Nullable<float> From { Nullable<float> get(); void set(Nullable<float> value); };" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyName>PresentationCore</AssemblyName>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Nullable<System.Single></ReturnType>
</ReturnValue>
<Docs>
<summary>Gets or sets the animation's starting value.</summary>
<value>The starting value of the animation. The default value is **null**.</value>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
The following table summarizes how the <xref:System.Windows.Media.Animation.SingleAnimation.From%2A>, <xref:System.Windows.Media.Animation.SingleAnimation.To%2A>, and <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> properties may be used together or separately to determine an animation's target values.
|Properties Specified|Resulting Behavior|
|--------------------------|------------------------|
|<xref:System.Windows.Media.Animation.SingleAnimation.From%2A>|The animation progresses from the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.From%2A> property to the base value of the property being animated or to a previous animation's output value, depending on how the previous animation is configured.|
|<xref:System.Windows.Media.Animation.SingleAnimation.From%2A> and <xref:System.Windows.Media.Animation.SingleAnimation.To%2A>|The animation progresses from the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.From%2A> property to the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.To%2A> property.|
|<xref:System.Windows.Media.Animation.SingleAnimation.From%2A> and <xref:System.Windows.Media.Animation.SingleAnimation.By%2A>|The animation progresses from the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.From%2A> property to the value specified by the sum of the <xref:System.Windows.Media.Animation.SingleAnimation.From%2A> and <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> properties.|
|<xref:System.Windows.Media.Animation.SingleAnimation.To%2A>|The animation progresses from the animated property's base value or a previous animation's output value to the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.To%2A> property.|
|<xref:System.Windows.Media.Animation.SingleAnimation.By%2A>|The animation progresses from the base value of the property being animated or a previous animation's output value to the sum of that value and the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> property.|
**Note** If you set both the <xref:System.Windows.Media.Animation.SingleAnimation.To%2A> and <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> properties, the <xref:System.Windows.Media.Animation.SingleAnimation.To%2A> property takes precedence and the <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> property is ignored.
To use other interpolation methods or animate between more than two target values, use a <xref:System.Windows.Media.Animation.SingleAnimationUsingKeyFrames> object.
<a name="xamlAttributeUsage_From"></a>
## XAML Attribute Usage
<*object* `From`="<xref:System.Single>"/>
-or-
<*object* `From`="{[x:Null Markup Extension](/dotnet/framework/xaml-services/x-null-markup-extension)}"/>
<a name="dependencyPropertyInfo_From"></a>
## Dependency Property Information
|||
|-|-|
|Identifier Field|<xref:System.Windows.Media.Animation.SingleAnimation.FromProperty>|
|Metadata properties set to `true`|None|
]]></format>
</remarks>
</Docs>
</Member>
<Member MemberName="FromProperty">
<MemberSignature Language="C#" Value="public static readonly System.Windows.DependencyProperty FromProperty;" />
<MemberSignature Language="ILAsm" Value=".field public static initonly class System.Windows.DependencyProperty FromProperty" />
<MemberSignature Language="DocId" Value="F:System.Windows.Media.Animation.SingleAnimation.FromProperty" />
<MemberSignature Language="VB.NET" Value="Public Shared ReadOnly FromProperty As DependencyProperty " />
<MemberSignature Language="F#" Value=" staticval mutable FromProperty : System.Windows.DependencyProperty" Usage="System.Windows.Media.Animation.SingleAnimation.FromProperty" />
<MemberSignature Language="C++ CLI" Value="public: static initonly System::Windows::DependencyProperty ^ FromProperty;" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyName>PresentationCore</AssemblyName>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Windows.DependencyProperty</ReturnType>
</ReturnValue>
<Docs>
<summary>Identifies the <see cref="P:System.Windows.Media.Animation.SingleAnimation.From" /> dependency property.</summary>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName="GetCurrentValueCore">
<MemberSignature Language="C#" Value="protected override float GetCurrentValueCore (float defaultOriginValue, float defaultDestinationValue, System.Windows.Media.Animation.AnimationClock animationClock);" />
<MemberSignature Language="ILAsm" Value=".method familyhidebysig virtual instance float32 GetCurrentValueCore(float32 defaultOriginValue, float32 defaultDestinationValue, class System.Windows.Media.Animation.AnimationClock animationClock) cil managed" />
<MemberSignature Language="DocId" Value="M:System.Windows.Media.Animation.SingleAnimation.GetCurrentValueCore(System.Single,System.Single,System.Windows.Media.Animation.AnimationClock)" />
<MemberSignature Language="VB.NET" Value="Protected Overrides Function GetCurrentValueCore (defaultOriginValue As Single, defaultDestinationValue As Single, animationClock As AnimationClock) As Single" />
<MemberSignature Language="F#" Value="override this.GetCurrentValueCore : single * single * System.Windows.Media.Animation.AnimationClock -> single" Usage="singleAnimation.GetCurrentValueCore (defaultOriginValue, defaultDestinationValue, animationClock)" />
<MemberSignature Language="C++ CLI" Value="protected:
 override float GetCurrentValueCore(float defaultOriginValue, float defaultDestinationValue, System::Windows::Media::Animation::AnimationClock ^ animationClock);" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>PresentationCore</AssemblyName>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Single</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="defaultOriginValue" Type="System.Single" />
<Parameter Name="defaultDestinationValue" Type="System.Single" />
<Parameter Name="animationClock" Type="System.Windows.Media.Animation.AnimationClock" />
</Parameters>
<Docs>
<param name="defaultOriginValue">The suggested origin value, used if the animation does not have its own explicitly set start value.</param>
<param name="defaultDestinationValue">The suggested destination value, used if the animation does not have its own explicitly set end value.</param>
<param name="animationClock">An <see cref="T:System.Windows.Media.Animation.AnimationClock" /> that generates the <see cref="P:System.Windows.Media.Animation.Clock.CurrentTime" /> or <see cref="P:System.Windows.Media.Animation.Clock.CurrentProgress" /> used by the animation.</param>
<summary>Calculates a value that represents the current value of the property being animated, as determined by the <see cref="T:System.Windows.Media.Animation.SingleAnimation" />.</summary>
<returns>The calculated value of the property, as determined by the current animation.</returns>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
If the `defaultOriginValue` is the first in the composition chain, this value will be the snapshot value (if one is available) or the base property value; otherwise this value will be the value returned by the previous animation in the chain with an <xref:System.Windows.Media.Animation.AnimationClock> that is not <xref:System.Windows.Media.Animation.Clock.Stopped%2A>.
The `defaultDestinationValue` is the base value if the animation is in the first composition layer of animations on a property; otherwise the value is the output value from the previous composition layer of animations for the property.
]]></format>
</remarks>
<altmember cref="M:System.Windows.Media.Animation.SingleAnimationBase.GetCurrentValueCore(System.Single,System.Single,System.Windows.Media.Animation.AnimationClock)" />
</Docs>
</Member>
<Member MemberName="IsAdditive">
<MemberSignature Language="C#" Value="public bool IsAdditive { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool IsAdditive" />
<MemberSignature Language="DocId" Value="P:System.Windows.Media.Animation.SingleAnimation.IsAdditive" />
<MemberSignature Language="VB.NET" Value="Public Property IsAdditive As Boolean" />
<MemberSignature Language="F#" Value="member this.IsAdditive : bool with get, set" Usage="System.Windows.Media.Animation.SingleAnimation.IsAdditive" />
<MemberSignature Language="C++ CLI" Value="public:
 property bool IsAdditive { bool get(); void set(bool value); };" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyName>PresentationCore</AssemblyName>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<summary>Gets or sets a value that indicates whether the target property's current value should be added to this animation's starting value.</summary>
<value>
<see langword="true" /> if the target property's current value should be added to this animation's starting value; otherwise, <see langword="false" />. The default value is <see langword="false" />.</value>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
If the animation has only one of its <xref:System.Windows.Media.Animation.SingleAnimation.From%2A>, <xref:System.Windows.Media.Animation.SingleAnimation.To%2A>, or <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> properties set, setting this property has no effect.
<a name="dependencyPropertyInfo_Additive"></a>
## Dependency Property Information
|||
|-|-|
|Identifier field|<xref:System.Windows.Media.Animation.AnimationTimeline.IsAdditiveProperty>|
|Metadata properties set to `true`|None|
> [!NOTE]
> This dependency property is unusual in that the identifier field for it comes from <xref:System.Windows.Media.Animation.AnimationTimeline>, and is shared by various derived classes.
]]></format>
</remarks>
</Docs>
</Member>
<Member MemberName="IsCumulative">
<MemberSignature Language="C#" Value="public bool IsCumulative { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance bool IsCumulative" />
<MemberSignature Language="DocId" Value="P:System.Windows.Media.Animation.SingleAnimation.IsCumulative" />
<MemberSignature Language="VB.NET" Value="Public Property IsCumulative As Boolean" />
<MemberSignature Language="F#" Value="member this.IsCumulative : bool with get, set" Usage="System.Windows.Media.Animation.SingleAnimation.IsCumulative" />
<MemberSignature Language="C++ CLI" Value="public:
 property bool IsCumulative { bool get(); void set(bool value); };" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyName>PresentationCore</AssemblyName>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<summary>Gets or sets a value that specifies whether the animation's value accumulates when it repeats.</summary>
<value>
<see langword="true" /> if the animation accumulates its values when its <see cref="P:System.Windows.Media.Animation.Timeline.RepeatBehavior" /> property causes it to repeat its simple duration. otherwise, <see langword="false" />. The default value is <see langword="false" />.</value>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
When this property is set to `true`, the animation's output values only accumulate when the animation's <xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A> property causes it to repeat its simple duration. It does not accumulate its values when it restarts because its parent repeated or because its clock was restarted from a <xref:System.Windows.Media.Animation.ClockController.Begin%2A> call.
<a name="dependencyPropertyInfo_Cumulative"></a>
## Dependency Property Information
|||
|-|-|
|Identifier field|<xref:System.Windows.Media.Animation.AnimationTimeline.IsCumulativeProperty>|
|Metadata properties set to `true`|None|
> [!NOTE]
> This dependency property is unusual in that the identifier field for it comes from <xref:System.Windows.Media.Animation.AnimationTimeline>, and is shared by various derived classes.
]]></format>
</remarks>
<altmember cref="P:System.Windows.Media.Animation.Timeline.RepeatBehavior" />
</Docs>
</Member>
<Member MemberName="To">
<MemberSignature Language="C#" Value="public float? To { get; set; }" />
<MemberSignature Language="ILAsm" Value=".property instance valuetype System.Nullable`1<float32> To" />
<MemberSignature Language="DocId" Value="P:System.Windows.Media.Animation.SingleAnimation.To" />
<MemberSignature Language="VB.NET" Value="Public Property To As Nullable(Of Single)" />
<MemberSignature Language="F#" Value="member this.To : Nullable<single> with get, set" Usage="System.Windows.Media.Animation.SingleAnimation.To" />
<MemberSignature Language="C++ CLI" Value="public:
 property Nullable<float> To { Nullable<float> get(); void set(Nullable<float> value); };" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyName>PresentationCore</AssemblyName>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Nullable<System.Single></ReturnType>
</ReturnValue>
<Docs>
<summary>Gets or sets the animation's ending value.</summary>
<value>The ending value of the animation. The default value is null.</value>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
The following table summarizes how the <xref:System.Windows.Media.Animation.SingleAnimation.From%2A>, <xref:System.Windows.Media.Animation.SingleAnimation.To%2A>, and <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> properties may be used together or separately to determine an animation's target values.
|Properties Specified|Resulting Behavior|
|--------------------------|------------------------|
|<xref:System.Windows.Media.Animation.SingleAnimation.From%2A>|The animation progresses from the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.From%2A> property to the base value of the property being animated or to a previous animation's output value, depending on how the previous animation is configured.|
|<xref:System.Windows.Media.Animation.SingleAnimation.From%2A> and <xref:System.Windows.Media.Animation.SingleAnimation.To%2A>|The animation progresses from the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.From%2A> property to the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.To%2A> property.|
|<xref:System.Windows.Media.Animation.SingleAnimation.From%2A> and <xref:System.Windows.Media.Animation.SingleAnimation.By%2A>|The animation progresses from the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.From%2A> property to the value specified by the sum of the <xref:System.Windows.Media.Animation.SingleAnimation.From%2A> and <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> properties.|
|<xref:System.Windows.Media.Animation.SingleAnimation.To%2A>|The animation progresses from the animated property's base value or a previous animation's output value to the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.To%2A> property.|
|<xref:System.Windows.Media.Animation.SingleAnimation.By%2A>|The animation progresses from the base value of the property being animated or a previous animation's output value to the sum of that value and the value specified by the <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> property.|
**Note** If you set both the <xref:System.Windows.Media.Animation.SingleAnimation.To%2A> and <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> properties, the <xref:System.Windows.Media.Animation.SingleAnimation.To%2A> property takes precedence and the <xref:System.Windows.Media.Animation.SingleAnimation.By%2A> property is ignored.
To use other interpolation methods or animate between more than two target values, use a <xref:System.Windows.Media.Animation.SingleAnimationUsingKeyFrames> object.
<a name="xamlAttributeUsage_To"></a>
## XAML Attribute Usage
<*object* `To`="<xref:System.Single>"/>
-or-
<*object* `To`="{[x:Null Markup Extension](/dotnet/framework/xaml-services/x-null-markup-extension)}"/>
<a name="dependencyPropertyInfo_To"></a>
## Dependency Property Information
|||
|-|-|
|Identifier field|<xref:System.Windows.Media.Animation.SingleAnimation.ToProperty>|
|Metadata properties set to `true`|None|
]]></format>
</remarks>
<altmember cref="P:System.Windows.Media.Animation.SingleAnimation.From" />
<altmember cref="P:System.Windows.Media.Animation.SingleAnimation.By" />
</Docs>
</Member>
<Member MemberName="ToProperty">
<MemberSignature Language="C#" Value="public static readonly System.Windows.DependencyProperty ToProperty;" />
<MemberSignature Language="ILAsm" Value=".field public static initonly class System.Windows.DependencyProperty ToProperty" />
<MemberSignature Language="DocId" Value="F:System.Windows.Media.Animation.SingleAnimation.ToProperty" />
<MemberSignature Language="VB.NET" Value="Public Shared ReadOnly ToProperty As DependencyProperty " />
<MemberSignature Language="F#" Value=" staticval mutable ToProperty : System.Windows.DependencyProperty" Usage="System.Windows.Media.Animation.SingleAnimation.ToProperty" />
<MemberSignature Language="C++ CLI" Value="public: static initonly System::Windows::DependencyProperty ^ ToProperty;" />
<MemberType>Field</MemberType>
<AssemblyInfo>
<AssemblyName>PresentationCore</AssemblyName>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>4.0.0.0</AssemblyVersion>
<AssemblyVersion>5.0.0.0</AssemblyVersion>
<AssemblyVersion>6.0.0.0</AssemblyVersion>
<AssemblyVersion>7.0.0.0</AssemblyVersion>
<AssemblyVersion>8.0.0.0</AssemblyVersion>
<AssemblyVersion>9.0.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Windows.DependencyProperty</ReturnType>
</ReturnValue>
<Docs>
<summary>Identifies the <see cref="P:System.Windows.Media.Animation.SingleAnimation.To" /> dependency property.</summary>
<remarks>To be added.</remarks>
</Docs>
</Member>
</Members>
</Type>