IsAccelerator 함수(ole2.h)

  • 아티클

지정된 키 입력이 지정된 가속기 테이블의 액셀러레이터에 매핑되는지 여부를 결정합니다.

구문

BOOL IsAccelerator(
  [in]  HACCEL hAccel,
  [in]  int    cAccelEntries,
  [in]  LPMSG  lpMsg,
  [out] WORD   *lpwCmd
);

매개 변수

[in] hAccel

액셀러레이터 테이블에 대한 핸들입니다.

[in] cAccelEntries

액셀러레이터 테이블의 항목 수입니다.

[in] lpMsg

번역할 키 입력 메시지에 대한 포인터입니다.

[out] lpwCmd

키 입력에 대한 가속기가 있는 경우 해당 명령 식별자를 받을 변수에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

반환 값

개체 애플리케이션에 대한 메시지인 경우 반환 값은 TRUE입니다. 메시지가 개체에 대한 것이 아니고 컨테이너로 전달되어야 하는 경우 반환 값은 FALSE입니다.

설명

개체가 현재 위치에서 활성화되어 있는 동안 개체는 항상 키 입력을 액셀러레이터로 변환할 수 있는 첫 번째 기회가 있습니다. 키 입력이 가속기 중 하나에 해당하는 경우 TranslateAccelerator 함수에 대한 호출이 실패하더라도 개체는 OleTranslateAccelerator 함수를 호출하지 않아야 합니다. 이러한 방식으로 키 입력을 처리하지 못하면 일관되지 않은 동작이 발생할 수 있습니다.

키 입력이 개체의 가속기 중 하나가 아닌 경우 개체는 OleTranslateAccelerator 를 호출하여 컨테이너가 가속기 변환을 시도할 수 있도록 해야 합니다.

개체의 서버는 IsAccelerator 를 호출하여 가속기 메시지가 속해 있는지 확인할 수 있습니다. 일부 서버는 자체 가속기 번역을 수행하며 TranslateAccelerator를 호출하지 않습니다. 이러한 애플리케이션은 이미 정보를 가지고 있기 때문에 IsAccelerator를 호출하지 않습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 ole2.h
라이브러리 Ole32.lib
DLL Ole32.dll

추가 정보

OleTranslateAccelerator

TranslateAccelerator