TextEffect Osztály

Definíció

Névtér:

System.Windows.Media

Szerelvény:

PresentationCore.dll

Szöveges objektumra alkalmazható szövegeffektust jelöl.

public ref class TextEffect sealed : System::Windows::Media::Animation::Animatable

[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public sealed class TextEffect : System.Windows.Media.Animation.Animatable

[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
type TextEffect = class
    inherit Animatable

Public NotInheritable Class TextEffect
Inherits Animatable

Öröklődés

Object

DispatcherObject

DependencyObject

Freezable

Animatable

TextEffect

Attribútumok

LocalizabilityAttribute

Példák

Az alábbi példa egy egyéni karakter elforgatását mutatja be. Minden karakter egymástól függetlenül, 1 másodperces időközökkel van elforgatva. A példa egy olyan karaktert TextEffect határoz meg, amely RotateTransform a tulajdonság minden egyes karakterére TextBlock.Text érvényes. A példa az objektum animációit Angle és CenterX tulajdonságait RotateTransform határozza meg. Egy harmadik típusú Int32AnimationUsingKeyFrames animáció 0-ról 12-re módosítja a PositionStart tulajdonságot az animációs sorozat során, amely megfelel a 13 karakterből álló szöveges sztringnek.

              Example of a rotating text effect animation

<TextBlock 
  FontSize="60"
  Margin="50">
  Windows Vista

  <TextBlock.TextEffects>
    <!-- The TextEffect to animate. -->
    <TextEffect PositionCount="1" x:Name="MyTextEffect">
      <TextEffect.Transform>
        <RotateTransform x:Name="TextEffectRotateTransform" 
          Angle="0" CenterX="10" CenterY="10" />
      </TextEffect.Transform>
    </TextEffect>
  </TextBlock.TextEffects>

  <TextBlock.Triggers>
    <EventTrigger RoutedEvent="TextBlock.Loaded">
      <EventTrigger.Actions>
      <BeginStoryboard>
        <Storyboard>
          <ParallelTimeline RepeatBehavior="Forever">

            <!-- Animates the angle of the RotateTransform
                 applied to the TextEffect. -->
            <DoubleAnimation
              Storyboard.TargetName="TextEffectRotateTransform"
              Storyboard.TargetProperty="Angle" 
              From="0"
              To="360"
              Duration="00:00:0.75"                
              BeginTime="0:0:0.25" />
          </ParallelTimeline>

          <!-- Animates the horizontal center of the RotateTransform
               applied to the TextEffect. -->
          <DoubleAnimation
            From="30"
            To="370"
            Duration="00:00:13"
            RepeatBehavior="Forever"
            AutoReverse="True"
            Storyboard.TargetName="TextEffectRotateTransform"
            Storyboard.TargetProperty="CenterX" />

          <!-- Animates the position of the TextEffect. -->
          <Int32AnimationUsingKeyFrames
            Storyboard.TargetName="MyTextEffect"
            Storyboard.TargetProperty="PositionStart"
            Duration="0:0:13"
            AutoReverse="True"
            RepeatBehavior="Forever">
            <Int32AnimationUsingKeyFrames.KeyFrames>
              <DiscreteInt32KeyFrame Value="0" KeyTime="0:0:0" />
              <DiscreteInt32KeyFrame Value="1" KeyTime="0:0:1" />
              <DiscreteInt32KeyFrame Value="2" KeyTime="0:0:2" />
              <DiscreteInt32KeyFrame Value="3" KeyTime="0:0:3" />
              <DiscreteInt32KeyFrame Value="4" KeyTime="0:0:4" />
              <DiscreteInt32KeyFrame Value="5" KeyTime="0:0:5" />
              <DiscreteInt32KeyFrame Value="6" KeyTime="0:0:6" />
              <DiscreteInt32KeyFrame Value="7" KeyTime="0:0:7" />
              <DiscreteInt32KeyFrame Value="8" KeyTime="0:0:8" />
              <DiscreteInt32KeyFrame Value="9" KeyTime="0:0:9" />
              <DiscreteInt32KeyFrame Value="10" KeyTime="0:0:10" />
              <DiscreteInt32KeyFrame Value="11" KeyTime="0:0:11" />
              <DiscreteInt32KeyFrame Value="12" KeyTime="0:0:12" />
            </Int32AnimationUsingKeyFrames.KeyFrames>
          </Int32AnimationUsingKeyFrames>
        </Storyboard>
      </BeginStoryboard>
      </EventTrigger.Actions>
    </EventTrigger>
  </TextBlock.Triggers>
</TextBlock>

Megjegyzések

Az TextEffect objektum lehetővé teszi effektusok( például animációk) hozzáadását szövegobjektumokhoz, például TextBlock, TextElementés FlowDocument objektumokhoz.

Konstruktorok

Name	Description
TextEffect()	Inicializálja a TextEffect osztály új példányát.
TextEffect(Transform, Brush, Geometry, Int32, Int32)	Az osztály új példányának inicializálása osztálytulajdonságértékek TextEffect megadásával.

Mezők

Name	Description
ClipProperty	Azonosítja a Clip függőségi tulajdonságot.
ForegroundProperty	Azonosítja a Foreground függőségi tulajdonságot.
PositionCountProperty	Azonosítja a PositionCount függőségi tulajdonságot.
PositionStartProperty	Azonosítja a PositionStart függőségi tulajdonságot.
TransformProperty	Azonosítja a Transform függőségi tulajdonságot.

Tulajdonságok

Name	Description
CanFreeze	Olyan értéket kap, amely jelzi, hogy az objektum módosítható-e. (Öröklődés forrása Freezable)
Clip	Lekéri vagy beállítja a kivágási régiót.TextEffect
DependencyObjectType	Lekéri a DependencyObjectType példány CLR-típusát körbefuttatót. (Öröklődés forrása DependencyObject)
Dispatcher	Lekérdezi, Dispatcher hogy ez a társítva van-e DispatcherObject . (Öröklődés forrása DispatcherObject)
Foreground	Lekéri vagy beállítja a Brush kívánt elemet a tartalomra TextEffect.
HasAnimatedProperties	Olyan értéket kap, amely jelzi, hogy egy vagy több AnimationClock objektum társítva van-e az objektum függőségi tulajdonságainak bármelyikéhez. (Öröklődés forrása Animatable)
IsFrozen	Olyan értéket kap, amely jelzi, hogy az objektum jelenleg módosítható-e. (Öröklődés forrása Freezable)
IsSealed	Olyan értéket kap, amely jelzi, hogy a példány jelenleg zárolva van-e (írásvédett). (Öröklődés forrása DependencyObject)
PositionCount	Lekéri vagy beállítja a szöveg azon pozícióját, amelyekre a TextEffect szöveg vonatkozik.
PositionStart	Lekéri vagy beállítja a szöveg kezdő pozícióját TextEffect .
Transform	Lekéri vagy beállítja a Transform .TextEffect

Metódusok

Name	Description
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Alkalmazza AnimationClock a megadott DependencyProperty. Ha a tulajdonság már animálva van, a rendszer a megadott HandoffBehavior értéket használja. (Öröklődés forrása Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Alkalmazza AnimationClock a megadott DependencyProperty. Ha a tulajdonság már animálva van, a rendszer az SnapshotAndReplace átadási viselkedést használja. (Öröklődés forrása Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Animációt alkalmaz a megadottra DependencyProperty. Az animáció a következő képkocka megjelenítésekor indul el. Ha a megadott tulajdonság már animálva van, a rendszer a megadott HandoffBehavior tulajdonságot használja. (Öröklődés forrása Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Animációt alkalmaz a megadottra DependencyProperty. Az animáció a következő képkocka megjelenítésekor indul el. Ha a megadott tulajdonság már animálva van, a rendszer az SnapshotAndReplace átadási viselkedést használja. (Öröklődés forrása Animatable)
CheckAccess()	Meghatározza, hogy a hívó szál hozzáfér-e ehhez DispatcherObject. (Öröklődés forrása DispatcherObject)
ClearValue(DependencyProperty)	Törli egy tulajdonság helyi értékét. A törölni kívánt tulajdonságot egy DependencyProperty azonosító határozza meg. (Öröklődés forrása DependencyObject)
ClearValue(DependencyPropertyKey)	Törli egy írásvédett tulajdonság helyi értékét. A törölni kívánt tulajdonságot egy DependencyPropertyKey. (Öröklődés forrása DependencyObject)
Clone()	Ennek egy módosítható klónját TextEffecthozza létre, amely az objektum értékeinek részletes másolatát készíti el. A függőségi tulajdonságok másolásakor ez a módszer az erőforrás-hivatkozásokat és az adatkötéseket másolja (de előfordulhat, hogy ezek már nem oldódnak fel), de nem animációkat vagy az aktuális értékeket.
CloneCore(Freezable)	A példányt a megadott Freezable klónként (mélymásolatként) hozza létre alap (nem animált) tulajdonságértékek használatával. (Öröklődés forrása Freezable)
CloneCurrentValue()	Módosítható klónt hoz létre az TextEffect objektumról, amely részletes másolatokat készít az objektum aktuális értékeiről. Az erőforráshivatkozások, az adatkötések és az animációk nem másolódnak, de az aktuális értékük igen.
CloneCurrentValueCore(Freezable)	A példányt módosítható klónként (mély másolatként) adja meg a megadott Freezable értékekkel. (Öröklődés forrása Freezable)
CoerceValue(DependencyProperty)	A megadott függőségi tulajdonság értékét kényszeríti. Ez úgy érhető el, hogy meghívja a függőségi tulajdonság tulajdonság metaadataiban megadott függvényeket CoerceValueCallback a hívás DependencyObjectsorán. (Öröklődés forrása DependencyObject)
CreateInstance()	Inicializálja a Freezable osztály új példányát. (Öröklődés forrása Freezable)
CreateInstanceCore()	Ha egy származtatott osztályban implementálják, a származtatott osztály új példányát Freezable hozza létre. (Öröklődés forrása Freezable)
Equals(Object)	Meghatározza, hogy a megadott DependencyObject érték megegyezik-e az aktuális DependencyObjectértékével. (Öröklődés forrása DependencyObject)
Freeze()	Az aktuális objektum nem módosítható, és a tulajdonságát a következőre IsFrozenállítjatrue: . (Öröklődés forrása Freezable)
FreezeCore(Boolean)	Ez az Animatable objektum nem módosítható, vagy meghatározza, hogy módosítható-e. (Öröklődés forrása Animatable)
GetAnimationBaseValue(DependencyProperty)	A megadott DependencyPropertyérték nem animált értékét adja vissza. (Öröklődés forrása Animatable)
GetAsFrozen()	Az alaptulajdonságok Freezable(nem animált) értékeinek egy fagyasztott másolatát hozza létre. Mivel a másolat le van fagyasztva, a program hivatkozással másolja a befagyott alobjektumokat. (Öröklődés forrása Freezable)
GetAsFrozenCore(Freezable)	A példányt a megadott Freezable , alapszintű (nem animált) tulajdonságértékekkel zárolt klónává teszi. (Öröklődés forrása Freezable)
GetCurrentValueAsFrozen()	Az aktuális tulajdonságértékek fagyasztott másolatát Freezable hozza létre. Mivel a másolat le van fagyasztva, a program hivatkozással másolja a befagyott alobjektumokat. (Öröklődés forrása Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Az aktuális példányt a megadott Freezablezárolt klónává teszi. Ha az objektum animált függőségi tulajdonságokkal rendelkezik, a program átmásolja az aktuális animált értékeket. (Öröklődés forrása Freezable)
GetHashCode()	Ehhez lekéri a DependencyObjectkivonatkódot. (Öröklődés forrása DependencyObject)
GetLocalValueEnumerator()	Létrehoz egy speciális enumerátort annak meghatározásához, hogy mely függőségi tulajdonságok rendelkeznek helyileg beállított értékekkel.DependencyObject (Öröklődés forrása DependencyObject)
GetValue(DependencyProperty)	Egy függőségi tulajdonság aktuális tényleges értékét adja vissza az adott példányon DependencyObject. (Öröklődés forrása DependencyObject)
InvalidateProperty(DependencyProperty)	Újra kiértékeli a megadott függőségi tulajdonság tényleges értékét. (Öröklődés forrása DependencyObject)
OnChanged()	Az aktuális Freezable objektum módosításakor hívható meg. (Öröklődés forrása Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Ez a tag támogatja a Windows megjelenítési alaprendszer (WPF) infrastruktúrát, és nem közvetlenül a kódból való használatra szolgál. (Öröklődés forrása Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Biztosítja, hogy a megfelelő környezeti mutatók létre legyenek hozva az DependencyObjectType éppen beállított adattagok számára. (Öröklődés forrása Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Felülbírálja a DependencyObject változó típusú függőségi tulajdonságra válaszul a kezelők meghívásának OnPropertyChanged(DependencyPropertyChangedEventArgs)Changedvégrehajtását Freezable is. (Öröklődés forrása Freezable)
ReadLocalValue(DependencyProperty)	Egy függőségi tulajdonság helyi értékét adja vissza, ha létezik. (Öröklődés forrása DependencyObject)
ReadPreamble()	Biztosítja, hogy a Freezable rendszer érvényes szálról legyen elérhető. A metódus öröklőinek Freezable minden olyan API elején meg kell hívniuk ezt a metódust, amely olyan adattagokat olvas be, amelyek nem függőségi tulajdonságok. (Öröklődés forrása Freezable)
SetCurrentValue(DependencyProperty, Object)	Beállítja egy függőségi tulajdonság értékét az értékforrás módosítása nélkül. (Öröklődés forrása DependencyObject)
SetValue(DependencyProperty, Object)	Beállítja egy függőségi tulajdonság helyi értékét, amelyet a függőségi tulajdonság azonosítója határoz meg. (Öröklődés forrása DependencyObject)
SetValue(DependencyPropertyKey, Object)	Beállítja egy írásvédett függőség tulajdonság helyi értékét, amelyet a DependencyPropertyKey függőségi tulajdonság azonosítója határoz meg. (Öröklődés forrása DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Olyan értéket ad vissza, amely jelzi, hogy a szerializálási folyamatok szerializálják-e a megadott függőségi tulajdonság értékét. (Öröklődés forrása DependencyObject)
VerifyAccess()	Kényszeríti, hogy a hívószál hozzáférhessen ehhez.DispatcherObject (Öröklődés forrása DispatcherObject)
WritePostscript()	Elindítja az Changed eseményt, Freezable és meghívja annak metódusát OnChanged() . A származtatott Freezable osztályoknak ezt a metódust minden olyan API végén kell meghívni, amely módosítja a nem függőségi tulajdonságokként tárolt osztálytagokat. (Öröklődés forrása Freezable)
WritePreamble()	Ellenőrzi, hogy a Freezable rendszer nem zárolta-e a elemet, és hogy az érvényes szálkezelési környezetből van-e elérhető. Freezable Az öröklőknek ezt a metódust minden olyan API elején kell meghívni, amely nem függőségi tulajdonságokat tartalmazó adattagoknak ír. (Öröklődés forrása Freezable)

esemény

Name	Description
Changed	Akkor fordul elő, ha a Freezable benne lévő objektum vagy objektum módosul. (Öröklődés forrása Freezable)

Lásd még

• TextEffectCollection