Edit

IQuickActivateImpl Class

  • Article

This class combines containers' control initialization into a single call.

Important

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

Syntax

template <class T>
class ATL_NO_VTABLE IQuickActivateImpl : public IQuickActivate

Parameters

T
Your class, derived from IQuickActivateImpl.

Members

Public Methods

Name Description
IQuickActivateImpl::GetContentExtent Retrieves the current display size for a running control.
IQuickActivateImpl::QuickActivate Performs quick initialization of controls being loaded.
IQuickActivateImpl::SetContentExtent Informs the control of how much display space the container has assigned to it.

Remarks

The IQuickActivate interface helps containers avoid delays when loading controls by combining initialization in a single call. The QuickActivate method allows the container to pass a pointer to a QACONTAINER structure that holds pointers to all the interfaces the control needs. On return, the control passes back a pointer to a QACONTROL structure that holds pointers to its own interfaces, which are used by the container. Class IQuickActivateImpl provides a default implementation of IQuickActivate and implements IUnknown by sending information to the dump device in debug builds.

Related Articles ATL Tutorial, Creating an ATL Project

Inheritance Hierarchy

IQuickActivate

IQuickActivateImpl

Requirements

Header: atlctl.h

IQuickActivateImpl::GetContentExtent

Retrieves the current display size for a running control.

STDMETHOD(GetContentExtent)(LPSIZEL pSize);

Remarks

The size is for a full rendering of the control and is specified in HIMETRIC units.

See IQuickActivate::GetContentExtent in the Windows SDK.

IQuickActivateImpl::QuickActivate

Performs quick initialization of controls being loaded.

STDMETHOD(QuickActivate)(
    QACONTAINER* pQACont,
    QACONTROL* pQACtrl);

Remarks

The structure contains pointers to interfaces needed by the control and the values of some ambient properties. Upon return, the control passes a pointer to a QACONTROL structure that contains pointers to its own interfaces that the container requires, and additional status information.

See IQuickActivate::QuickActivate in the Windows SDK.

IQuickActivateImpl::SetContentExtent

Informs the control of how much display space the container has assigned to it.

STDMETHOD(SetContentExtent)(LPSIZEL pSize);

Remarks

The size is specified in HIMETRIC units.

See IQuickActivate::SetContentExtent in the Windows SDK.

See also

CComControl Class
Class Overview