UIElement.BitmapEffect UIElement.BitmapEffect UIElement.BitmapEffect UIElement.BitmapEffect Property

定義

警告

この API は現在使われていません。

この要素に描画された内容に直接適用するビットマップ効果を取得または設定します。Gets or sets a bitmap effect that applies directly to the rendered content for this element. これは依存関係プロパティです。This is a dependency property.

public:
 property System::Windows::Media::Effects::BitmapEffect ^ BitmapEffect { System::Windows::Media::Effects::BitmapEffect ^ get(); void set(System::Windows::Media::Effects::BitmapEffect ^ value); };
[System.Obsolete("BitmapEffects are deprecated and no longer function.  Consider using Effects where appropriate instead.")]
[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; }
member this.BitmapEffect : System.Windows.Media.Effects.BitmapEffect with get, set
Public Property BitmapEffect As BitmapEffect

プロパティ値

適用するビットマップ効果。The bitmap effect to apply.

次の例では、を使用しBlurBitmapEffectてビットマップ効果を設定します。The following example sets a bitmap effect, using BlurBitmapEffect.

// 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;

注釈

BitmapEffectは抽象型であるため、 XAMLXAMLを使用するには、のBitmapEffect実装さOuterGlowBitmapEffectれた派生クラス (など) が必要です。BitmapEffect is an abstract type, therefore the XAMLXAML usage requires an implemented derived class of BitmapEffect, such as OuterGlowBitmapEffect. 実装された派生クラスの1つは、入れ子になったタグ構文を使用BitmapEffectして複数のシーケンシャルを指定できるコレクション型であることに注意してください。Note that one implemented derived class is a collection type that allows you to specify more than one sequential BitmapEffect, using a nested tag syntax.

型コンバーターをサポートするBitmapEffectの既存の派生クラスがないXAMLXAMLため、このプロパティに使用する構文は一般にプロパティ要素の構文です。No existing derived class of BitmapEffect supports a type converter, so the XAMLXAML syntax that you use for this property is generally property element syntax.

依存プロパティ情報Dependency Property Information

識別子フィールドIdentifier field BitmapEffectProperty
メタデータプロパティがに設定されるtrueMetadata properties set to true NoneNone

適用対象