TextBlock.TextEffects Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets the effects to apply to the text content in this element.
public:
property System::Windows::Media::TextEffectCollection ^ TextEffects { System::Windows::Media::TextEffectCollection ^ get(); void set(System::Windows::Media::TextEffectCollection ^ value); };
public System.Windows.Media.TextEffectCollection TextEffects { get; set; }
member this.TextEffects : System.Windows.Media.TextEffectCollection with get, set
Public Property TextEffects As TextEffectCollection
Property Value
A TextEffectCollection containing one or more TextEffect objects that define effects to apply to the text of the TextBlock. The default is null
(no effects applied).
Examples
The following example shows how to create a simple text effect and apply it to a text of a TextBlock.
// Create and configure a simple color animation sequence. Timespan is in 100ns ticks.
ColorAnimation blackToWhite = new ColorAnimation(Colors.White, Colors.Black, new Duration(new TimeSpan(100000)));
blackToWhite.AutoReverse = true;
blackToWhite.RepeatBehavior = RepeatBehavior.Forever;
// Create a new brush and apply the color animation.
SolidColorBrush scb = new SolidColorBrush(Colors.Black);
scb.BeginAnimation(SolidColorBrush.ColorProperty, blackToWhite);
// Create a new TextEffect object; set foreground brush to the previously created brush.
TextEffect tfe = new TextEffect();
tfe.Foreground = scb;
// Range of text to apply effect to (all).
tfe.PositionStart = 0;
tfe.PositionCount = int.MaxValue;
// Create a new TextBlock with some text.
TextBlock textBlock = new TextBlock();
textBlock.Text = "Text that flickers...";
// The TextEffects property is null (no collection) by default. Create a new one.
textBlock.TextEffects = new TextEffectCollection();
// Add the previously created effect to the TextEffects collection.
textBlock.TextEffects.Add(tfe);
' Create and configure a simple color animation sequence. Timespan is in 100ns ticks.
Dim blackToWhite As New ColorAnimation(Colors.White, Colors.Black, New Duration(New TimeSpan(100000)))
blackToWhite.AutoReverse = True
blackToWhite.RepeatBehavior = RepeatBehavior.Forever
' Create a new brush and apply the color animation.
Dim scb As New SolidColorBrush(Colors.Black)
scb.BeginAnimation(SolidColorBrush.ColorProperty, blackToWhite)
' Create a new TextEffect object; set foreground brush to the previously created brush.
Dim tfe As New TextEffect()
tfe.Foreground = scb
' Range of text to apply effect to (all).
tfe.PositionStart = 0
tfe.PositionCount = Integer.MaxValue
' Create a new TextBlock with some text.
Dim textBlock As New TextBlock()
textBlock.Text = "Text that flickers..."
' The TextEffects property is null (no collection) by default. Create a new one.
textBlock.TextEffects = New TextEffectCollection()
' Add the previously created effect to the TextEffects collection.
textBlock.TextEffects.Add(tfe)
Remarks
By default, this property is set to null
and has no TextEffectCollection associated with it. Before adding any text effects, create a new TextEffectCollection and assign it to this property.
Dependency Property Information
Identifier field | TextEffectsProperty |
Metadata properties set to true |
AffectsRender |
Applies to
.NET
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기