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.

System_CAPS_ICON_important.jpg Important

This class and its members cannot be used in applications that execute in the Windows Runtime.

template<class T>
class IPointerInactiveImpl

Parameters

T
Your class, derived from IPointerInactiveImpl.

Public Methods

NameDescription
IPointerInactiveImpl::GetActivationPolicyRetrieves the current activation policy for the object. The ATL implementation returns E_NOTIMPL.
IPointerInactiveImpl::OnInactiveMouseMoveNotifies the object that the mouse pointer has moved over it, indicating the object can fire mouse events. The ATL implementation returns E_NOTIMPL.
IPointerInactiveImpl::OnInactiveSetCursorSets 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);

Return Value

Returns E_NOTIMPL.

Remarks

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);

Return Value

Returns E_NOTIMPL.

Remarks

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);

Return Value

Returns E_NOTIMPL.

Remarks

See IPointerInactive::OnInactiveSetCursor in the Windows SDK.

Class Overview

Show: