TextBlock.TextEffects 屬性

定義

命名空間:

System.Windows.Controls

組件:

PresentationFramework.dll

取得或設定要套用至這個項目中文字內容的效果。

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

屬性值

TextEffectCollection

包含一個或多個 TextEffectCollection 物件的 TextEffect，這些物件用來定義要套用至 TextBlock 的文字的效果。 預設為 null (未套用任何效果)。

範例

下列範例示範如何建立簡單的文字效果，並將其套用至 的 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)

備註

根據預設，此屬性會設定為 null ，且沒有 TextEffectCollection 與其建立關聯的屬性。 新增任何文字效果之前，請先建立新的 TextEffectCollection ，並將它指派給這個屬性。

相依性屬性資訊

識別碼欄位	TextEffectsProperty
設定為 的中繼資料屬性 true	AffectsRender