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 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 SeriesVoir aussi
Vue d’ensemble de GameInputIGameInputReading
GameInputSystemButtons
GameInputKind
IGameInput::EnableBackgroundInput
IGameInputDevice::GetSupportedSystemButtons
