TextEffect 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示可应用于文本对象的文本效果。
public ref class TextEffect sealed : System::Windows::Media::Animation::Animatable[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public sealed class TextEffect : System.Windows.Media.Animation.Animatable[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
type TextEffect = class
inherit AnimatablePublic NotInheritable Class TextEffect
Inherits Animatable- 继承
- 属性
示例
下面的示例演示发生旋转的单个字符。 每个字符都将以 1 秒为间隔单独旋转。 示例 定义一个 TextEffect ，其中包含 RotateTransform 应用于 属性中每个字符的 TextBlock.Text 。 该示例定义 对象的 和 CenterX 属性的RotateTransform动画Angle。 类型的第三个动画 Int32AnimationUsingKeyFrames 在动画序列期间将 PositionStart 属性从 0 更改为 12，对应于 13 个字符的文本字符串。
Example of a rotating text effect animation
<TextBlock
FontSize="60"
Margin="50">
Windows Vista
<TextBlock.TextEffects>
<!-- The TextEffect to animate. -->
<TextEffect PositionCount="1" x:Name="MyTextEffect">
<TextEffect.Transform>
<RotateTransform x:Name="TextEffectRotateTransform"
Angle="0" CenterX="10" CenterY="10" />
</TextEffect.Transform>
</TextEffect>
</TextBlock.TextEffects>
<TextBlock.Triggers>
<EventTrigger RoutedEvent="TextBlock.Loaded">
<EventTrigger.Actions>
<BeginStoryboard>
<Storyboard>
<ParallelTimeline RepeatBehavior="Forever">
<!-- Animates the angle of the RotateTransform
applied to the TextEffect. -->
<DoubleAnimation
Storyboard.TargetName="TextEffectRotateTransform"
Storyboard.TargetProperty="Angle"
From="0"
To="360"
Duration="00:00:0.75"
BeginTime="0:0:0.25" />
</ParallelTimeline>
<!-- Animates the horizontal center of the RotateTransform
applied to the TextEffect. -->
<DoubleAnimation
From="30"
To="370"
Duration="00:00:13"
RepeatBehavior="Forever"
AutoReverse="True"
Storyboard.TargetName="TextEffectRotateTransform"
Storyboard.TargetProperty="CenterX" />
<!-- Animates the position of the TextEffect. -->
<Int32AnimationUsingKeyFrames
Storyboard.TargetName="MyTextEffect"
Storyboard.TargetProperty="PositionStart"
Duration="0:0:13"
AutoReverse="True"
RepeatBehavior="Forever">
<Int32AnimationUsingKeyFrames.KeyFrames>
<DiscreteInt32KeyFrame Value="0" KeyTime="0:0:0" />
<DiscreteInt32KeyFrame Value="1" KeyTime="0:0:1" />
<DiscreteInt32KeyFrame Value="2" KeyTime="0:0:2" />
<DiscreteInt32KeyFrame Value="3" KeyTime="0:0:3" />
<DiscreteInt32KeyFrame Value="4" KeyTime="0:0:4" />
<DiscreteInt32KeyFrame Value="5" KeyTime="0:0:5" />
<DiscreteInt32KeyFrame Value="6" KeyTime="0:0:6" />
<DiscreteInt32KeyFrame Value="7" KeyTime="0:0:7" />
<DiscreteInt32KeyFrame Value="8" KeyTime="0:0:8" />
<DiscreteInt32KeyFrame Value="9" KeyTime="0:0:9" />
<DiscreteInt32KeyFrame Value="10" KeyTime="0:0:10" />
<DiscreteInt32KeyFrame Value="11" KeyTime="0:0:11" />
<DiscreteInt32KeyFrame Value="12" KeyTime="0:0:12" />
</Int32AnimationUsingKeyFrames.KeyFrames>
</Int32AnimationUsingKeyFrames>
</Storyboard>
</BeginStoryboard>
</EventTrigger.Actions>
</EventTrigger>
</TextBlock.Triggers>
</TextBlock>
注解
对象TextEffect允许向文本对象（如 、 TextElement和 FlowDocument 对象）添加效果（如TextBlock动画）。
构造函数
| TextEffect() |
初始化 TextEffect 类的新实例。 |
| TextEffect(Transform, Brush, Geometry, Int32, Int32) |
通过指定类属性值来初始化 TextEffect 类的新实例。 |
字段
| ClipProperty |
标识 Clip 依赖项属性。 |
| ForegroundProperty |
标识 Foreground 依赖项属性。 |
| PositionCountProperty |
标识 PositionCount 依赖项属性。 |
| PositionStartProperty |
标识 PositionStart 依赖项属性。 |
| TransformProperty |
标识 Transform 依赖项属性。 |
属性
| CanFreeze |
获取一个值，该值指示是否可将对象变为不可修改。 (继承自 Freezable) |
| Clip |
获取或设置 TextEffect 的剪辑区域。 |
| DependencyObjectType |
获取 DependencyObjectType 包装此实例的 CLR 类型的 。 (继承自 DependencyObject) |
| Dispatcher |
获取与此 Dispatcher 关联的 DispatcherObject。 (继承自 DispatcherObject) |
| Foreground |
获取或设置要应用于 Brush 的内容的 TextEffect。 |
| HasAnimatedProperties |
获取一个值，该值指示一个或多个 AnimationClock 对象是否与此对象的任何依赖项属性相关联。 (继承自 Animatable) |
| IsFrozen |
获取一个值，该值指示对象当前是否可修改。 (继承自 Freezable) |
| IsSealed |
获取一个值，该值指示此实例当前是否为密封的（只读）。 (继承自 DependencyObject) |
| PositionCount |
获取或设置在文本中应用 TextEffect 的位置。 |
| PositionStart |
获取或设置在文本中应用 TextEffect 的开始位置。 |
| Transform |
获取或设置应用于 Transform 的 TextEffect。 |
方法
事件
| Changed |
在修改 Freezable 或其包含的对象时发生。 (继承自 Freezable) |
