LinearGradientBrush Třída

Definice

Obor názvů:

System.Windows.Media

Sestavení:

PresentationCore.dll

Nakreslí oblast lineárním přechodem.

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

Dědičnost

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Brush

GradientBrush

LinearGradientBrush

Poznámky

A LinearGradientBrush maluje oblast lineárním přechodem. Lineární přechod definuje přechod podél čáry. Koncové body čáry jsou definovány vlastnostmi StartPointEndPoint lineárního přechodu. LinearGradientBrush Štětec nakresluje podél GradientStops této čáry.

Výchozí lineární přechod je diagonální. Ve výchozím nastavení StartPoint je lineární přechod (0,0), levý horní roh oblasti, která se maluje, a jeho EndPoint je (1,1), pravý dolní roh oblasti, která se maluje. Barvy ve výsledném přechodu jsou interpolovány podél diagonální cesty.

Následující obrázek znázorňuje diagonální přechod. Byla přidána čára, která zvýrazní interpolační cestu přechodu od počátečního bodu do koncového bodu.

Diagonální lineární přechod

Následující obrázek znázorňuje stejný lineární přechod, ale se zvýrazněnými přechodovými zarážkami.

Diagonální lineární přechod se zvýrazněnými přechodovými zarážkami

Je možné zadat osu přechodu, která zcela nevyplňuje vykreslenou oblast. Pokud k tomu dojde, SpreadMethod vlastnost určuje, jak se zbývající oblast maluje.

Zamrznutelné funkce

A LinearGradientBrush je typ objektu Freezable , a proto může být zmrazen za účelem zlepšení výkonu. Informace o Freezable funkcích, jako je zmrazení a klonování, naleznete v tématu Přehled zamrznutelných objektů.

Konstruktory

Name	Description
LinearGradientBrush()	Inicializuje novou instanci LinearGradientBrush třídy.
LinearGradientBrush(Color, Color, Double)	Inicializuje novou instanci LinearGradientBrush třídy, která má zadaný začátek Color, konec Colora úhel.
LinearGradientBrush(Color, Color, Point, Point)	Inicializuje novou instanci LinearGradientBrush třídy, která má zadaný začátek Color, konec Color, StartPointa EndPoint.
LinearGradientBrush(GradientStopCollection, Double)	Inicializuje novou instanci LinearGradientBrush třídy, která má zadaný GradientStopCollection a úhel.
LinearGradientBrush(GradientStopCollection, Point, Point)	Inicializuje novou instanci LinearGradientBrush třídy, která má zadané přechodové zarážky, StartPointa EndPoint.
LinearGradientBrush(GradientStopCollection)	Inicializuje novou instanci LinearGradientBrush třídy, která má zadané přechodové zarážky.

Pole

Name	Description
EndPointProperty	Identifikuje EndPoint vlastnost závislosti.
StartPointProperty	Identifikuje StartPoint vlastnost závislosti.

Vlastnosti

Name	Description
CanFreeze	Získá hodnotu, která označuje, zda objekt lze vytvořit nemodifovatelný. (Zděděno od Freezable)
ColorInterpolationMode	Získá nebo nastaví ColorInterpolationMode výčet, který určuje způsob interpolace barev přechodu. (Zděděno od GradientBrush)
DependencyObjectType	DependencyObjectType Získá ten, který zabalí typ CLR této instance. (Zděděno od DependencyObject)
Dispatcher	Dispatcher Získá toto DispatcherObject je přidružené. (Zděděno od DispatcherObject)
EndPoint	Získá nebo nastaví koncové dvourozměrné souřadnice lineárního přechodu.
GradientStops	Získá nebo nastaví přechodové zarážky štětce. (Zděděno od GradientBrush)
HasAnimatedProperties	Získá hodnotu, která určuje, zda jeden nebo více AnimationClock objektů je přidružen k některé z vlastností závislosti tohoto objektu. (Zděděno od Animatable)
IsFrozen	Získá hodnotu, která označuje, zda objekt je aktuálně upravitelný. (Zděděno od Freezable)
IsSealed	Získá hodnotu, která označuje, zda je tato instance aktuálně zapečetěna (jen pro čtení). (Zděděno od DependencyObject)
MappingMode	Získá nebo nastaví BrushMappingMode výčet, který určuje, zda jsou souřadnice umístění štětce přechodu absolutní nebo relativní k výstupní oblasti. (Zděděno od GradientBrush)
Opacity	Získá nebo nastaví stupeň neprůhlednosti Brush. (Zděděno od Brush)
RelativeTransform	Získá nebo nastaví transformaci, která se použije na štětec pomocí relativních souřadnic. (Zděděno od Brush)
SpreadMethod	Získá nebo nastaví typ rozprostřené metody, která určuje, jak nakreslit přechod, který začíná nebo končí uvnitř hranic objektu, který má být malován. (Zděděno od GradientBrush)
StartPoint	Získá nebo nastaví počáteční dvourozměrné souřadnice lineárního přechodu.
Transform	Získá nebo nastaví transformaci, která je použita na štětec. Tato transformace se použije po namapovaném a umístěném výstupu štětce. (Zděděno od Brush)

