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.

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

See Also

Other Resources

ATL Class Overview