FrameworkContentElement.FocusVisualStyle FrameworkContentElement.FocusVisualStyle FrameworkContentElement.FocusVisualStyle FrameworkContentElement.FocusVisualStyle Property

Definizione

Ottiene o imposta un oggetto che consente la personalizzazione dell'aspetto, degli effetti o di altre caratteristiche di stile che si applicheranno a questo elemento quando acquisisce lo stato attivo della tastiera.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

Valore della proprietà

Stile desiderato da applicare allo stato attivo.The desired style to apply on focus. Il valore predefinito dichiarato nella proprietà di dipendenza è un oggetto Style statico vuoto.The default value as declared in the dependency property is an empty static Style. Tuttavia, il valore effettivo in fase di esecuzione è spesso, ma non sempre, uno stile specificato dal supporto dei temi per i controlli.However, the effective value at run time is often (but not always) a style as supplied by theme support for controls.

Commenti

Quando si imposta questa proprietà XAMLXAMLin, gli stili vengono quasi sempre definiti come una risorsa, anziché inline come elemento, e a tale risorsa viene in genere fatto riferimento StaticResourceExtensioncome.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.

Si noti che questa proprietà influiscono sull'aspetto visivo, ma non segnala i metadati.Note that this property affects visual appearance but does not report so in metadata. Ciò è dovuto al fatto che la modifica apportata all'aspetto visivo è basata sugli eventi e potrebbe non essere applicata in qualsiasi momento, pertanto non dovrebbe in genere segnalare eventuali informazioni visive o di layout nei metadati.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.

Dal punto di vista concettuale, il comportamento visivo dello stato attivo applicato a un controllo deve essere coerente da elemento a elemento.Conceptually, the visual behavior of focus applied to a control should be coherent from element to element. Il modo più sensato per applicare la coerenza consiste nel modificare lo stile di visualizzazione dello stato attivo solo se si compone un tema intero.The most sensible way to enforce coherence is to only change the focus visual style if you are composing an entire theme. L'impostazione di questa proprietà su singoli stili e non come parte di un tema non è l'utilizzo previsto di questa proprietà, perché può causare un'esperienza utente confusa sullo stato attivo della tastiera.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. Se si intende un comportamento specifico dell'elemento che non è intenzionalmente coerente in un tema, un approccio molto più efficace consiste nell'usare i trigger negli stili per le singole proprietà dello stato di input, IsFocused ad IsKeyboardFocusWithinesempio o, e a tale scopo in un modo che non interferisce visivamente con qualsiasi stile di visualizzazione dello stato attivo esistente.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. Per ulteriori informazioni sull'intenzione di progettazione e FocusVisualStyle sulle proprietà dello stato attivo alternative, vedere applicazione di stili per lo stato attivo nei controlli e FocusVisualStyle.For more information on the design intention of FocusVisualStyle and alternative focus properties, see Styling for Focus in Controls, and FocusVisualStyle.

Uso della sintassi XAML per gli attributiXAML Attribute Usage

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

Utilizzo della sintassi XAML per elementi proprietàXAML Property Element Usage

Valori XAMLXAML Values

resourceExtensionresourceExtension
Uno dei seguenti:, o.One of the following: , or . Vedere risorse XAML.See XAML Resources.

styleResourceKeystyleResourceKey
Chiave che identifica lo stile richiesto.The key that identifies the style being requested. La chiave fa riferimento a una risorsa esistente in ResourceDictionaryun oggetto.The key refers to an existing resource in a ResourceDictionary.

Nota

La sintassi degli elementi proprietà è tecnicamente possibile, ma non consigliata.Property element syntax is technically possible, but not recommended. Vedere stili e modelli inline.See Inline Styles and Templates. Un riferimento di associazione che utilizza TemplateBinding Binding o è anche possibile, ma non comune.A binding reference using TemplateBinding or Binding is also possible, but uncommon.

Informazioni proprietà di dipendenzaDependency Property Information

Campo identificatoreIdentifier field FocusVisualStyleProperty
Proprietà dei metadati impostate sutrueMetadata properties set to true nessunoNone

Si applica a