FrameworkContentElement.FocusVisualStyle Özellik

Tanım

Klavye odağını yakaladığında bu öğe için uygulanacak görünüm, efekt veya diğer stil özelliklerinin özelleştirilmesine olanak tanıyan bir nesne alır veya ayarlar.Gets or sets an object that enables customization of appearance, effects, or other style characteristics that will apply to this element when it captures keyboard focus.

public:
 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

Özellik Değeri

Style

Odağa uygulamak için istenen stil.The desired style to apply on focus. Dependency özelliğinde bildirildiği şekilde varsayılan değer boş bir statiktir Style .The default value as declared in the dependency property is an empty static Style. Ancak, çalışma zamanında etkin değer genellikle denetimler için Tema desteği tarafından sağlanan bir stil olarak (her zaman değildir).However, the effective value at run time is often (but not always) a style as supplied by theme support for controls.

Açıklamalar

İçindeki bu özelliği ayarlarken, XAMLXAML Stiller bir öğe olarak satır içi değil, neredeyse her zaman bir kaynak olarak tanımlanır ve bu kaynağa genellikle bir olarak başvurulur StaticResourceExtension .When setting this property in XAMLXAML, styles are almost always defined as a resource, rather than inline as an element, and that resource is usually referenced as a StaticResourceExtension.

Bu özelliğin görsel görünümü etkilediğini ancak meta verilerde bu şekilde raporlanmadığını unutmayın.Note that this property affects visual appearance but does not report so in metadata. Bunun nedeni, görsel görünüm değişikliğinin olay odaklı olması ve her zaman uygulanmamasının yanı sıra meta verilerde hiçbir görsel veya Düzen bilgisini bildirmemelidir.This is because the visual appearance change is event-driven and may not apply at all times, and thus should not generally report any visual or layout information in metadata.

Kavramsal olarak, bir denetime uygulanan odağın görsel davranışı öğeden öğe arasında tutarlı olmalıdır.Conceptually, the visual behavior of focus applied to a control should be coherent from element to element. Tutarlılığı sağlamanın en uygun yolu, yalnızca temanın tamamını oluşturuyorsanız odak görsel stilini değiştirkullanmaktır.The most sensible way to enforce coherence is to only change the focus visual style if you are composing an entire theme. Bu özelliği bir temanın parçası olarak değil tek tek stillerde ayarlamak, bu özelliğin amaçlanan kullanımı değildir çünkü klavye odağıyla ilgili karmaşık bir kullanıcı deneyimine yol açabilir.Setting this property on individual 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. Bir temaya uygun olmayan öğeye özgü davranışları kullandıysanız, veya gibi ayrı giriş durumu özelliklerinin stillerinde tetiklerinin kullanılması IsFocused IsKeyboardFocusWithin ve bunu mevcut odak görsel stiliyle görsel olarak kesintiye uğramayan bir şekilde yapmak daha iyi bir yaklaşımdır.If you are intending element-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. Tasarım amacı ve alternatif odak özellikleri hakkında daha fazla bilgi için FocusVisualStyle bkz. denetimlerde odak için stil oluşturma ve FocusVisualStyle.For more information on the design intention of FocusVisualStyle and alternative focus properties, see Styling for Focus in Controls, and FocusVisualStyle.

XAML Öznitelik KullanımıXAML Attribute Usage

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

XAML Özellik Öğesi KullanımıXAML Property Element Usage

XAML DeğerleriXAML Values

resourceExtensionresourceExtension
Aşağıdakilerden biri:, veya.One of the following: , or . Bkz. xaml kaynakları.See XAML Resources.

styleResourceKeystyleResourceKey
İstenen stili tanımlayan anahtar.The key that identifies the style being requested. Anahtar, içindeki var olan bir kaynağı ifade eder ResourceDictionary .The key refers to an existing resource in a ResourceDictionary.

Not

Özellik öğesi sözdizimi teknik açıdan olasıdır, ancak önerilmez.Property element syntax is technically possible, but not recommended. Bkz. satır Içi stiller ve şablonlar.See Inline Styles and Templates. TemplateBinding veya Binding , yaygın olarak kullanılan bir bağlama başvurusu.A binding reference using TemplateBinding or Binding is also possible, but uncommon.

Bağımlılık Özelliği BilgileriDependency Property Information

Tanımlayıcı alanıIdentifier field FocusVisualStyleProperty
Meta veri özellikleri olarak ayarlandı trueMetadata properties set to true YokNone

Şunlara uygulanır