FrameworkElement.FocusVisualStyle Proprietà

Definizione

Ottiene o imposta una proprietà 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.

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 allo stato attivo. Il valore predefinito dichiarato nella proprietà di dipendenza è un oggetto Style statico vuoto. Tuttavia, il valore effettivo in fase di esecuzione è spesso, ma non sempre, uno stile specificato dal supporto dei temi per i controlli.

Commenti

Questa proprietà influisce sull'aspetto visivo, ma non sui AffectsRender 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 deve in genere segnalare informazioni sull'oggetto visivo o sul layout nei metadati.

Concettualmente, il comportamento visivo dello stato attivo applicato a un controllo deve essere coerente dal controllo al controllo. Il modo più ragionevole per applicare la 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 di controllo e non come parte di un tema non è l'utilizzo previsto di questa proprietà, perché può causare confusione nell'esperienza utente relativa allo stato attivo della tastiera. Se si intende un comportamento specifico del controllo deliberatamente 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 IsKeyboardFocusWithine per farlo 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.

Uso della sintassi XAML per gli attributi

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

Utilizzo della sintassi XAML per elementi proprietà

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.

Nota

La sintassi degli elementi di 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 proprietà di dipendenza

Campo Identificatore FocusVisualStyleProperty
Proprietà dei metadati impostate su true Nessuno

Si applica a

Vedi anche