Condividi tramite

BitmapEffect Classe

Definizione

Spazio dei nomi:
System.Windows.Media.Effects
Assembly:
PresentationCore.dll

Nota: questa API è ora obsoleta. L'alternativa non obsoleta è Effect.

Definisce un effetto bitmap. Le classi derivate definiscono gli effetti che possono essere applicati a un Visual oggetto, ad esempio un Button oggetto o .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
Ereditarietà
Object
DispatcherObject
DependencyObject
Freezable
Animatable
BitmapEffect
Derivato

Commenti

Note

Viene eseguito il rendering degli effetti bitmap WPF. Anche qualsiasi oggetto che applica un effetto verrà sottoposto a rendering nel software. Gli effetti bitmap non devono essere applicati a oggetti visivi o animazioni di grandi dimensioni, perché ciò può compromettere le prestazioni.

Caution

Gli effetti bitmap non supportano l'esecuzione parziale dell'attendibilità. Un'applicazione deve disporre delle autorizzazioni di attendibilità completa per l'uso degli effetti bitmap.

Le trasformazioni di scala vengono applicate a un oggetto visivo prima dell'applicazione di un effetto. In caso di trasformazione di scala non uniforme, l'effetto userà le dimensioni maggiori dei valori di scala.

Gli aggiornamenti alla struttura ad albero visuale di un VisualBrush oggetto non verranno propagati se un BitmapEffect oggetto si trova nella catena padre del pennello. È possibile ovviare a questa limitazione forzando un aggiornamento della scena sull'oggetto padre dell'effetto. Puoi chiamare InvalidateVisual o includere un'animazione per forzare un aggiornamento della scena.

Gli effetti personalizzati ereditano questa classe per creare un'interfaccia gestita per l'effetto non gestito.

Note per gli implementatori

CreateUnmanagedEffect() deve essere sottoposto a override per inizializzare un effetto non gestito nel codice gestito.

UpdateUnmanagedPropertyState(SafeHandle) deve essere sottoposto a override quando un effetto non gestito ha proprietà che l'utente può modificare. Usare questo metodo insieme SetValue(SafeHandle, String, Object) a per aggiornare le proprietà non gestite.

Costruttori

Nome Descrizione
BitmapEffect()

Inizializza una nuova istanza della classe BitmapEffect.

Proprietà

Nome Descrizione
CanFreeze

Ottiene un valore che indica se l'oggetto può essere reso non modificabile.

(Ereditato da Freezable)
DependencyObjectType

Ottiene l'oggetto DependencyObjectType che esegue il wrapping del tipo CLR di questa istanza.

(Ereditato da DependencyObject)
Dispatcher

Ottiene l'oggetto DispatcherDispatcherObject a cui è associato.

(Ereditato da DispatcherObject)
HasAnimatedProperties

Ottiene un valore che indica se uno o più AnimationClock oggetti sono associati a una delle proprietà di dipendenza di questo oggetto.

(Ereditato da Animatable)
IsFrozen

Ottiene un valore che indica se l'oggetto è attualmente modificabile.

(Ereditato da Freezable)
IsSealed

Ottiene un valore che indica se questa istanza è attualmente sealed (sola lettura).

(Ereditato da DependencyObject)

Metodi

Nome Descrizione
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Applica un oggetto AnimationClock all'oggetto specificato DependencyProperty. Se la proprietà è già animata, viene utilizzato l'oggetto specificato HandoffBehavior .

(Ereditato da Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)

Applica un oggetto AnimationClock all'oggetto specificato DependencyProperty. Se la proprietà è già animata, viene utilizzato il SnapshotAndReplace comportamento di handoff.

