IPreviewHandlerFrame::GetWindowContext 메서드(shobjidl_core.h)
미리 보기 호스트의 바로 가기 키 목록을 가져옵니다.
구문
HRESULT GetWindowContext(
[out] PREVIEWHANDLERFRAMEINFO *pinfo
);
매개 변수
[out] pinfo
가속기 테이블 정보를 수신하는 PREVIEWHANDLERFRAMEINFO 구조체에 대한 포인터입니다.
반환 값
형식: HRESULT
메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
가속기 테이블은 바로 가기 키와 호스트가 실행해야 하는 명령의 목록입니다. 최적화로 미리 보기 처리기는 수신하는 키 입력을 보고, 가속기 테이블에 검사 호스트가 관심이 있는지 확인하고, 적절한 경우 구조체의 명령을 무시하고 전달할 수 있습니다. IPreviewHandlerFrame::GetWindowContext에서 반환된 가속기 테이블은 키 입력만 포함하며 유효한 명령 항목을 포함하지 않습니다. 미리 보기 처리기는 이 최적화를 건너뛰고 모든 키 입력에 대해 IPreviewHandlerFrame::TranslateAccelerator 를 호출하기만 하면 됩니다. 미리 보기 처리기가 제거되면 DestroyAcceleratorTable 함수를 사용하여 가속기 테이블을 해제해야 합니다.
이 메서드는 미리 보기 처리기가 SetSite 를 호출하고 결과가 나중에 미리 보기 처리기에서 사용하기 위해 캐시된 시점에 호출되어야 합니다. 이 메서드는 낮은 무결성 모드에서 실행되는 미리 보기 처리기에서 호출할 수 없습니다. 이러한 미리 보기 처리기는 모든 키 입력에 대해 항상 IPreviewHandlerFrame::TranslateAccelerator 를 호출해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista, Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | shobjidl_core.h(Shobjidl.h 포함) |
| 재배포 가능 파일 | Windows Search 4 이상 |