BitmapEffect Klasa

Definicja

Uwaga: ten interfejs API jest już przestarzały.Note: This API is now obsolete. Nieprzestarzała alternatywa to Effect.The non-obsolete alternative is Effect.

Definiuje efekt mapy bitowej.Defines a bitmap effect. Klasy pochodne definiują efekty, które mogą być stosowane do obiektu Visual, takich jak Button lub Image.Derived classes define effects that can be applied to a Visual object, such as a Button or an Image.

public ref class BitmapEffect abstract : System::Windows::Media::Animation::Animatable
public abstract class BitmapEffect : System.Windows.Media.Animation.Animatable
type BitmapEffect = class
    inherit Animatable
Public MustInherit Class BitmapEffect
Inherits Animatable
Dziedziczenie
Pochodne

Uwagi

Uwaga

WPFWPF efekty mapy bitowej to oprogramowanie renderowane.bitmap effects are software rendered. Każdy obiekt, który stosuje efekt, będzie również renderowany w oprogramowaniu.Any object that applies an effect will also be rendered in software. Efekty bitmapowe nie powinny być stosowane do dużych wizualizacji ani animacji, ponieważ może to obniżyć wydajność.Bitmap effects should not be applied to large visuals or animations, because this can degrade performance.

Przestroga

Efekty bitmapowe nie obsługują częściowego wykonywania zaufania.Bitmap effects do not support partial trust execution. Aplikacja musi mieć uprawnienia pełnego zaufania, aby można było używać efektów mapy bitowej.An application must have full trust permissions to use bitmap effects.

Przekształcenia skali są stosowane do wizualizacji przed zastosowaniem efektu.Scale transforms are applied to a visual before an effect is applied. W przypadku niejednorodnego przekształcenia skali efekt będzie używał większej wartości skali.In the event of a non-uniform scale transform, the effect will use the larger of the scale values.

Aktualizacje drzewa wizualnego VisualBrush nie zostaną rozpropagowane, jeśli BitmapEffect znajduje się w łańcuchu nadrzędnym pędzla.Updates to the visual tree of a VisualBrush will not propagate if a BitmapEffect is in the brush's parent chain. To ograniczenie można obejść, wymuszając aktualizację sceny w obiekcie nadrzędnym efektu.You can work around this limitation by forcing an update of the scene on the parent object of the effect. Możesz wywołać InvalidateVisual lub dodać animację, aby wymusić aktualizację sceny.You can call InvalidateVisual or include an animation to force a scene update.

Efekty niestandardowe dziedziczą tę klasę, aby utworzyć zarządzany interfejs dla niezarządzanego efektu.Custom effects inherit this class to create a managed interface to the unmanaged effect. Aby uzyskać więcej informacji, zobacz niezarządzany interfejs API efektu bitmapy.For more information, see the Unmanaged BitmapEffect API.

Uwagi dotyczące implementowania

CreateUnmanagedEffect() musi zostać zastąpiony, aby zainicjować niezarządzany efekt w kodzie zarządzanym. CreateUnmanagedEffect() must be overridden to initialize an unmanaged effect in managed code. UpdateUnmanagedPropertyState(SafeHandle) musi zostać zastąpiony, jeśli efekt niezarządzany ma właściwości, które użytkownik może modyfikować.UpdateUnmanagedPropertyState(SafeHandle) must be overridden when an unmanaged effect has properties that the user can modify. Tej metody należy użyć w połączeniu z SetValue(SafeHandle, String, Object), aby zaktualizować niezarządzane właściwości.Use this method in conjunction with SetValue(SafeHandle, String, Object) to update your unmanaged properties.

Konstruktory

BitmapEffect()

Inicjuje nowe wystąpienie klasy BitmapEffect.Initializes a new instance of the BitmapEffect class.

Właściwości

CanFreeze

Pobiera wartość wskazującą, czy obiekt może być niemodyfikowalny.Gets a value that indicates whether the object can be made unmodifiable.

(Odziedziczone po Freezable)
DependencyObjectType

Pobiera DependencyObjectType, które zawijają typ CLRCLR tego wystąpienia.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Odziedziczone po DependencyObject)
Dispatcher

Dispatcher Pobiera ten DispatcherObject program jest skojarzony z.Gets the Dispatcher this DispatcherObject is associated with.

(Odziedziczone po DispatcherObject)
HasAnimatedProperties

