IOleInPlaceActiveObject::TranslateAccelerator 메서드(oleidl.h)

아티클
03/01/2024

컨테이너의 메시지 큐에서 메뉴 가속기 키 메시지를 처리합니다. 이 메서드는 DLL 개체 애플리케이션에서 만든 개체에만 사용해야 합니다.

구문

HRESULT TranslateAccelerator(
  [in] LPMSG lpmsg
);

매개 변수

[in] lpmsg

번역해야 할 수 있는 메시지의 MSG 구조체에 대한 포인터입니다.

반환 값

이 메서드는 성공에 대한 S_OK 반환합니다. 가능한 다른 반환 값은 다음과 같습니다.

반환 코드	설명
S_FALSE	메시지가 번역되지 않았습니다.
E_INVALIDARG	지정된 매개 변수 값이 잘못되었습니다.
E_OUTOFMEMORY	IThere 작업에 사용할 수 있는 메모리가 부족합니다.
E_UNEXPECTED	예기치 않은 오류가 발생했습니다.

설명

발신자에 대한 참고 사항

활성 현재 위치 개체는 항상 가속기 키 입력을 변환할 수 있는 첫 번째 기회를 제공해야 합니다. 다른 번역을 수행하기 전에 컨테이너의 메시지 루프에서 IOleInPlaceActiveObject::TranslateAccelerator 를 호출하여 이 기회를 제공할 수 있습니다. 이 메서드가 S_FALSE 반환하는 경우에만 고유한 번역을 적용해야 합니다.

DLL 개체 애플리케이션에서 만들지 않은 개체에 대해 IOleInPlaceActiveObject::TranslateAccelerator 를 호출하면 기본 개체 처리기가 S_FALSE 반환합니다.

구현자에 대한 참고 사항

EXE 개체 애플리케이션에서 만든 개체는 자체 메시지 펌프에서 키 입력을 가져오므로 컨테이너는 해당 메시지를 가져오지 않습니다.

이 메서드를 구현해야 하는 경우 TranslateAccelerator 함수에 대한 호출을 래핑하기만 하면 됩니다.

요구 사항

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