IOleControlSite::TranslateAccelerator 메서드(ocidl.h)

처리를 위해 컨트롤 사이트에 키 입력을 전달합니다.

구문

HRESULT TranslateAccelerator(
  [in] MSG   *pMsg,
  [in] DWORD grfModifiers
);

매개 변수

[in] pMsg

처리할 키 입력을 설명하는 MSG 구조체에 대한 포인터입니다.

[in] grfModifiers

Control, Alt 및 Shift 키의 상태를 설명하는 플래그입니다. 플래그 값은 유효한 KEYMODIFIERS 열거형 값일 수 있습니다.

반환 값

이 메서드는 다음 값을 반환할 수 있습니다.

반환 코드	Description
S_OK	컨테이너가 메시지를 처리했습니다.
S_FALSE	컨테이너가 메시지를 처리하지 않았습니다. 이 값은 E_NOTIMPL 이외의 다른 모든 오류 사례에서도 반환되어야 합니다.
E_NOTIMPL	컨테이너는 가속기 지원을 구현하지 않습니다.

설명

이 메서드는 UI 활성일 수 있는 컨트롤에 의해 호출됩니다. 이러한 경우 컨트롤은 일반적인 OLE 복합 문서 규칙에 따라 IOleInPlaceActiveObject::TranslateAccelerator를 통해 먼저 모든 키 입력을 처리할 수 있습니다. 해당 메서드 내에서 컨트롤은 IOleControlSite::TranslateAccelerator 를 호출하고 반환 값을 사용하여 처리가 수행되었는지 확인하여 컨테이너에 먼저 처리할 특정 메시지를 제공할 수 있습니다. 그렇지 않으면 컨트롤은 항상 메시지를 먼저 처리합니다. 컨트롤이 키 입력을 가속기로 사용하지 않는 경우 이 메서드를 통해 키 입력을 컨테이너에 전달합니다.

요구 사항

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

추가 정보

IOleControlSite

IOleInPlaceActiveObject::TranslateAccelerator