Condividi tramite


Control.IsFocusEngagementEnabled Proprietà

Definizione

Ottiene o imposta un valore che indica se lo stato attivo può essere vincolato all'interno dei limiti del controllo (per l'interazione remota o il game pad).

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

void IsFocusEngagementEnabled(bool value);
public bool IsFocusEngagementEnabled { get; set; }
var boolean = control.isFocusEngagementEnabled;
control.isFocusEngagementEnabled = boolean;
Public Property IsFocusEngagementEnabled As Boolean
<control IsFocusEngagementEnabled="bool"/>

Valore della proprietà

Boolean

bool

true se lo stato attivo può essere 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

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à IsFocusEngagementEnabled 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", "IsFocusEngagementEnabled"))
{
    slider1.IsFocusEngagementEnabled = true;
}

Si applica a