Pobiera wartość wskazującą, czy co najmniej jeden obiekt AnimationClock jest skojarzony z żadną właściwością zależności tego obiektu.Gets a value that indicates whether one or more AnimationClock objects is associated with any of this object's dependency properties.

(Odziedziczone po Animatable)
IsFrozen

Pobiera wartość wskazującą, czy obiekt jest obecnie modyfikowalny.Gets a value that indicates whether the object is currently modifiable.

(Odziedziczone po Freezable)
IsSealed

Pobiera wartość wskazującą, czy to wystąpienie jest aktualnie zapieczętowane (tylko do odczytu).Gets a value that indicates whether this instance is currently sealed (read-only).

(Odziedziczone po DependencyObject)

Metody

ApplyAnimationClock(DependencyProperty, AnimationClock)

Stosuje AnimationClock do określonego DependencyProperty.Applies an AnimationClock to the specified DependencyProperty. Jeśli właściwość jest już animowana, używane jest zachowanie SnapshotAndReplace.If the property is already animated, the SnapshotAndReplace handoff behavior is used.

(Odziedziczone po Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Stosuje AnimationClock do określonego DependencyProperty.Applies an AnimationClock to the specified DependencyProperty. Jeśli właściwość jest już animowana, zostanie użyta określona HandoffBehavior.If the property is already animated, the specified HandoffBehavior is used.

(Odziedziczone po Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)

Stosuje animację do określonego DependencyProperty.Applies an animation to the specified DependencyProperty. Animacja jest uruchamiana, gdy Następna ramka jest renderowana.The animation is started when the next frame is rendered. Jeśli określona właściwość jest już animowana, używane jest zachowanie SnapshotAndReplace.If the specified property is already animated, the SnapshotAndReplace handoff behavior is used.

(Odziedziczone po Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Stosuje animację do określonego DependencyProperty.Applies an animation to the specified DependencyProperty. Animacja jest uruchamiana, gdy Następna ramka jest renderowana.The animation is started when the next frame is rendered. Jeśli określona właściwość jest już animowana, zostanie użyta określona HandoffBehavior.If the specified property is already animated, the specified HandoffBehavior is used.

(Odziedziczone po Animatable)
CheckAccess()

Określa, czy wątek wywołujący ma dostęp do DispatcherObjecttego.Determines whether the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)

Czyści wartość lokalną właściwości.Clears the local value of a property. Właściwość, która ma zostać wyczyszczona, jest określana przez identyfikator DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)

Czyści wartość lokalną właściwości tylko do odczytu.Clears the local value of a read-only property. Właściwość, która ma zostać wyczyszczona, jest określana przez DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Odziedziczone po DependencyObject)
Clone()

Tworzy modyfikowalny klon tego BitmapEffect, tworząc głębokie kopie wartości tego obiektu.Creates a modifiable clone of this BitmapEffect, making deep copies of this object's values. Podczas kopiowania właściwości zależności ta metoda kopiuje odwołania do zasobów i powiązania danych (ale mogą nie być już rozpoznawane), ale nie ma animacji ani ich bieżących wartości.When copying dependency properties, this method copies resource references and data bindings (but they might no longer resolve) but not animations or their current values.

CloneCore(Freezable)

Sprawia, że wystąpienie jest klonem (głębokiej kopii) określonego Freezable przy użyciu podstawowych (nieanimowanych) wartości właściwości.Makes the instance a clone (deep copy) of the specified Freezable using base (non-animated) property values.

(Odziedziczone po Freezable)
CloneCurrentValue()

Tworzy modyfikowalny klon tego obiektu BitmapEffect, tworząc głębokie kopie bieżących wartości tego obiektu.Creates a modifiable clone of this BitmapEffect object, making deep copies of this object's current values. Odwołania do zasobów, powiązania danych i animacje nie są kopiowane, ale ich bieżące wartości to.Resource references, data bindings, and animations are not copied, but their current values are.

CloneCurrentValueCore(Freezable)

Sprawia, że wystąpienie jest modyfikowalnym klonem (głębokiej kopii) określonego Freezable przy użyciu bieżących wartości właściwości.Makes the instance a modifiable clone (deep copy) of the specified Freezable using current property values.

(Odziedziczone po Freezable)
CoerceValue(DependencyProperty)

