| title | IPointerInactiveImpl Class | Microsoft Docs | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ms.custom | ||||||||||||||
| ms.date | 11/04/2016 | |||||||||||||
| ms.reviewer | ||||||||||||||
| ms.suite | ||||||||||||||
| ms.technology |
|
|||||||||||||
| ms.tgt_pltfrm | ||||||||||||||
| ms.topic | reference | |||||||||||||
| f1_keywords |
|
|||||||||||||
| dev_langs |
|
|||||||||||||
| helpviewer_keywords |
|
|||||||||||||
| ms.assetid | e1fe9ea6-d38a-4527-9112-eb344771e0b7 | |||||||||||||
| caps.latest.revision | 21 | |||||||||||||
| author | mikeblome | |||||||||||||
| ms.author | mblome | |||||||||||||
| manager | ghogen | |||||||||||||
| translation.priority.ht |
|
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.
template<class T>
class IPointerInactiveImpl
T
Your class, derived from IPointerInactiveImpl.
| 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. |
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
IPointerInactive
IPointerInactiveImpl
Header: atlctl.h
Retrieves the current activation policy for the object.
HRESULT GetActivationPolicy(DWORD* pdwPolicy);
Returns E_NOTIMPL.
See IPointerInactive::GetActivationPolicy in the Windows SDK.
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);
Returns E_NOTIMPL.
See IPointerInactive::OnInactiveMouseMove in the Windows SDK.
Sets the mouse pointer for the inactive object.
HRESULT OnInactiveSetCursor(
LPCRECT pRectBounds,
long x,
long y,
DWORD dwMouseMsg,
BOOL fSetAlways);
Returns E_NOTIMPL.
See IPointerInactive::OnInactiveSetCursor in the Windows SDK.