IPointerInactive::GetActivationPolicy 메서드(ocidl.h)
개체에 대한 현재 활성화 정책을 검색합니다. 이 메서드는 비활성 개체가 마우스 포인터 아래에 있을 때 WM_SETCURSOR 또는 WM_MOUSEMOVE 메시지를 수신할 때 컨테이너에서 호출됩니다.
구문
HRESULT GetActivationPolicy(
[out] DWORD *pdwPolicy
);
매개 변수
[out] pdwPolicy
활성화 정책을 수신하는 변수에 대한 포인터입니다. 가능한 값은 POINTERINACTIVE 열거형에서 가져옵니다.
반환 값
메서드가 성공하면 반환 값이 S_OK. 그렇지 않으면 E_FAIL.
설명
개체는 마우스가 POINTERINACTIVE_ACTIVATEONENTRY 값을 통해 들어오는 즉시 활성화되도록 요청할 수 있습니다. 단순히 마우스 포인터를 설정하는 것보다 더 많은 시각적 피드백을 제공하는 개체는 이 값을 사용합니다. 예를 들어 개체가 특별한 시각적 피드백을 지원하는 경우 지원하는 시각적 피드백을 그릴 수 있도록 활성 상태를 입력해야 합니다.
개체는 POINTERINACTIVE_ACTIVATEONDRAG 통해 끌어서 놓기 작업 중에 마우스를 끌 때 활성화를 요청하는 데 이 메서드를 사용할 수도 있습니다.
개체가 이러한 값 중 하나를 반환하는 경우 컨테이너는 개체를 즉시 활성화하고 호출을 트리거한 Window 메시지를 전달해야 합니다. 그런 다음 개체는 활성 상태를 유지하고 컨테이너가 다른 WM_SETCURSOR 가져오거나 WM_MOUSEMOVE 때까지 자체 창을 통해 후속 메시지를 처리합니다. 이 시점에서 컨테이너는 개체를 비활성화해야 합니다.
창이 없는 OLE 개체의 경우 이 메커니즘은 약간 다릅니다. 창 없는 개체에 대한 끌어서 놓기 작업에 대한 자세한 내용은 IOleInPlaceSiteWindowless 를 참조하세요.
개체가 POINTERINACTIVE_ACTIVATEONENTRY 및 POINTERINACTIVE_DEACTIVATEONLEAVE 값을 모두 반환하는 경우 개체는 마우스가 개체 위에 있을 때만 활성화됩니다. POINTERINACTIVE_ACTIVATEONENTRY 값만 설정하면 마우스가 처음 입력될 때 개체가 한 번 활성화되고 활성 상태로 유지됩니다.
발신자에 대한 참고 사항
활성화 정책은 캐시해서는 안 됩니다. 컨테이너는 마우스가 비활성 개체에 들어갈 때마다 이 메서드를 호출해야 합니다.요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | ocidl.h |