Przekształca wartość określonej właściwości zależności.Coerces the value of the specified dependency property. W tym celu należy wywołać dowolną funkcję CoerceValueCallback określoną w metadanych właściwości dla właściwości zależności, która istnieje w DependencyObjectwywoływania.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Odziedziczone po DependencyObject)
CreateBitmapEffectOuter()

Tworzy dojście do obiektu IMILBitmapEffect , który jest używany do inicjowania niestandardowego efektu.Creates a handle to an IMILBitmapEffect object that is used to initialize a custom effect.

CreateInstance()

Inicjuje nowe wystąpienie klasy Freezable.Initializes a new instance of the Freezable class.

(Odziedziczone po Freezable)
CreateInstanceCore()

Po zaimplementowaniu w klasie pochodnej tworzy nowe wystąpienie klasy pochodnej Freezable.When implemented in a derived class, creates a new instance of the Freezable derived class.

(Odziedziczone po Freezable)
CreateUnmanagedEffect()

Gdy jest zastępowany w klasie pochodnej, tworzy klon niezarządzanego efektu.When overridden in a derived class, creates a clone of the unmanaged effect.

Equals(Object)

Określa, czy podana DependencyObject jest równoważna z bieżącym DependencyObject.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Odziedziczone po DependencyObject)
Freeze()

Sprawia, że bieżący obiekt jest niemodyfikowalny i ustawia jego właściwość IsFrozen na true.Makes the current object unmodifiable and sets its IsFrozen property to true.

(Odziedziczone po Freezable)
FreezeCore(Boolean)

Sprawia, że ten obiekt Animatable nie jest modyfikowany lub określa, czy można go nie modyfikować.Makes this Animatable object unmodifiable or determines whether it can be made unmodifiable.

(Odziedziczone po Animatable)
GetAnimationBaseValue(DependencyProperty)

Zwraca nieanimowaną wartość podanej DependencyProperty.Returns the non-animated value of the specified DependencyProperty.

(Odziedziczone po Animatable)
GetAsFrozen()

Tworzy zamrożoną kopię Freezableprzy użyciu podstawowych (nieanimowanych) wartości właściwości.Creates a frozen copy of the Freezable, using base (non-animated) property values. Ponieważ kopia jest zamrożona, wszelkie zamrożone obiekty podrzędne są kopiowane przez odwołanie.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Odziedziczone po Freezable)
GetAsFrozenCore(Freezable)

Sprawia, że wystąpienie jest zablokowanym klonem określonego Freezable przy użyciu podstawowych (nieanimowanych) wartości właściwości.Makes the instance a frozen clone of the specified Freezable using base (non-animated) property values.

(Odziedziczone po Freezable)
GetCurrentValueAsFrozen()

Tworzy zamrożoną kopię Freezable przy użyciu bieżących wartości właściwości.Creates a frozen copy of the Freezable using current property values. Ponieważ kopia jest zamrożona, wszelkie zamrożone obiekty podrzędne są kopiowane przez odwołanie.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Odziedziczone po Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Sprawia, że bieżące wystąpienie jest zablokowanym klonem określonego Freezable.Makes the current instance a frozen clone of the specified Freezable. Jeśli obiekt ma animowane właściwości zależności, ich bieżące wartości animowane są kopiowane.If the object has animated dependency properties, their current animated values are copied.

(Odziedziczone po Freezable)
GetHashCode()

Pobiera kod skrótu dla tego DependencyObject.Gets a hash code for this DependencyObject.

(Odziedziczone po DependencyObject)
GetLocalValueEnumerator()

Tworzy wyspecjalizowany moduł wyliczający służący do określania, które właściwości zależności mają lokalnie ustawione wartości na tej DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Odziedziczone po DependencyObject)
GetOutput(BitmapEffectInput)

Zwraca BitmapSource, które wynikają z zastosowania efektu do określonego BitmapEffectInput.Returns the BitmapSource that results when the effect is applied to the specified BitmapEffectInput.

GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
GetValue(DependencyProperty)

Zwraca bieżącą obowiązującą wartość właściwości zależności w tym wystąpieniu DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Odziedziczone po DependencyObject)
InitializeBitmapEffect(SafeHandle, SafeHandle)

Inicjuje dojście IMILBitmapEffect uzyskane z CreateBitmapEffectOuter() z danym IMILBitmapEffectPrimitive.Initializes an IMILBitmapEffect handle obtained from CreateBitmapEffectOuter() with the given IMILBitmapEffectPrimitive.

