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