DGRegisterHotKey

주어진 다이얼로그에 대하여 핫키를 등록합니다.

    short DGRegisterHotKey (
      short  dialId,
      short  modifier,
      short  keyCode
    );

파라미터

dialId

다이얼로그의 ID입니다. DG_TOP_MODAL은 최상위 Modal 다이얼로그를 지정합니다.

modifier

원하는 수식어(modifier) 키들에 대하여 다음 값들의 아무 조합을 사용할 수 있습니다:

값	Macintosh	Windows
`DG_MOD_COMMAND`	Command (Apple)	Ctrl
`DG_MOD_OPTION`	Option	Alt
`DG_MOD_SHIFT`	Shift	Shift

keyCode

문자 키 코드 또는 다음 특수 키 코드들 중 하나입니다:

값	의미
`DG_KEY_BACK`	Backspace 키.
`DG_KEY_TAB`	Tab 키.
`DG_KEY_ENTER`	Enter 키.
`DG_KEY_RETURN`	Return 키.
`DG_KEY_ESCAPE`	Escape 키.
`DG_KEY_LEFT`	왼쪽 화살표 키.
`DG_KEY_RIGHT`	오른쪽 화살표 키.
`DG_KEY_UP`	위쪽 화살표 키.
`DG_KEY_DOWN`	아래쪽 화살표 키.
`DG_KEY_DELETE`	Delete 키.
`DG_KEY_HOME`	Home 키.
`DG_KEY_END`	End 키.
`DG_KEY_PAGEUP`	Page up 키.
`DG_KEY_PAGEDOWN`	Page down 키.

리턴 값

만약 등록이 성공하면 핫키의 1-기반 인덱스입니다. 만약 오류가 발생하면 0입니다.

설명

핫키는 다이얼로그에 대하여 DG_MSG_HOTKEY 메시지를 생성하는 키스트로크 또는 키스트로크들의 조합입니다. DG의 핫키들은 메뉴 가속기 및 운영체제 단축키와 비슷합니다. 이것들은 또한 메뉴와 툴바보다 더 빠르고, 자주 사용하는 커맨드들에게 더욱 직접적인 접근을 할 수 있게 해줍니다. 게다가, 이것들은 일부 특수 기능들을 갖고 있습니다. (DG_MSG_HOTKEY 메시지의 설명을 보십시오)

어떤 타입의 다이얼로그라도 DGRegisterHotKey 함수를 호출하여 핫키들을 등록할 수 있습니다. 만약 핫키가 성공적으로 등록되면, 나중에 DGRegisterHotKey가 리턴하는 short 식별자에 의해 참조되어야 합니다. 하나의 핫키를 여러 개의 다이얼로그에 등록할 수 있습니다. 만약 어떤 핫키가 어떤 다이얼로그에 예전에 등록했고, 다른 다이얼로그에 대하여 DGRegisterHotKey를 호출하면, 이것은 동일한 핫키 식별자를 리턴합니다. 예전에 등록한 핫키를 해제하려면 DGUnregisterHotKey 함수를 사용하십시오.

다음 키 조합들은 핫키로 등록할 수 없습니다 (이 조합들은 기본적으로 운영체제 단축키와 다이얼로그 키보드 인터페이스의 합집합입니다):

Key	Modifier
`DG_KEY_TAB` `DG_KEY_LEFT` `DG_KEY_RIGHT` `DG_KEY_UP` `DG_KEY_DOWN`	없음
`DG_KEY_ESCAPE` 'x', 'X', 'c', 'C', 'v', 'V'	`DG_MOD_COMMAND`
`DG_KEY_TAB` `DG_KEY_ESCAPE` `SPACE` '-'	`DG_MOD_OPTION`
`DG_KEY_TAB` `DG_KEY_DELETE`	`DG_MOD_SHIFT`
`DG_KEY_ESCAPE`	`DG_MOD_COMMAND` \| `DG_MOD_OPTION`
'0'..'9'	`DG_MOD_COMMAND` \| `DG_MOD_SHIFT`
`DG_KEY_TAB`	`DG_MOD_OPTION` \| `DG_MOD_SHIFT`

Modal 다이얼로그에 한해서만 어떤 Modifier가 없이 DG_KEY_LEFT, DG_KEY_RIGHT, DG_KEY_UP, DG_KEY_DOWN 키들은 등록될 수 없음을 참고하십시오. (문자 및 숫자 키 같은) 일반 키 코드는 DG_MOD_SHIFT modifier와 함께 사용할 수 없습니다. 예를 들면, 작은 'a' 키와 DG_MOD_SHIFT modifier를 함께 사용하지 않고 대문자 'A' 문자를 사용하십시오.

요구사항

버전: DG 1.0.0 또는 이후

헤더: DG.h

라이브러리 가져오기: DG.lib [WIN]

모듈: DGLib [MAC], DG.dll [WIN]

참고사항

DG 함수, DGUnregisterHotKey
DGDisableHotKeys, DGEnableHotKeys, Modal 다이얼로그, DG_MSG_HOTKEY
다이얼로그 키보드 인터페이스, 운영체제 단축키