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 可讓您將效果，例如動畫新增至文字物件，例如 TextBlock 、 TextElement 和 FlowDocument 物件。
建構函式
| 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) |
