Control.IsFocusEngaged Proprietà

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Controls

Ottiene o imposta un valore che indica se lo stato attivo è vincolato all'interno dei limiti del controllo (per l'interazione tra game pad e remoto).

public:
 property bool IsFocusEngaged { bool get(); void set(bool value); };

bool IsFocusEngaged();

void IsFocusEngaged(bool value);

public bool IsFocusEngaged { get; set; }

var boolean = control.isFocusEngaged;
control.isFocusEngaged = boolean;

Public Property IsFocusEngaged As Boolean

<control IsFocusEngaged="bool"/>

Valore della proprietà

Boolean

bool

true se lo stato attivo è vincolato entro i limiti del controllo; in caso contrario, false.

Requisiti Windows

Famiglia di dispositivi	Windows 10 Anniversary Edition (è stato introdotto in 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v3.0)

Commenti

IsFocusEngagementEnabled deve essere true e il controllo deve avere lo stato attivo prima di impostare la proprietà IsFocusEngaged su true. In caso contrario, si verificherà un'eccezione di runtime.

L'attivazione dello stato attivo semplifica l'uso di un game pad o di un telecomando per interagire con un'app. L'impostazione dell'attivazione dello stato attivo non influisce sulla tastiera o su altri dispositivi di input.

Quando la proprietà IsFocusEngagementEnabled è impostata su true, contrassegna il controllo come che richiede l'attivazione dello stato attivo. L'utente deve pertanto premere il pulsante A/Seleziona per "attivare" il controllo e interagire con esso. Al termine, possono premere il pulsante B/Indietro per allontanare il controllo e allontanarlo.

Per altre info su questa proprietà, vedi la sezione Attivazione dello stato attivo dell'articolo Progettazione per Xbox e TV .

Compatibilità tra versioni

La proprietà IsFocusEngaged non è disponibile prima di Windows 10 versione 1607. Se l'impostazione "versione minima della piattaforma" dell'app in Microsoft Visual Studio è inferiore alla "versione introdotta" visualizzata nel blocco Requisiti più avanti in questa pagina, è necessario progettare e testare l'app per tenere conto di questo aspetto. Per altre info, vedi Codice adattivo per la versione.

Per evitare eccezioni quando l'app viene eseguita nelle versioni precedenti di Windows 10, non impostare questa proprietà in XAML o usarla senza eseguire un controllo di runtime. Questo esempio mostra come usare la classe ApiInformation per verificare la presenza di questa proprietà prima di impostarla.

if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.Control", "IsFocusEngaged"))
{
    slider1.IsFocusEngaged = true;
}