IOleInPlaceSiteWindowless::SetFocus 메서드(ocidl.h)
UI 활성 창 없는 개체에 대한 키보드 포커스를 설정합니다.
구문
HRESULT SetFocus(
[in] BOOL fFocus
);
매개 변수
[in] fFocus
TRUE이면 키보드 포커스를 호출 개체로 설정합니다. FALSE이면 개체에 포커스가 있는 경우 호출 개체에서 키보드 포커스를 제거합니다.
반환 값
이 메서드는 키보드 포커스가 개체에 성공적으로 제공된 경우 S_OK 반환합니다. 포커스를 해제하기 위해 이 메서드를 호출하면 실패하지 않아야 합니다. 다른 가능한 반환 값은 다음과 같습니다.
| 반환 코드 | 설명 |
|---|---|
|
키보드 포커스가 개체에 거부되었습니다. |
설명
창이 없는 개체는 창이 있는 개체가 SetFocus 함수를 호출할 때마다 이 메서드를 호출합니다. 이 호출을 통해 창 없는 개체는 키보드 포커스를 가져오고 창 메시지에 응답할 수 있습니다. 일반적으로 이 호출은 UI 활성화 프로세스 중 및 알림 메서드 IOleInPlaceActiveObject::OnDocWindowActivate with TRUE 및 IOleInPlaceActiveObject::OnFrameWindowActivate with TRUE 내에서 수행됩니다.
이 호출에 대한 응답으로 컨테이너는 Windows 포커스를 키보드 메시지를 가져오는 데 사용되는 창(일반적으로 컨테이너 창)으로 설정하고 후속 키보드 메시지를 포커스를 요청한 창 없는 개체로 리디렉션합니다.
또한 창 없는 개체는 fFocus 매개 변수가 FALSE로 설정된 IOleInPlaceSiteWindowless::SetFocus 메서드를 호출하여 키보드 포커스를 다른 개체에 할당하지 않고 해제합니다. 이 경우 컨테이너는 포커스가 있는 창이 없도록 NULL 매개 변수를 사용하여 SetFocus 함수를 호출해야 합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | ocidl.h |