Syntaxe
Paramètres
buttons _Out_Type : GameInputSystemButtons* Reçoit l’ensemble des boutons système enfoncés dans cette lecture.
Valeur de retour
Type : bool Retournetrue si la lecture contient l’état des boutons système. Retourne false dans le cas contraire; buttons est alors défini à GameInputSystemButtonNone.
Remarques
Dans GameInput v4, les boutons système constituent un type d’entrée ordinaire,GameInputKindSystemButton. Chaque lecture d’un périphérique doté de boutons système inclut GameInputKindSystemButton dans IGameInputReading::GetInputKind, et GetSystemButtonState retourne l’état actuel de ces boutons de la même façon que IGameInputReading::GetGamepadState retourne l’état des boutons de la manette de jeu. Pour savoir quels boutons système un périphérique possède, appelez IGameInputDevice::GetSupportedSystemButtons.
La lecture indique quels boutons sont enfoncés, et non des événements d’appui ou de relâchement. Pour détecter un appui ou un relâchement, comparez l’état avec celui de la lecture précédente.
Cette méthode remplace la méthode IGameInput::RegisterSystemButtonCallback des versions antérieures de GameInput. Utilisez IGameInput::RegisterReadingCallback avec GameInputKindSystemButton, ou interrogez IGameInput::GetCurrentReading, pour recevoir les entrées des boutons système.
Les entrées des boutons système ne sont transmises que lorsque l’application a le focus, sauf si les entrées en arrière-plan sont activées avec IGameInput::EnableBackgroundInput.
L’exemple suivant montre comment détecter un nouvel appui sur le bouton Guide.
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 GameInputIGameInputReading
GameInputSystemButtons
GameInputKind
IGameInput::EnableBackgroundInput
IGameInputDevice::GetSupportedSystemButtons
