FrameworkContentElement.FocusVisualStyle Proprietà

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationFramework.dll

Ottiene o imposta un oggetto che consente la personalizzazione dell'aspetto, degli effetti o di altre caratteristiche di stile che verranno applicate a questo elemento quando acquisisce lo stato attivo della tastiera.

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à

Style

Stile desiderato da applicare sullo stato attivo. Il valore predefinito dichiarato nella proprietà di dipendenza è un oggetto statico Stylevuoto. Tuttavia, il valore effettivo in fase di esecuzione è spesso (ma non sempre) uno stile fornito dal supporto del tema per i controlli.

Commenti

Quando si imposta questa proprietà in XAML, gli stili vengono quasi sempre definiti come risorsa, anziché inline come elemento e tale risorsa viene in genere fatto riferimento come .StaticResourceExtension

Si noti che questa proprietà influisce sull'aspetto visivo, ma non ne segnala i metadati. Ciò è dovuto al fatto che la modifica dell'aspetto visivo è guidata dagli eventi e potrebbe non essere applicabile in qualsiasi momento e pertanto non dovrebbe in genere segnalare informazioni visive o di layout nei metadati.

Concettualmente, il comportamento visivo dello stato attivo applicato a un controllo deve essere coerente dall'elemento all'elemento. Il modo più sensato per applicare coerenza consiste nel modificare lo stile di visualizzazione dello stato attivo solo se si compone un intero tema. 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 rispetto allo stato attivo della tastiera. Se si intende un comportamento specifico dell'elemento intenzionalmente non coerente in un tema, un approccio molto migliore consiste nell'usare i trigger negli stili per le singole proprietà dello stato di input, ad esempio IsFocused o IsKeyboardFocusWithin, e a tale scopo in modo che non interferiscano visivamente con uno stile di visualizzazione dello stato attivo esistente. Per altre informazioni sull'intenzione di progettazione delle proprietà dello FocusVisualStyle stato attivo e alternative, vedere Applicazione di stili per lo stato attivo nei controlli e FocusVisualStyle.

Utilizzo degli attributi XAML

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

Utilizzo dell'elemento della proprietà XAML

Valori XAML

resourceExtension Uno dei seguenti: o . Vedi Risorse XAML.

styleResourceKey Chiave che identifica lo stile richiesto. La chiave fa riferimento a una risorsa esistente in un oggetto ResourceDictionary.

Note

La sintassi degli elementi proprietà è tecnicamente possibile, ma non consigliata. Vedere Stili e modelli inline. Un riferimento di associazione tramite TemplateBinding o Binding è anche possibile, ma non comune.

Informazioni sulle proprietà di dipendenza

Item	Value
Campo Identificatore	FocusVisualStyleProperty
Proprietà dei metadati impostate su true	Nessuno