Passer au contenu principal
Récupère l’état des boutons système, comme les boutons Guide et Partager, à partir d’une lecture d’entrée.

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 Retourne true 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 Series

Voir aussi

Vue d’ensemble de GameInput
IGameInputReading
GameInputSystemButtons
GameInputKind
IGameInput::EnableBackgroundInput
IGameInputDevice::GetSupportedSystemButtons

Historique des versions

Dernière modification le 6 novembre 2026