InvalidateProperty(DependencyProperty)

Ponowna ocenuje wartość efektywną dla określonej właściwości zależności.Re-evaluates the effective value for the specified dependency property.

(Odziedziczone po DependencyObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
OnChanged()

Wywoływana, gdy bieżący obiekt Freezable jest modyfikowany.Called when the current Freezable object is modified.

(Odziedziczone po Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Zapewnia, że DependencyObjectType dla elementu członkowskiego danych, który został właśnie ustawiony, są ustanowione odpowiednie wskaźniki kontekstu.Ensures that appropriate context pointers are established for a DependencyObjectType data member that has just been set.

(Odziedziczone po Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Ten element członkowski obsługuje infrastrukturę Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) i nie jest przeznaczony do użycia bezpośrednio w kodzie.This member supports the Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

(Odziedziczone po Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Przesłania DependencyObject implementację OnPropertyChanged(DependencyPropertyChangedEventArgs), aby wywołać także wszystkie procedury obsługi Changed w odpowiedzi na zmianę właściwości zależności typu Freezable.Overrides the DependencyObject implementation of OnPropertyChanged(DependencyPropertyChangedEventArgs) to also invoke any Changed handlers in response to a changing dependency property of type Freezable.

(Odziedziczone po Freezable)
ReadLocalValue(DependencyProperty)

Zwraca wartość lokalną właściwości zależności, jeśli istnieje.Returns the local value of a dependency property, if it exists.

(Odziedziczone po DependencyObject)
ReadPreamble()

Zapewnia dostęp do Freezable z prawidłowego wątku.Ensures that the Freezable is being accessed from a valid thread. Dziedziczenia Freezable muszą wywoływać tę metodę na początku każdego interfejsu API, który odczytuje składowe danych, które nie są właściwościami zależności.Inheritors of Freezable must call this method at the beginning of any API that reads data members that are not dependency properties.

(Odziedziczone po Freezable)
SetCurrentValue(DependencyProperty, Object)

Ustawia wartość właściwości zależności bez zmiany jego źródła wartości.Sets the value of a dependency property without changing its value source.

(Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)

Ustawia wartość lokalną właściwości zależności, określoną za pomocą identyfikatora właściwości zależności.Sets the local value of a dependency property, specified by its dependency property identifier.

(Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)

Ustawia wartość lokalną właściwości zależności tylko do odczytu, określoną przez DependencyPropertyKey identyfikator właściwości zależności.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Odziedziczone po DependencyObject)
SetValue(SafeHandle, String, Object)

Ustawia określoną właściwość na daną wartość.Sets the specified property to the given value.

ShouldSerializeProperty(DependencyProperty)

Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość dla podanej właściwości zależności.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Odziedziczone po DependencyObject)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
UpdateUnmanagedPropertyState(SafeHandle)

Gdy jest zastępowany w klasie pochodnej, aktualizuje Stany właściwości niezarządzanych właściwości efektu.When overridden in a derived class, updates the property states of the unmanaged properties of the effect.

VerifyAccess()

Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)
WritePostscript()

Podnosi zdarzenie Changed dla Freezable i wywołuje jego metodę OnChanged().Raises the Changed event for the Freezable and invokes its OnChanged() method. Klasy, które pochodzą z Freezable powinny wywołać tę metodę na końcu każdego interfejsu API, który modyfikuje składowe klasy, które nie są przechowywane jako właściwości zależności.Classes that derive from Freezable should call this method at the end of any API that modifies class members that are not stored as dependency properties.

(Odziedziczone po Freezable)
WritePreamble()

Sprawdza, czy Freezable nie jest zamrożona i czy jest dostępny z prawidłowego kontekstu wątków.Verifies that the Freezable is not frozen and that it is being accessed from a valid threading context. dziedziczenia Freezable powinny wywołać tę metodę na początku każdego interfejsu API, który zapisuje dane w elementach członkowskich, które nie są właściwościami zależności.Freezable inheritors should call this method at the beginning of any API that writes to data members that are not dependency properties.

(Odziedziczone po Freezable)

Zdarzenia

Changed

Występuje, gdy Freezable lub obiekt, który zawiera, jest modyfikowany.Occurs when the Freezable or an object it contains is modified.

(Odziedziczone po Freezable)

Dotyczy

Zobacz też