UIElement.BitmapEffect Propriété

Définition

Espace de noms:

System.Windows

Assembly:

PresentationCore.dll

Attention

Avoid using BitmapEffects as they have very poor performance characteristics. They will be deprecated in a future version. Consider using the UIElement.Effect property and ShaderEffects where appropriate instead.

Attention

BitmapEffects are deprecated and no longer function. Consider using Effects where appropriate instead.

Obtient ou définit un effet bitmap qui s'applique directement au contenu affiché pour cet élément. Il s’agit d’une propriété de dépendance.

public:
 property System::Windows::Media::Effects::BitmapEffect ^ BitmapEffect { System::Windows::Media::Effects::BitmapEffect ^ get(); void set(System::Windows::Media::Effects::BitmapEffect ^ value); };

[System.Obsolete("Avoid using BitmapEffects as they have very poor performance characteristics.  They will be deprecated in a future version.  Consider using the UIElement.Effect property and ShaderEffects where appropriate instead.")]
public System.Windows.Media.Effects.BitmapEffect BitmapEffect { get; set; }

[System.Obsolete("BitmapEffects are deprecated and no longer function.  Consider using Effects where appropriate instead.")]
public System.Windows.Media.Effects.BitmapEffect BitmapEffect { get; set; }

[<System.Obsolete("Avoid using BitmapEffects as they have very poor performance characteristics.  They will be deprecated in a future version.  Consider using the UIElement.Effect property and ShaderEffects where appropriate instead.")>]
member this.BitmapEffect : System.Windows.Media.Effects.BitmapEffect with get, set

[<System.Obsolete("BitmapEffects are deprecated and no longer function.  Consider using Effects where appropriate instead.")>]
member this.BitmapEffect : System.Windows.Media.Effects.BitmapEffect with get, set

Public Property BitmapEffect As BitmapEffect

Valeur de propriété

BitmapEffect

Effet bitmap à appliquer.

Attributs

ObsoleteAttribute

Exemples

L’exemple suivant définit un effet bitmap à l’aide BlurBitmapEffectde .

// Get a reference to the Button.
Button myButton = (Button)sender;

// Initialize a new BlurBitmapEffect that will be applied
// to the Button.
BlurBitmapEffect myBlurEffect = new BlurBitmapEffect();

// Set the Radius property of the blur. This determines how 
// blurry the effect will be. The larger the radius, the more
// blurring. 
myBlurEffect.Radius = 10;

// Set the KernelType property of the blur. A KernalType of "Box"
// creates less blur than the Gaussian kernal type.
myBlurEffect.KernelType = KernelType.Box;

// Apply the bitmap effect to the Button.
myButton.BitmapEffect = myBlurEffect;

Remarques

BitmapEffect est un type abstrait, par conséquent, l’utilisation XAML nécessite une classe dérivée implémentée de BitmapEffect, par exemple OuterGlowBitmapEffect. Notez qu’une classe dérivée implémentée est un type de collection qui vous permet de spécifier plusieurs séquences BitmapEffect, à l’aide d’une syntaxe de balise imbriquée.

Aucune classe dérivée existante ne prend en charge un convertisseur de BitmapEffect type, de sorte que la syntaxe XAML que vous utilisez pour cette propriété est généralement la syntaxe de l’élément de propriété.

Informations sur les propriétés de dépendance

Champ d’identificateur	BitmapEffectProperty
Propriétés de métadonnées définies sur true	Aucun