다음을 통해 공유

IOleInPlaceObjectWindowless::OnWindowMessage 메서드(ocidl.h)

  • 아티클

컨테이너에서 현재 위치 활성 상태인 창 없는 개체로 메시지를 디스패치합니다.

구문

HRESULT OnWindowMessage(
  [in]  UINT    msg,
  [in]  WPARAM  wParam,
  [in]  LPARAM  lParam,
  [out] LRESULT *plResult
);

매개 변수

[in] msg

Windows에서 컨테이너에 제공한 창 메시지의 식별자입니다.

[in] wParam

Windows에서 컨테이너에 제공한 창 메시지에 대한 매개 변수입니다.

[in] lParam

Windows에서 컨테이너에 제공한 창 메시지에 대한 매개 변수입니다.

[out] plResult

창 메시지의 결과 코드에 대한 포인터입니다.

반환 값

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

반환 코드 설명
S_FALSE
 창 없는 개체가 창 메시지를 처리하지 않았습니다. 컨테이너는 메시지에 대해 DefWindowProc을 호출하거나 아래 설명된 대로 메시지 자체를 처리해야 합니다.

설명

컨테이너는 이 메서드를 호출하여 현재 위치 활성 상태인 창 없는 개체에 창 메시지를 보냅니다. 컨테이너는 다음 지침에 따라 메시지를 디스패치해야 합니다.

다음 메시지의 경우 컨테이너는 먼저 마우스를 캡처한 창 없는 개체(있는 경우)에 메시지를 디스패치해야 합니다. 그렇지 않으면 컨테이너가 마우스 커서 아래의 창 없는 개체에 메시지를 디스패치해야 합니다. 이러한 개체가 없으면 컨테이너는 다음 메시지 자체를 자유롭게 처리할 수 있습니다.

  • WM_MOUSEMOVE
  • WM_SETCURSOR
  • WM_XBUTTONDOWN
  • WM_XBUTTONUP
  • WM_XBUTTONDBLCLK
컨테이너는 다음 메시지에 대한 키보드 포커스를 사용하여 창을 사용하지 않는 개체로 메시지를 디스패치해야 합니다.
  • WM_CANCELMODE
  • WM_CHAR
  • WM_DEADCHAR
  • WM_HELP
  • WM_IMExxx
  • WM_KEYDOWN
  • WM_KEYUP
  • WM_SYSDEADCHAR
  • WM_SYSKEYDOWN
  • WM_SYSKEYUP
다른 모든 메시지의 경우 컨테이너는 메시지를 자체적으로 처리해야 합니다.

창 없는 개체는 메시지를 처리하지 않았음을 나타내기 위해 이 메서드에 S_FALSE 반환할 수 있습니다. 그런 다음 컨테이너는 DefWindowProc 함수를 호출하여 메시지에 대한 기본 동작을 수행하거나 메시지 자체를 처리합니다.

컨테이너는 다음 창 메시지를 기본 창 프로시저에 전달해야 합니다.

  • WM_CHAR
  • WM_DEADCHAR
  • WM_IMExxx
  • WM_KEYDOWN
  • WM_KEYUP
  • WM_MOUSEMOVE
  • WM_SYSCHAR
  • WM_SYSDEADCHAR
  • WM_SYSKEYUP
  • WM_XBUTTONDOWN
  • WM_XBUTTONUP
  • WM_XBUTTONDBLCLK
컨테이너는 다음 창 메시지를 자체적으로 처리해야 합니다.
  • WM_CONTEXTMENU
  • WM_HELP
  • WM_SETCURSOR
참고 WM_SETCURSOR 경우 컨테이너는 커서 자체를 설정하거나 아무 것도 수행할 수 없습니다.
 
개체는 IOleInPlaceSiteWindowless::OnDefWindowMessage 를 사용하여 컨테이너에서 기본 메시지 처리를 명시적으로 호출할 수도 있습니다. WM_SETCURSOR 메시지의 경우 컨테이너가 커서를 설정하지 않은 경우 개체가 작업을 수행할 수 있습니다.

wParam 및 lParam의 개체에 전달된 모든 좌표는 포함된 창의 클라이언트 좌표로 지정됩니다.

요구 사항

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

추가 정보