共用方式為

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 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 ocidl.h

另請參閱

IOleInPlaceSiteWindowless

IPointerInactive