Partilhar via


TextBlock.TextEffects Propriedade

Definição

Obtém ou define os efeitos a serem aplicados no conteúdo de texto neste 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 TextEffectCollection que contém um ou mais objetos TextEffect que definem os efeitos a serem aplicados ao texto do TextBlock. O padrão é null (sem efeitos aplicados).

Exemplos

O exemplo a seguir mostra como criar um efeito de texto simples e aplicá-lo a um texto de um 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)

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

Aplica-se a