Metody

Name	Description
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Použije pro AnimationClock zadaný DependencyPropertyparametr . Pokud je vlastnost již animovaná, použije se zadané HandoffBehavior . (Zděděno od Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Použije pro AnimationClock zadaný DependencyPropertyparametr . Pokud je vlastnost již animované, použije se SnapshotAndReplace chování předání. (Zděděno od Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Použije animaci na zadanou DependencyPropertypoložku . Animace se spustí při vykreslení dalšího snímku. Pokud je zadaná vlastnost již animované, použije se zadaná HandoffBehavior vlastnost. (Zděděno od Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Použije animaci na zadanou DependencyPropertypoložku . Animace se spustí při vykreslení dalšího snímku. Pokud je zadaná vlastnost již animované, použije se SnapshotAndReplace chování předání. (Zděděno od Animatable)
CheckAccess()	Určuje, zda volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)
ClearValue(DependencyProperty)	Vymaže místní hodnotu vlastnosti. Vlastnost, která se má vymazat, je určena identifikátorem DependencyProperty . (Zděděno od DependencyObject)
ClearValue(DependencyPropertyKey)	Vymaže místní hodnotu vlastnosti jen pro čtení. Vlastnost, která má být vymazána, je určena parametrem DependencyPropertyKey. (Zděděno od DependencyObject)
Clone()	Vytvoří upravitelný klon tohoto LinearGradientBrushobjektu a vytvoří hluboké kopie hodnot tohoto objektu. Při kopírování vlastností závislostí tato metoda kopíruje odkazy na prostředky a datové vazby (ale nemusí se už překládat), ale ne animace nebo jejich aktuální hodnoty.
CloneCore(Freezable)	Vytvoří instanci klonem (hloubkovou kopií) zadaného Freezable pomocí základních (ne animovaných) hodnot vlastností. (Zděděno od Freezable)
CloneCurrentValue()	Vytvoří upravitelný klon tohoto LinearGradientBrush objektu a vytvoří hluboké kopie aktuálních hodnot tohoto objektu. Odkazy na prostředky, datové vazby a animace se nekopírují, ale jejich aktuální hodnoty jsou.
CloneCurrentValueCore(Freezable)	Vytvoří instanci upravitelný klon (hloubkovou kopii) zadaného Freezable pomocí aktuálních hodnot vlastností. (Zděděno od Freezable)
CoerceValue(DependencyProperty)	Převede hodnotu zadané vlastnosti závislosti. Toho se dosahuje vyvoláním jakékoli CoerceValueCallback funkce zadané v metadatech vlastností pro vlastnost závislosti, protože existuje ve volání DependencyObject. (Zděděno od DependencyObject)
CreateInstance()	Inicializuje novou instanci Freezable třídy. (Zděděno od Freezable)
CreateInstanceCore()	Při implementaci v odvozené třídě vytvoří novou instanci odvozené Freezable třídy. (Zděděno od Freezable)
Equals(Object)	Určuje, zda je poskytnutá DependencyObject hodnota ekvivalentní aktuálnímu DependencyObject. (Zděděno od DependencyObject)
Freeze()	Nastaví aktuální objekt jako nemodifikovatelný a nastaví jeho IsFrozen vlastnost na true. (Zděděno od Freezable)
FreezeCore(Boolean)	Znepřístupňuje tento Animatable objekt nebo určuje, zda jej lze upravit. (Zděděno od Animatable)
GetAnimationBaseValue(DependencyProperty)	Vrátí ne animovanou hodnotu zadané DependencyPropertyhodnoty . (Zděděno od Animatable)
GetAsFrozen()	Vytvoří zablokovanou kopii Freezablevlastnosti , pomocí základních (ne animovaných) hodnot vlastností. Vzhledem k tomu, že je kopie zablokovaná, všechny ukotvené dílčí objekty se zkopírují odkazem. (Zděděno od Freezable)
GetAsFrozenCore(Freezable)	Vytvoří instanci ukotveným klonem zadaného Freezable pomocí základních (ne animovaných) hodnot vlastností. (Zděděno od Freezable)
GetCurrentValueAsFrozen()	Vytvoří ukotvenou kopii s použitím aktuálních Freezable hodnot vlastností. Vzhledem k tomu, že je kopie zablokovaná, všechny ukotvené dílčí objekty se zkopírují odkazem. (Zděděno od Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Vytvoří aktuální instanci zmrazený klon zadaného Freezable. Pokud má objekt animované vlastnosti závislostí, jejich aktuální animované hodnoty se zkopírují. (Zděděno od Freezable)
GetHashCode()	Získá hash kód pro tento DependencyObject. (Zděděno od DependencyObject)
GetLocalValueEnumerator()	Vytvoří specializovaný enumerátor pro určení, které vlastnosti závislosti mají místně nastavené hodnoty na tomto DependencyObject. (Zděděno od DependencyObject)
GetValue(DependencyProperty)	Vrátí aktuální efektivní hodnotu vlastnosti závislosti na této instanci objektu DependencyObject. (Zděděno od DependencyObject)
InvalidateProperty(DependencyProperty)	Znovu vyhodnotí efektivní hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
OnChanged()	Volá se při změně aktuálního Freezable objektu. (Zděděno od Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Tento člen podporuje infrastrukturu Windows Presentation Foundation (WPF) a není určená k použití přímo z vašeho kódu. (Zděděno od Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Zajišťuje, aby byly pro datový člen, který byl právě nastaven, vytvořeny DependencyObjectType příslušné kontextové ukazatele. (Zděděno od Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Přepíše implementaci DependencyObjectOnPropertyChanged(DependencyPropertyChangedEventArgs) také vyvolat všechny Changed obslužné rutiny v reakci na měnící se závislost vlastnost typu Freezable. (Zděděno od Freezable)
ReadLocalValue(DependencyProperty)	Vrátí místní hodnotu vlastnosti závislosti, pokud existuje. (Zděděno od DependencyObject)
ReadPreamble()	Zajišťuje, že se k němu Freezable přistupuje z platného vlákna. Dědiče Freezable této metody musí volat tuto metodu na začátku jakéhokoli rozhraní API, které čte datové členy, které nejsou vlastnostmi závislosti. (Zděděno od Freezable)
SetCurrentValue(DependencyProperty, Object)	Nastaví hodnotu vlastnosti závislosti beze změny jejího zdroje hodnot. (Zděděno od DependencyObject)
SetValue(DependencyProperty, Object)	Nastaví místní hodnotu vlastnosti závislosti určenou jeho identifikátorem vlastnosti závislosti. (Zděděno od DependencyObject)
SetValue(DependencyPropertyKey, Object)	Nastaví místní hodnotu vlastnosti závislosti jen pro čtení určenou identifikátorem DependencyPropertyKey vlastnosti závislosti. (Zděděno od DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Vrátí hodnotu, která určuje, zda procesy serializace mají serializovat hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
ToString()	Vrátí řetězcovou reprezentaci tohoto Brushvýrazu . (Zděděno od Brush)
ToString(IFormatProvider)	Vytvoří řetězcovou reprezentaci tohoto objektu na základě zadaných informací o formátování specifické pro jazykovou verzi. (Zděděno od Brush)
VerifyAccess()	Vynucuje, že volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)
WritePostscript()	Changed Vyvolá událost pro událost Freezable a vyvolá její OnChanged() metodu. Třídy odvozené z Freezable by měly volat tuto metodu na konci jakéhokoli rozhraní API, které upravuje členy třídy, které nejsou uloženy jako vlastnosti závislosti. (Zděděno od Freezable)
WritePreamble()	Ověřuje, že Freezable není zablokovaný a že k němu přistupujete z platného kontextu podprocesu. Freezable dědiče by měly tuto metodu volat na začátku jakéhokoli rozhraní API, které zapisuje do datových členů, které nejsou vlastnostmi závislosti. (Zděděno od Freezable)

Událost

Name	Description
Changed	Nastane, když Freezable je objekt, který obsahuje, změněn. (Zděděno od Freezable)

Explicitní implementace rozhraní

Name	Description
IFormattable.ToString(String, IFormatProvider)	Naformátuje hodnotu aktuální instance pomocí zadaného formátu. (Zděděno od Brush)

Viz také

• GradientStop
• RadialGradientBrush
• GradientBrush