TextElement.TextEffects Propriedade

Definição

Namespace:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Obtém ou define uma coleção de efeitos de texto a serem aplicados ao conteúdo do elemento.

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

Valor da propriedade

TextEffectCollection

Uma coleção de efeitos de texto a serem aplicados ao conteúdo neste elemento. O padrão é null (não uma coleção vazia).

Exemplos

O exemplo a seguir mostra como criar um efeito de texto simples e aplicá-lo a um texto Run por meio da TextEffects propriedade.

// 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)

Comentários

Por padrão, essa propriedade é definida null como e não tem nenhuma TextEffectCollection associação a ela. Antes de adicionar efeitos de texto, crie um novo TextEffectCollection e atribua-o a essa propriedade.

Informações da propriedade de dependência

Campo Identificador	TextEffectsProperty
Propriedades de metadados definidas como true	AffectsRender