다음을 통해 공유

IOleInPlaceSiteWindowless::SetFocus 메서드(ocidl.h)

  • 아티클

UI 활성 창 없는 개체에 대한 키보드 포커스를 설정합니다.

구문

HRESULT SetFocus(
  [in] BOOL fFocus
);

매개 변수

[in] fFocus

TRUE이면 키보드 포커스를 호출 개체로 설정합니다. FALSE이면 개체에 포커스가 있는 경우 호출 개체에서 키보드 포커스를 제거합니다.

반환 값

이 메서드는 키보드 포커스가 개체에 성공적으로 제공된 경우 S_OK 반환합니다. 포커스를 해제하기 위해 이 메서드를 호출하면 실패하지 않아야 합니다. 다른 가능한 반환 값은 다음과 같습니다.

반환 코드 설명
S_FALSE
 키보드 포커스가 개체에 거부되었습니다.

설명

창이 없는 개체는 창이 있는 개체가 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

추가 정보

IOleInPlaceActiveObject

IOleInPlaceSiteWindowless