(Ereditato da Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Applica un'animazione all'oggetto specificato DependencyProperty. L'animazione viene avviata quando viene eseguito il rendering del fotogramma successivo. Se la proprietà specificata è già animata, viene utilizzato l'oggetto specificato HandoffBehavior .

(Ereditato da Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)

Applica un'animazione all'oggetto specificato DependencyProperty. L'animazione viene avviata quando viene eseguito il rendering del fotogramma successivo. Se la proprietà specificata è già animata, viene utilizzato il SnapshotAndReplace comportamento di handoff.

(Ereditato da Animatable)
CheckAccess()

Determina se il thread chiamante ha accesso a questo DispatcherObjectoggetto .

(Ereditato da DispatcherObject)
ClearValue(DependencyProperty)

Cancella il valore locale di una proprietà. La proprietà da cancellare viene specificata da un DependencyProperty identificatore.

(Ereditato da DependencyObject)
ClearValue(DependencyPropertyKey)

Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare viene specificata da un oggetto DependencyPropertyKey.

(Ereditato da DependencyObject)
Clone()

Crea un clone modificabile di questo BitmapEffectoggetto , eseguendo copie complete dei valori di questo oggetto. Quando si copiano le proprietà di dipendenza, questo metodo copia i riferimenti alle risorse e i data binding (ma potrebbero non essere più risolti), ma non le animazioni o i relativi valori correnti.
CloneCore(Freezable)

Rende l'istanza un clone (copia completa) dell'oggetto specificato Freezable usando valori di proprietà di base (non animati).

(Ereditato da Freezable)
CloneCurrentValue()

Crea un clone modificabile di questo BitmapEffect oggetto, eseguendo copie complete dei valori correnti dell'oggetto. I riferimenti alle risorse, i data binding e le animazioni non vengono copiati, ma i relativi valori correnti sono.
CloneCurrentValueCore(Freezable)

Rende l'istanza un clone modificabile (copia completa) dell'oggetto specificato Freezable utilizzando i valori delle proprietà correnti.

(Ereditato da Freezable)
CoerceValue(DependencyProperty)

Forza il valore della proprietà di dipendenza specificata. A tale scopo, richiamare qualsiasi CoerceValueCallback funzione specificata nei metadati della proprietà per la proprietà di dipendenza così come esiste nella chiamata DependencyObjectdi .

(Ereditato da DependencyObject)
CreateBitmapEffectOuter()
Obsoleti.

Crea un handle per un oggetto IMILBitmapEffect utilizzato per inizializzare un effetto personalizzato.
CreateInstance()

Inizializza una nuova istanza della classe Freezable.

(Ereditato da Freezable)
CreateInstanceCore()

Se implementato in una classe derivata, crea una nuova istanza della Freezable classe derivata.

(Ereditato da Freezable)
CreateUnmanagedEffect()
Obsoleti.

Quando sottoposto a override in una classe derivata, crea un clone dell'effetto non gestito.
Equals(Object)

Determina se un oggetto specificato DependencyObject è equivalente all'oggetto corrente DependencyObject.

(Ereditato da DependencyObject)
Freeze()

Rende l'oggetto corrente non modificabile e imposta la relativa IsFrozen proprietà su true.

(Ereditato da Freezable)
FreezeCore(Boolean)

Animatable Rende questo oggetto non modificabile o determina se può essere reso non modificabile.

(Ereditato da Animatable)
GetAnimationBaseValue(DependencyProperty)

Restituisce il valore non animato dell'oggetto specificato DependencyProperty.

(Ereditato da Animatable)
GetAsFrozen()

Crea una copia bloccata della proprietà , utilizzando i valori della Freezableproprietà base (non animati). Poiché la copia è bloccata, tutti gli oggetti secondari bloccati vengono copiati in base al riferimento.

(Ereditato da Freezable)
GetAsFrozenCore(Freezable)

Rende l'istanza un clone bloccato dell'oggetto specificato Freezable utilizzando valori di proprietà di base (non animati).

(Ereditato da Freezable)
GetCurrentValueAsFrozen()

Crea una copia bloccata dell'oggetto utilizzando i valori correnti delle Freezable proprietà. Poiché la copia è bloccata, tutti gli oggetti secondari bloccati vengono copiati in base al riferimento.

(Ereditato da Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Rende l'istanza corrente un clone bloccato dell'oggetto specificato Freezable. Se l'oggetto ha proprietà di dipendenza animate, i valori animati correnti vengono copiati.

(Ereditato da Freezable)
GetHashCode()

Ottiene un codice hash per l'oggetto DependencyObject.

(Ereditato da DependencyObject)
GetLocalValueEnumerator()

Crea un enumeratore specializzato per determinare quali proprietà di dipendenza hanno valori impostati localmente in questo DependencyObjectoggetto .

(Ereditato da DependencyObject)
GetOutput(BitmapEffectInput)
Obsoleti.

Restituisce l'oggetto BitmapSource risultante quando l'effetto viene applicato all'oggetto specificato BitmapEffectInput.
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
GetValue(DependencyProperty)

Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di un oggetto DependencyObject.

(Ereditato da DependencyObject)
InitializeBitmapEffect(SafeHandle, SafeHandle)
Obsoleti.

Inizializza un handle IMILBitmapEffect ottenuto da CreateBitmapEffectOuter() con l'oggetto IMILBitmapEffectPrimitive specificato.
InvalidateProperty(DependencyProperty)

Rivaluta il valore effettivo per la proprietà di dipendenza specificata.

(Ereditato da DependencyObject)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
OnChanged()

Chiamato quando l'oggetto corrente Freezable viene modificato.

(Ereditato da Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Questo membro supporta l'infrastruttura Windows Presentation Foundation (WPF) e non deve essere usata direttamente dal codice.

(Ereditato da Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Assicura che vengano stabiliti puntatori di contesto appropriati per un DependencyObjectType membro dati appena impostato.

(Ereditato da Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Esegue l'override dell'implementazione DependencyObject di OnPropertyChanged(DependencyPropertyChangedEventArgs) per richiamare anche i Changed gestori in risposta a una proprietà di dipendenza modificata di tipo Freezable.

(Ereditato da Freezable)
ReadLocalValue(DependencyProperty)

Restituisce il valore locale di una proprietà di dipendenza, se esistente.

(Ereditato da DependencyObject)
ReadPreamble()

Assicura che l'oggetto Freezable sia accessibile da un thread valido. Gli eredi di Freezable devono chiamare questo metodo all'inizio di qualsiasi API che legge i membri dati che non sono proprietà di dipendenza.

(Ereditato da Freezable)
SetCurrentValue(DependencyProperty, Object)

Imposta il valore di una proprietà di dipendenza senza modificarne l'origine del valore.

(Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)

Imposta il valore locale di una proprietà di dipendenza, specificato dall'identificatore della proprietà di dipendenza.

(Ereditato da DependencyObject)
SetValue(DependencyPropertyKey, Object)

Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore DependencyPropertyKey della proprietà di dipendenza.

(Ereditato da DependencyObject)
SetValue(SafeHandle, String, Object)
Obsoleti.

Imposta la proprietà specificata sul valore specificato.
ShouldSerializeProperty(DependencyProperty)

Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore per la proprietà di dipendenza specificata.

(Ereditato da DependencyObject)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
UpdateUnmanagedPropertyState(SafeHandle)
Obsoleti.

Quando sottoposto a override in una classe derivata, aggiorna gli stati della proprietà delle proprietà non gestite dell'effetto.
VerifyAccess()

Impone che il thread chiamante abbia accesso a questo DispatcherObjectoggetto .

(Ereditato da DispatcherObject)
WritePostscript()

Genera l'evento Changed per Freezable e richiama il relativo OnChanged() metodo. Le classi che derivano da Freezable devono chiamare questo metodo alla fine di qualsiasi API che modifica i membri della classe non archiviati come proprietà di dipendenza.

(Ereditato da Freezable)
WritePreamble()

Verifica che l'oggetto Freezable non sia bloccato e che sia accessibile da un contesto di threading valido. Freezable Gli eredi devono chiamare questo metodo all'inizio di qualsiasi API che scrive nei membri dati che non sono proprietà di dipendenza.

(Ereditato da Freezable)

Eventi

Nome Descrizione
Changed

Si verifica quando l'oggetto Freezable o un oggetto che contiene viene modificato.

(Ereditato da Freezable)

Si applica a

Vedi anche