Syntaxe
Paramètres
enable _In_Type : bool
true pour recevoir les entrées lorsque l’application n’a pas le focus; false pour recevoir les entrées uniquement lorsque l’application a le focus.
Valeur de retour
Type : void Cette méthode ne retourne aucune valeur.Remarques
Par défaut, GameInput transmet les entrées à une application uniquement lorsqu’elle est au premier plan et qu’elle a le focus. AppelezEnableBackgroundInput(true) pour recevoir également les entrées lorsqu’une autre application a le focus. Les entrées en arrière-plan s’appliquent à tous les types d’entrée à la fois, y compris les boutons système Guide et Partager signalés au moyen de IGameInputReading::GetSystemButtonState. Appelez EnableBackgroundInput(false) pour revenir au comportement par défaut.
Ce paramètre est surtout pertinent sur Windows, où plusieurs applications peuvent s’exécuter côte à côte et où le focus peut passer de l’une à l’autre.
Cette méthode remplace la méthode IGameInput::SetFocusPolicy et l’énumération GameInputFocusPolicy des versions antérieures de GameInput. Les stratégies exclusives au premier plan, qui empêchaient d’autres processus de recevoir les entrées, ne sont pas disponibles dans GameInput v4.
Sur PC, lorsque le runtime GameInput est chargé latéralement avec l’application plutôt qu’installé sur le système, l’activation des entrées en arrière-plan est ignorée. Pour plus d’informations, consultez Chargement latéral de GameInput.
De nombreux utilisateurs exécutent des applications de superposition qui utilisent le bouton Guide pour les menus et le bouton Partager pour les captures d’écran. Déterminez si votre application a besoin de traiter les boutons système lorsqu’elle est en arrière-plan.
Configuration requise
En-tête : GameInput.h Bibliothèque : gameinput.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX SeriesVoir aussi
Vue d’ensemble de GameInputNotions fondamentales de GameInput
Chargement latéral de GameInput
IGameInput
IGameInput::SetFocusPolicy (déprécié)