다음을 통해 공유


GameInputFocusPolicy

입력 장치에 대한 포커스 정책을 열거합니다.

구문

typedef enum GameInputFocusPolicy    
{  
    GameInputDefaultFocusPolicy = 0x00000000,  
    GameInputDisableBackgroundInput = 0x00000001,  
    GameInputExclusiveForegroundInput = 0x00000002,
    GameInputDisableBackgroundGuideButton   = 0x00000004,
    GameInputExclusiveForegroundGuideButton = 0x00000008,
    GameInputDisableBackgroundShareButton   = 0x00000010,
    GameInputExclusiveForegroundShareButton = 0x00000020
} GameInputFocusPolicy  

상수

상수 설명
GameInputDefaultFocusPolicy 입력은 포커스에 없는 경우에도 항상 게임에 전송됩니다. 입력 장치에 대한 기본 포커스 정책입니다.
GameInputDisableBackgroundInput 입력은 포커스가 있는 경우에만 게임에 전송됩니다. 포커스가 없는 경우 게임은 사용자가 장치와 상호 작용하지 않는 것처럼 중립 또는 "휴지" 상태 보고서를 받습니다. 시스템 단추에는 적용되지 않습니다.
GameInputExclusiveForegroundInput GameInput을 사용하는 다른 프로세스에서 받은 입력을 볼 수 없게 합니다. 이 제한은 게임이 포커스 상태일 때에만 적용됩니다. 시스템 단추에는 적용되지 않습니다.
GameInputDisableBackgroundGuideButton 가이드 버튼 이벤트는 포커스가 있는 경우에만 게임에 전송됩니다. 가이드 단추는 게임이 포커스가 없을 때 누르지 않는 것으로 보고됩니다.
GameInputExclusiveForegroundGuideButton GameInput을 사용하는 다른 프로세스에서 수신한 가이드 버튼 누르기를 볼 수 없게 합니다. 이 제한은 게임이 포커스 상태일 때에만 적용됩니다.
GameInputDisableBackgroundShareButton 공유 단추 이벤트는 포커스가 있는 경우에만 게임에 전송됩니다. 공유 단추는 게임이 포커스가 없을 때 누르지 않은 것으로 보고됩니다.
GameInputExclusiveForegroundShareButton GameInput을 사용하는 다른 프로세스에서 받은 공유 단추 누르기를 볼 수 없게 합니다. 이 제한은 게임이 포커스 상태일 때에만 적용됩니다.

비고

이 열거형은 IGameInput::SetFocusPolicy 메서드에서 사용됩니다. 포커스에 없는 경우 게임에 입력을 보낼지 여부를 지정하려면 SetFocusPolicy를 호출합니다. 기본적으로 입력은 포커스 여부와 관계 없이 모든 프로세스에 브로드캐스트됩니다. 값을 결합할 수 있습니다.

게임에서 가이드 또는 공유 단추를 처리하는 경우 GameInputExclusiveForegroundGuideButton 또는 GameInputExclusiveForegroundShareButton 플래그를 각각 설정하면 백그라운드 오버레이 애플리케이션도 이를 처리하지 않도록 할 수 있습니다. 예를 들어 이렇게 하면 단추 자체를 사용하려는 게임에 원치 않는 오버레이 메뉴 또는 스크린샷이 표시되지 않도록 방지할 수 있습니다.

참고 항목

많은 사용자가 메뉴에 가이드 단추를 사용하고 스크린샷에 공유 단추를 사용하는 오버레이 애플리케이션을 사용합니다. 사용자 혼동을 피하기 위해 게임에서 해당 기능을 재정의해야 하는지 여부를 고려합니다. 포커스 정책은 Windows에만 적용됩니다. GameInputFocusPolicy의 가이드 및 공유 단추 값은 Windows SDK 10.0.26031 Preview GameInput.h에 추가되었으며 향후 GDK 릴리스에 추가될 예정입니다.

자세한 내용은 GameInput 기본 사항을 참조하세요.

요구 사항

헤더: GameInput.h

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

GameInput 개요
GameInput