FrameworkContentElement.FocusVisualStyle Proprietà

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.

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. 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

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 definita come .StaticResourceExtension

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

Concettualmente, il comportamento visivo dello stato attivo applicato a un controllo deve essere coerente dall'elemento all'elemento. 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 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 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