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. L’entrée en arrière-plan s’applique simultanément à tous les types d’entrée, y compris les boutons système Guide et Partager signalés via IGameInputReading::GetSystemButtonState. Appelez EnableBackgroundInput(false) pour revenir au comportement par défaut.
Ce paramètre concerne principalement 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 de premier plan exclusif, qui empêchaient d’autres processus de recevoir des entrées, ne sont pas disponibles dans GameInput v4.
Sur PC, lorsque le runtime GameInput est chargé de manière indépendante avec l’application au lieu d’être installé sur le système, l’activation de l’entrée en arrière-plan est ignorée. Pour plus d’informations, consultez Chargement indépendant de GameInput.
De nombreux utilisateurs exécutent des applications de superposition qui se servent du bouton Guide pour les menus et du 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 indépendant de GameInput
IGameInput
IGameInput::SetFocusPolicy (déconseillé)