IQuickActivateImpl 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 IQuickActivateImpl Class.

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

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 ATL_NO_VTABLE IQuickActivateImpl : public IQuickActivate

Parameters

T
Your class, derived from IQuickActivateImpl.

Public Methods

NameDescription
IQuickActivateImpl::GetContentExtentRetrieves the current display size for a running control.
IQuickActivateImpl::QuickActivatePerforms quick initialization of controls being loaded.
IQuickActivateImpl::SetContentExtentInforms the control of how much display space the container has assigned to it.

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

IQuickActivate

IQuickActivateImpl

Header: atlctl.h

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.

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.

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.

CComControl Class
Class Overview

Show: