구문
매개변수
buttons _Out_형식: GameInputSystemButtons* 이 판독값에서 눌려 있는 시스템 버튼 집합을 받습니다.
반환값
형식: bool 판독값에 시스템 버튼 상태가 포함되어 있으면true를 반환합니다. 포함되어 있지 않으면 false를 반환하며, 이 경우 buttons는 GameInputSystemButtonNone으로 설정됩니다.
설명
GameInput v4에서 시스템 버튼은 일반적인 입력 종류인GameInputKindSystemButton입니다. 시스템 버튼이 있는 장치의 모든 판독값은 IGameInputReading::GetInputKind에 GameInputKindSystemButton을 포함하며, GetSystemButtonState는 IGameInputReading::GetGamepadState가 게임패드 버튼의 상태를 반환하는 것과 같은 방식으로 해당 버튼의 현재 상태를 반환합니다. 장치에 있는 시스템 버튼을 확인하려면 IGameInputDevice::GetSupportedSystemButtons를 호출하세요.
판독값은 누름 또는 놓음 이벤트가 아니라 어떤 버튼이 눌려 있는지를 보고합니다. 누름 또는 놓음을 감지하려면 상태를 이전 판독값의 상태와 비교하세요.
이 메서드는 이전 버전 GameInput의 IGameInput::RegisterSystemButtonCallback 메서드를 대체합니다. 시스템 버튼 입력을 받으려면 GameInputKindSystemButton과 함께 IGameInput::RegisterReadingCallback을 사용하거나 IGameInput::GetCurrentReading으로 폴링하세요.
IGameInput::EnableBackgroundInput으로 백그라운드 입력을 활성화하지 않는 한, 시스템 버튼 입력은 애플리케이션이 포커스를 갖고 있는 동안에만 전달됩니다.
다음 예제는 Guide 버튼의 새로운 누름을 감지하는 방법을 보여줍니다.
요구 사항
헤더: GameInput.h 라이브러리: gameinput.lib 지원되는 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔함께 보기
GameInput 개요IGameInputReading
GameInputSystemButtons
GameInputKind
IGameInput::EnableBackgroundInput
IGameInputDevice::GetSupportedSystemButtons
