TextElement.TextEffects Eigenschaft

Definition

Namespace:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Dient zum Abrufen oder Festlegen einer Auflistung von Texteffekten, die auf den Inhalt des Elements angewendet werden sollen.

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

Eigenschaftswert

TextEffectCollection

Eine Sammlung von Texteffekten, die auf den Inhalt in diesem Element angewendet werden sollen. Der Standardwert ist null (keine leere Auflistung).

Beispiele

Das folgende Beispiel zeigt, wie Sie einen einfachen Texteffekt erstellen und auf einen Text Run über die TextEffects Eigenschaft anwenden.

// 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 text run, and add the previously created text effect to the run's effects collection.
Run flickerRun = new Run("Text that flickers...");
flickerRun.TextEffects = new TextEffectCollection();
flickerRun.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 text run, and add the previously created text effect to the run's effects collection.
Dim flickerRun As New Run("Text that flickers...")
flickerRun.TextEffects = New TextEffectCollection()
flickerRun.TextEffects.Add(tfe)

Hinweise

Diese Eigenschaft ist standardmäßig auf diese Eigenschaft festgelegt null und hat keine TextEffectCollection Zuordnung. Erstellen Sie vor dem Hinzufügen von Texteffekten ein neues TextEffectCollection Element, und weisen Sie sie dieser Eigenschaft zu.

Informationen zur Abhängigkeitseigenschaft

Element	Wert
Bezeichnerfeld	TextEffectsProperty
Auf Metadateneigenschaften festgelegt true	AffectsRender