LinearGradientBrush Osztály

Definíció

Névtér:

System.Windows.Media

Szerelvény:

PresentationCore.dll

Lineáris színátmenettel fest egy területet.

public ref class LinearGradientBrush sealed : System::Windows::Media::GradientBrush

public sealed class LinearGradientBrush : System.Windows.Media.GradientBrush

type LinearGradientBrush = class
    inherit GradientBrush

Public NotInheritable Class LinearGradientBrush
Inherits GradientBrush

Öröklődés

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Brush

GradientBrush

LinearGradientBrush

Megjegyzések

Egy LinearGradientBrush terület lineáris színátmenettel fest. A lineáris színátmenet egy vonal mentén határoz meg egy színátmenetet. A vonal végpontját a StartPoint lineáris gradiens tulajdonságai és EndPoint tulajdonságai határozzák meg. Egy LinearGradientBrush ecset festi a GradientStops vonal mentén.

Az alapértelmezett lineáris színátmenet átlós. Alapértelmezés szerint a StartPoint lineáris színátmenet értéke (0,0), a festett terület bal felső sarka, és ( EndPoint 1,1) a festett terület jobb alsó sarkában. Az eredményül kapott színátmenet színeit az átlós útvonal mentén interpolálja a rendszer.

Az alábbi ábrán egy átlós színátmenet látható. Egy sor lett hozzáadva a színátmenet interpolációs útvonalának kiemeléséhez a kezdőponttól a végpontig.

Átlós lineáris színátmenet

A következő ábrán ugyanaz a lineáris színátmenet látható, de kiemelt színátmeneti végpontokkal.

Átlós lineáris színátmenet kiemelt színátmeneti végpontokkal

Megadhat egy színátmenetes tengelyt, amely nem teljesen kitölti a festendő területet. Ha ez történik, a SpreadMethod tulajdonság határozza meg, hogy a fennmaradó terület hogyan van festve.

Fagyasztható funkciók

Az A LinearGradientBrush egy objektumtípus Freezable , ezért a teljesítmény javítása érdekében fagyasztható. További információ a funkciókról Freezable , például a fagyasztásról és a klónozásról: Fagyasztható objektumok áttekintése.

Konstruktorok

Name	Description
LinearGradientBrush()	Inicializálja a LinearGradientBrush osztály új példányát.
LinearGradientBrush(Color, Color, Double)	Inicializálja annak az osztálynak az LinearGradientBrush új példányát, amely a megadott kezdő Color, záró Colorés szögű.
LinearGradientBrush(Color, Color, Point, Point)	Inicializálja annak az osztálynak az LinearGradientBrush új példányát, amely a megadott kezdőColor, záró ColorStartPointés EndPoint.
LinearGradientBrush(GradientStopCollection, Double)	Inicializálja a LinearGradientBrush megadott GradientStopCollection és szögű osztály új példányát.
LinearGradientBrush(GradientStopCollection, Point, Point)	Inicializálja annak az osztálynak az LinearGradientBrush új példányát, amely a megadott színátmeneti végpontokkal rendelkezik, StartPointés EndPoint.
LinearGradientBrush(GradientStopCollection)	Inicializálja annak az osztálynak az LinearGradientBrush új példányát, amely a megadott színátmenet-leállásokkal rendelkezik.

Mezők

Name	Description
EndPointProperty	Azonosítja a EndPoint függőségi tulajdonságot.
StartPointProperty	Azonosítja a StartPoint 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)
ColorInterpolationMode	Lekéri vagy beállítja az enumerálást ColorInterpolationMode , amely meghatározza a színátmenet színeinek interpolálását. (Öröklődés forrása GradientBrush)
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)
EndPoint	Lekéri vagy beállítja a lineáris gradiens záró kétdimenziós koordinátáit.
GradientStops	Lekéri vagy beállítja az ecset színátmeneti állomását. (Öröklődés forrása GradientBrush)
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)
MappingMode	Lekéri vagy beállítja az enumerálást BrushMappingMode , amely meghatározza, hogy a színátmenetes ecset pozíciókoordinátái abszolútak vagy a kimeneti területhez viszonyítva vannak-e. (Öröklődés forrása GradientBrush)
Opacity	Lekéri vagy beállítja az átlátszatlanság fokát.Brush (Öröklődés forrása Brush)
RelativeTransform	Lekéri vagy beállítja az ecsetre alkalmazott átalakítást relatív koordináták használatával. (Öröklődés forrása Brush)
SpreadMethod	Lekéri vagy beállítja a színterjedési metódus típusát, amely meghatározza, hogyan rajzolhat olyan színátmenetet, amely a festendő objektum határán belül kezdődik vagy végződik. (Öröklődés forrása GradientBrush)
StartPoint	Lekéri vagy beállítja a lineáris színátmenet kezdő kétdimenziós koordinátáit.
Transform	Lekéri vagy beállítja az ecsetre alkalmazott átalakítást. Ezt az átalakítást az ecset kimenetének leképezése és elhelyezése után alkalmazza a rendszer. (Öröklődés forrása Brush)

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 LinearGradientBrushhozza 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 LinearGradientBrush 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)
ToString()	Ennek Brusha sztring-ábrázolásának visszaadása. (Öröklődés forrása Brush)
ToString(IFormatProvider)	Az objektum sztring-ábrázolását hozza létre a megadott kultúraspecifikus formázási információk alapján. (Öröklődés forrása Brush)
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)

Explicit interfész-implementációk

Name	Description
IFormattable.ToString(String, IFormatProvider)	Formázza az aktuális példány értékét a megadott formátummal. (Öröklődés forrása Brush)

Lásd még

• GradientStop
• RadialGradientBrush
• GradientBrush