CAtlPreviewCtrlImpl Class

项目
10/13/2023

此类是窗口的 ATL 实现，该窗口放置在 Rich Preview 的 Shell 提供的宿主窗口上。

重要

无法在 Windows 运行时中执行的应用程序中使用此类及其成员。

语法

class CAtlPreviewCtrlImpl : public CWindowImpl<CAtlPreviewCtrlImpl>, public IPreviewCtrl;

成员

公共构造函数

名称	描述
CAtlPreviewCtrlImpl::~CAtlPreviewCtrlImpl	销毁预览控件对象。
CAtlPreviewCtrlImpl::CAtlPreviewCtrlImpl	构造预览控件对象。

公共方法

名称	描述
CAtlPreviewCtrlImpl::Create	由 Rich Preview 处理程序调用以创建 Windows 窗口。
CAtlPreviewCtrlImpl::Destroy	当需要销毁此控件时，由 Rich Preview 处理程序调用。
CAtlPreviewCtrlImpl::Focus	为此控件设置输入焦点。
CAtlPreviewCtrlImpl::OnPaint	处理 WM_PAINT 消息。
CAtlPreviewCtrlImpl::Redraw	告知此控件重绘。
CAtlPreviewCtrlImpl::SetHost	设置此控件的新父级。
CAtlPreviewCtrlImpl::SetPreviewVisuals	当需要设置丰富预览内容的视觉对象时，由 Rich Preview 处理程序调用。
CAtlPreviewCtrlImpl::SetRect	设置此控件的新边界矩形。

受保护方法

名称	描述
CAtlPreviewCtrlImpl::DoPaint	由框架调用以呈现预览。

受保护的常量

名称	描述
CAtlPreviewCtrlImpl::m_plf	用于在预览窗口中显示文本的字体。

受保护的数据成员

名称	描述
CAtlPreviewCtrlImpl::m_clrBack	预览窗口的背景色。
CAtlPreviewCtrlImpl::m_clrText	预览窗口的文本颜色。

注解

继承层次结构

TBase

ATL::CMessageMap

ATL::CWindowImplRoot<TBase>

ATL::CWindowImplBaseT<TBase,TWinTraits>

ATL::CWindowImpl<CAtlPreviewCtrlImpl>

IPreviewCtrl

ATL::CAtlPreviewCtrlImpl

要求

标头： atlpreviewctrlimpl.h

CAtlPreviewCtrlImpl::CAtlPreviewCtrlImpl

构造预览控件对象。

CAtlPreviewCtrlImpl(void) : m_clrText(0),
   m_clrBack(RGB(255, 255, 255)), m_plf(NULL);

注解

CAtlPreviewCtrlImpl::~CAtlPreviewCtrlImpl

销毁预览控件对象。

virtual ~CAtlPreviewCtrlImpl(void);

注解

CAtlPreviewCtrlImpl::Create

由 Rich Preview 处理程序调用以创建 Windows 窗口。

virtual BOOL Create(HWND hWndParent, const RECT* prc);

参数

hWndParent
由 Rich Preview 的 Shell 提供的主机窗口句柄。

prc
指定窗口的初始大小和位置。

返回值

若成功，则为 TRUE；否则为 FALSE。

备注

CAtlPreviewCtrlImpl::Destroy

当需要销毁此控件时，由 Rich Preview 处理程序调用。

virtual void Destroy();

备注

CAtlPreviewCtrlImpl::DoPaint

由框架调用以呈现预览。

virtual void DoPaint(HDC hdc);

参数

hdc
用于绘制的设备上下文的句柄。

注解

CAtlPreviewCtrlImpl::Focus

为此控件设置输入焦点。

virtual void Focus();

备注

CAtlPreviewCtrlImpl::m_clrBack

预览窗口的背景色。

COLORREF m_clrBack;

注解

CAtlPreviewCtrlImpl::m_clrText

预览窗口的文本颜色。

COLORREF m_clrText;

备注

CAtlPreviewCtrlImpl::m_plf

用于在预览窗口中显示文本的字体。

const LOGFONTW* m_plf;

备注

CAtlPreviewCtrlImpl::OnPaint

处理 WM_PAINT 消息。

LRESULT OnPaint(
    UINT nMsg,
    WPARAM wParam,
    LPARAM lParam,
    BOOL& bHandled);

参数

nMsg
设置为 WM_PAINT。

wParam
未使用此参数。

lParam
未使用此参数。

bHandled
此函数返回时会包含 TRUE。

返回值

始终返回 0。

注解

CAtlPreviewCtrlImpl::Redraw

告知此控件重绘。

virtual void Redraw();

备注

CAtlPreviewCtrlImpl::SetHost

设置此控件的新父级。

virtual void SetHost(HWND hWndParent);

参数

hWndParent
新父窗口的句柄。

注解

CAtlPreviewCtrlImpl::SetPreviewVisuals

当需要设置丰富预览内容的视觉对象时，由 Rich Preview 处理程序调用。

virtual void SetPreviewVisuals(
    COLORREF clrBack,
    COLORREF clrText,
    const LOGFONTW* plf);

参数

clrBack
预览窗口的背景色。

clrText
预览窗口的文本颜色。

plf
用于在预览窗口中显示文本的字体。

备注

CAtlPreviewCtrlImpl::SetRect

设置此控件的新边界矩形。

virtual void SetRect(const RECT* prc, BOOL bRedraw);

参数

prc
指定预览控件的新大小和位置。

bRedraw
指定是否应重绘控件。

备注

另请参阅

ATL COM 桌面组件