Control.RemoveFocusEngagement Metodo

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Controls

Rilascia lo stato attivo dai limiti del controllo per un controllo con coinvolgimento attivo (per l'interazione con il pad del gioco/remoto).

public:
 virtual void RemoveFocusEngagement() = RemoveFocusEngagement;

void RemoveFocusEngagement();

public void RemoveFocusEngagement();

function removeFocusEngagement()

Public Sub RemoveFocusEngagement ()

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

Il coinvolgimento dello stato attivo semplifica l'uso di un pad di gioco o di un controllo remoto per interagire con un'app. L'impostazione del coinvolgimento dello stato attivo non influisce sulla tastiera o su altri dispositivi di input.

Quando la proprietà IsFocusEngagementEnabled è impostata su true, contrassegna il controllo come richiesta dell'impegno 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 annullare il controllo e spostarsi da esso. È possibile chiamare RemoveFocusEngagement per annullare a livello di codice un controllo.

Per altre informazioni, vedere la sezione Coinvolgimento attivo dell'articolo Progettazione per Xbox e TV .

Compatibilità tra versioni

Il metodo RemoveFocusEngagement non è disponibile prima di Windows 10 versione 1607. Se l'impostazione "versione minima della piattaforma" dell'app in Microsoft Visual Studio è minore della versione "introdotta" visualizzata nel blocco Requisiti più avanti in questa pagina, è necessario progettare e testare l'app per l'account. Per altre informazioni, vedere Codice adattivo della versione.

Per evitare eccezioni quando l'app viene eseguita nelle versioni precedenti di Windows 10, non chiamare questo metodo senza prima eseguire un controllo di runtime. In questo esempio viene illustrato come usare la classe ApiInformation per verificare la presenza di questo metodo prima di usarla.

if (ApiInformation.IsMethodPresent("Windows.UI.Xaml.Controls.Control", "RemoveFocusEngagement"))
{
    control1.RemoveFocusEngagement();
}