FrameworkElement.FocusVisualStyle Property


키보드 포커스를 캡처할 때 이 요소에 적용되는 모양, 효과 또는 기타 스타일 특성을 사용자 지정할 수 있는 속성을 가져오거나 설정합니다.Gets or sets a property that enables customization of appearance, effects, or other style characteristics that will apply to this element when it captures keyboard focus.

 property System::Windows::Style ^ FocusVisualStyle { System::Windows::Style ^ get(); void set(System::Windows::Style ^ value); };
public System.Windows.Style FocusVisualStyle { get; set; }
member this.FocusVisualStyle : System.Windows.Style with get, set
Public Property FocusVisualStyle As Style

Property Value


포커스에 적용하려는 스타일입니다.The desired style to apply on focus. 종속성 속성에 선언된 기본값은 빈 정적 Style입니다.The default value as declared in the dependency property is an empty static Style. 그러나 런타임 시 유효 값은 대체로(항상 그렇지는 않음) 컨트롤에 대한 테마 지원에서 제공되는 스타일입니다.However, the effective value at run time is often (but not always) a style as supplied by theme support for controls.


이 속성은 시각적 모양에 영향을 주지만 메타 데이터에 AffectsRender 보고 하지 않습니다.This property affects visual appearance but does not report AffectsRender in metadata. 시각적 모양 변경 이벤트 구동 모든 시간에 적용 되지 않을 수 고 따라서은 일반적으로 보고 메타 데이터의 시각적 개체 또는 레이아웃 정보가 때문입니다.This is because the visual appearance change is event-driven and may not apply at all times, and therefore should not generally report any visual or layout information in metadata.

개념적으로 컨트롤에 적용 되는 포커스의 시각적 동작 컨트롤 간에 일관 된 있어야 합니다.Conceptually, the visual behavior of focus applied to a control should be coherent from control to control. 일관성을 적용 하는 가장 적절 한 방법은 전체 테마를 작성 하는 경우에 포커스 비주얼 스타일을 변경 하는 경우The most sensible way to enforce coherence is to only change the focus visual style if you are composing an entire theme. 테마의 일부가 아니라 개별 컨트롤 스타일에서이 속성을 설정할 수는 없습니다.Setting this property on individual control styles and not as part of a theme is not the intended usage of this property, because it may lead to a confusing user experience regarding keyboard focus. 테마에서 의도적으로 일관 되지 않은 컨트롤 특정 동작을 의도 한 경우, IsFocused 또는 IsKeyboardFocusWithin와 같은 개별 입력 상태 속성에 대해 스타일에서 트리거를 사용 하 고 기존 포커스 비주얼 스타일을 시각적으로 방해 하지 않는 방식으로이 작업을 수행 하는 것이 훨씬 더 좋은 방법입니다.If you are intending control-specific behavior that is deliberately not coherent across a theme, a much better approach is to use triggers in styles for individual input state properties, such as IsFocused or IsKeyboardFocusWithin, and to do so in a way that does not visually interfere with any existing focus visual style. FocusVisualStyle 및 대체 포커스 속성의 디자인 의도에 대 한 자세한 내용은 컨트롤의 포커스 스타일 지정 및 FocusVisualStyle을 참조 하세요.For more information on the design intention of FocusVisualStyle and alternative focus properties, see Styling for Focus in Controls, and FocusVisualStyle.

XAML 특성 사용XAML Attribute Usage

<object FocusVisualStyle="{resourceExtension styleResourceKey}"/>  

XAML 속성 요소 사용XAML Property Element Usage


다음 중 하나:, 또는 합니다.One of the following: , or . 참조 XAML 리소스합니다.See XAML Resources.

요청 되는 스타일을 식별 하는 키입니다.The key that identifies the style being requested. 키의 기존 리소스에 참조를 ResourceDictionary입니다.The key refers to an existing resource in a ResourceDictionary.


속성 요소 구문은 기술적으로 가능 하지만 권장 하지는 않습니다.Property element syntax is technically possible, but not recommended. 참조 인라인 스타일 및 템플릿합니다.See Inline Styles and Templates. TemplateBinding 또는 Binding를 사용 하는 바인딩 참조도 가능 하지만 일반적이 지 않습니다.A binding reference using TemplateBinding or Binding is also possible, but uncommon.

종속성 속성 정보Dependency Property Information

식별자 필드Identifier field FocusVisualStyleProperty
메타 데이터 속성 설정 trueMetadata properties set to true 없음None

Applies to

See also