IPointerInactiveImpl Class
The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.
The latest version of this topic can be found at IPointerInactiveImpl Class.
This class implements IUnknown and the IPointerInactive interface methods.
Important
This class and its members cannot be used in applications that execute in the Windows Runtime.
Syntax
template<class T>
class IPointerInactiveImpl
Parameters
T
Your class, derived from IPointerInactiveImpl.
Members
Public Methods
| Name | Description |
|---|---|
| IPointerInactiveImpl::GetActivationPolicy | Retrieves the current activation policy for the object. The ATL implementation returns E_NOTIMPL. |
| IPointerInactiveImpl::OnInactiveMouseMove | Notifies the object that the mouse pointer has moved over it, indicating the object can fire mouse events. The ATL implementation returns E_NOTIMPL. |
| IPointerInactiveImpl::OnInactiveSetCursor | Sets the mouse pointer for the inactive object. The ATL implementation returns E_NOTIMPL. |
Remarks
An inactive object is one that is simply loaded or running. Unlike an active object, an inactive object cannot receive Windows mouse and keyboard messages. Thus, inactive objects use fewer resources and are typically more efficient.
The IPointerInactive interface allows an object to support a minimal level of mouse interaction while remaining inactive. This functionality is particularly useful for controls.
Class IPointerInactiveImpl implements the IPointerInactive methods by simply returning E_NOTIMPL. However, it implements IUnknown by sending information to the dump device in debug builds.
Related Articles ATL Tutorial, Creating an ATL Project
Inheritance Hierarchy
IPointerInactive
IPointerInactiveImpl
Requirements
Header: atlctl.h
IPointerInactiveImpl::GetActivationPolicy
Retrieves the current activation policy for the object.
HRESULT GetActivationPolicy(DWORD* pdwPolicy);
Return Value
Returns E_NOTIMPL.
Remarks
See IPointerInactive::GetActivationPolicy in the Windows SDK.
IPointerInactiveImpl::OnInactiveMouseMove
Notifies the object that the mouse pointer has moved over it, indicating the object can fire mouse events.
HRESULT OnInactiveMouseMove(
LPCRECT pRectBounds,
long x,
long y,
DWORD dwMouseMsg);
Return Value
Returns E_NOTIMPL.
Remarks
See IPointerInactive::OnInactiveMouseMove in the Windows SDK.
IPointerInactiveImpl::OnInactiveSetCursor
Sets the mouse pointer for the inactive object.
HRESULT OnInactiveSetCursor(
LPCRECT pRectBounds,
long x,
long y,
DWORD dwMouseMsg,
BOOL fSetAlways);
Return Value
Returns E_NOTIMPL.
Remarks
See IPointerInactive::OnInactiveSetCursor in the Windows SDK.