UIElement.BitmapEffect 속성

정의

경고

이 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 사용 하려면 OuterGlowBitmapEffect와 같이 BitmapEffect의 구현 된 파생 클래스가 필요 합니다.BitmapEffect is an abstract type, therefore the XAMLXAML usage requires an implemented derived class of BitmapEffect, such as OuterGlowBitmapEffect. 구현 된 파생 클래스 중 하나는 중첩 된 태그 구문을 사용 하 여 둘 이상의 순차적 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 없음None

적용 대상