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 sur GameInputSystemButtonNone.

Remarques

Dans GameInput v4, les boutons système constituent un type d’entrée ordinaire, GameInputKindSystemButton. Chaque lecture provenant 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. Pour savoir de quels boutons système dispose un périphérique, appelez IGameInputDevice::GetSupportedSystemButtons. La lecture indique les boutons enfoncés, et non les é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 l’entrée des boutons système. L’entrée des boutons système n’est remise que lorsque l’application a le focus, sauf si l’entrée en arrière-plan est activée 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