Edit

IPointerInactiveImpl Class

  • Article

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.

See also

Class Overview