Condividi tramite

BitmapEffect Classe

  • Riferimento

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 applicabili a un oggetto Visual, ad esempio un Button o un 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

Nota

Gli effetti bitmap WPF sono sottoposti a rendering software. e anche qualsiasi oggetto che applica un effetto verrà sottoposto a rendering in modalità software. Gli effetti bitmap non devono essere applicati a oggetti visivi o animazioni di grandi dimensioni, perché ciò può ridurre le prestazioni.

Attenzione

Gli effetti bitmap non supportano l'esecuzione parziale dell'attendibilità. Per l'uso degli effetti bitmap, un'applicazione deve disporre di autorizzazioni di attendibilità completa.

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

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

Gli effetti personalizzati ereditano questa classe per creare un'interfaccia gestita all'effetto non gestito. Per altre informazioni, vedere l'API BitmapEffect non gestita .

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 in combinazione con SetValue(SafeHandle, String, Object) per aggiornare le proprietà non gestite.

Costruttori

BitmapEffect()

Inizializza una nuova istanza della classe BitmapEffect.

Proprietà

CanFreeze

Ottiene un valore che indica se l'oggetto può essere impostato come 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 Dispatcher associato a DispatcherObject.

(Ereditato da DispatcherObject)
HasAnimatedProperties

Ottiene un valore che indica se uno o più oggetti AnimationClock sono associati a una qualsiasi 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 l'istanza è attualmente sealed (di sola lettura).

(Ereditato da DependencyObject)

Metodi

ApplyAnimationClock(DependencyProperty, AnimationClock)

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

(Ereditato da Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Applica un oggetto AnimationClock all'oggetto DependencyProperty specificato. Se alla proprietà è già stata aggiunta un'animazione, viene utilizzato l'oggetto HandoffBehavior specificato.

(Ereditato da Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)

Applica un'animazione all'oggetto DependencyProperty specificato. L'animazione viene avviata quando viene eseguito il rendering del fotogramma successivo. Se alla proprietà specificata è già applicata un'animazione, viene usato il comportamento di continuità di SnapshotAndReplace.

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

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

(Ereditato da Animatable)
CheckAccess()

Determina se il thread chiamante ha accesso a DispatcherObject.

(Ereditato da DispatcherObject)
ClearValue(DependencyProperty)

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

(Ereditato da DependencyObject)
ClearValue(DependencyPropertyKey)

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

(Ereditato da DependencyObject)
Clone()

Crea un clone modificabile di questo oggetto BitmapEffect, eseguendo copie complete dei valori dell'oggetto. Durante la copia delle proprietà di dipendenza, questo metodo copia i riferimenti alle risorse e i data binding (che potrebbero non essere più risolti), ma non le animazioni né i relativi valori correnti.
CloneCore(Freezable)

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

(Ereditato da Freezable)
CloneCurrentValue()

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

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

(Ereditato da Freezable)
CoerceValue(DependencyProperty)

Assegna forzatamente il valore della proprietà di dipendenza specificata. Questa operazione viene eseguita richiamando qualsiasi funzione CoerceValueCallback specificata nei metadati della proprietà di dipendenza esistente nell'oggetto DependencyObject chiamante.

(Ereditato da DependencyObject)
CreateBitmapEffectOuter()
Obsoleti.

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

Inizializza una nuova istanza della classe Freezable.

(Ereditato da Freezable)
CreateInstanceCore()

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

(Ereditato da Freezable)
CreateUnmanagedEffect()
Obsoleti.

Quando se ne esegue l'override in una classe derivata, viene creato un clone dell'effetto non gestito.
Equals(Object)

Determina se l'oggetto DependencyObject specificato equivale all'oggetto DependencyObject corrente.

(Ereditato da DependencyObject)
Freeze()

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

(Ereditato da Freezable)
FreezeCore(Boolean)

Rende immodificabile questo oggetto Animatable o determina se l'oggetto può essere reso immodificabile.

(Ereditato da Animatable)
GetAnimationBaseValue(DependencyProperty)

Restituisce il valore non animato dell'oggetto DependencyProperty specificato.

(Ereditato da Animatable)
GetAsFrozen()

Crea una copia bloccata di Freezable, utilizzando valori delle proprietà di base (non-animati). Dato che la copia è bloccata, gli oggetti secondari bloccati sono copiati dal riferimento.

(Ereditato da Freezable)
GetAsFrozenCore(Freezable)

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

(Ereditato da Freezable)
GetCurrentValueAsFrozen()

Crea una copia bloccata di Freezable utilizzando valori della proprietà correnti. Dato che la copia è bloccata, gli oggetti secondari bloccati sono copiati dal riferimento.

(Ereditato da Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Rende l'istanza corrente un clone bloccato dell'oggetto Freezable specificato. 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 le proprietà di dipendenza che presentano valori impostati localmente nell'oggetto DependencyObject.

(Ereditato da DependencyObject)
GetOutput(BitmapEffectInput)
Obsoleti.

Restituisce l'oggetto BitmapSource che risulta quando l'effetto viene applicato all'oggetto BitmapEffectInputspecificato.
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
GetValue(DependencyProperty)

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

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

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

Valuta di nuovo il valore effettivo della proprietà di dipendenza specificata.

(Ereditato da DependencyObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
OnChanged()

Chiamato quando viene modificato l'oggetto Freezable corrente.

(Ereditato da Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Assicura che adatti puntatori del contesto siano stabiliti per un membro dati DependencyObjectType che è appena stato impostato.

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

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

(Ereditato da Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Esegue l'override dell'implementazione di DependencyObject di OnPropertyChanged(DependencyPropertyChangedEventArgs) per richiamare anche eventuali gestori Changed in risposta alla modifica di una proprietà di dipendenza 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’accesso di Freezable sia stato eseguito da un thread valido. Gli eredi di Freezable devono chiamare questo metodo all'inizio di qualsiasi API che legge i membri dei dati che non sono proprietà della dipendenza.

(Ereditato da Freezable)
SetCurrentValue(DependencyProperty, Object)

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

(Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)

Imposta il valore locale di una proprietà di dipendenza, specificato dal relativo 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 al valore indicato.
ShouldSerializeProperty(DependencyProperty)

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

(Ereditato da DependencyObject)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
UpdateUnmanagedPropertyState(SafeHandle)
Obsoleti.

Quando ne viene eseguito l'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 DispatcherObject.

(Ereditato da DispatcherObject)
WritePostscript()

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

(Ereditato da Freezable)
WritePreamble()

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

(Ereditato da Freezable)

Eventi

Changed

Si verifica quando Freezable o un oggetto che contiene è modificato.

(Ereditato da Freezable)

Si applica a

Vedi anche