TextBlock.TextEffects Eigenschaft

Definition

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Ruft die Effekte ab, die auf den Textinhalt in diesem Element angewendet werden sollen, oder legt diese fest.

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 TextEffectCollection mit mindestens einem TextEffect-Objekt, in dem Effekte definiert werden, die auf den Text des TextBlock angewendet werden sollen. Der Standardwert ist null (keine Effekte werden angewendet).

Beispiele

Das folgende Beispiel zeigt, wie Sie einen einfachen Texteffekt erstellen und ihn auf einen Text von anwenden 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)

Hinweise

Standardmäßig ist diese Eigenschaft auf null festgelegt und ist ihr nicht TextEffectCollection zugeordnet. Erstellen Sie vor dem Hinzufügen von Texteffekten eine neue TextEffectCollection , und weisen Sie es dieser Eigenschaft zu.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld	TextEffectsProperty
Metadateneigenschaften auf true festgelegt	AffectsRender