CMFCPreviewCtrlImpl 类

项目
10/16/2023

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

语法

class CMFCPreviewCtrlImpl : public CWnd;

成员

公共构造函数

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

公共方法

名称	描述
CMFCPreviewCtrlImpl::Create	已重载。由 Rich Preview 处理程序调用以创建 Windows 窗口。
CMFCPreviewCtrlImpl::Destroy	当需要销毁此控件时，由 Rich Preview 处理程序调用。
CMFCPreviewCtrlImpl::Focus	为此控件设置输入焦点。
CMFCPreviewCtrlImpl::Focus	返回连接到此预览控件的文档。
CMFCPreviewCtrlImpl::Redraw	告知此控件重绘。
CMFCPreviewCtrlImpl::SetDocument	由预览控件调用，用于创建文档实现和预览控件之间的关系。
CMFCPreviewCtrlImpl::SetHost	设置此控件的新父级。
CMFCPreviewCtrlImpl::SetPreviewVisuals	当需要设置丰富预览内容的视觉对象时，由 Rich Preview 处理程序调用。
CMFCPreviewCtrlImpl::SetRect	设置此控件的新边界矩形。

受保护方法

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

受保护的数据成员

名称	描述
CMFCPreviewCtrlImpl::m_clrBackColor	预览窗口的背景色。
CMFCPreviewCtrlImpl::m_clrTextColor	预览窗口的文本颜色。
CMFCPreviewCtrlImpl::m_font	用于在预览窗口中显示文本的字体。
CMFCPreviewCtrlImpl::m_pDocument	指向文档的指针，可在控件中预览该文档的内容。

要求

标头：afxwin.h

继承层次结构

CMFCPreviewCtrlImpl::CMFCPreviewCtrlImpl

构造预览控件对象。

语法

CMFCPreviewCtrlImpl();

CMFCPreviewCtrlImpl::Create

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

语法

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

参数

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

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

pContext
指向创建上下文的指针。

返回值

如果创建成功，则为 TRUE；否则为 FALSE。

CMFCPreviewCtrlImpl::Destroy

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

语法

virtual void Destroy();

CMFCPreviewCtrlImpl::DoPaint

由框架调用以呈现预览。

语法

virtual void DoPaint(
   CPaintDC* pDC
);

参数

pDC
指向用于绘制的设备上下文的指针。

CMFCPreviewCtrlImpl::Focus

为此控件设置输入焦点。

语法

virtual void Focus();

CMFCPreviewCtrlImpl::GetDocument

返回连接到此预览控件的文档。

语法

ATL::IDocument* GetDocument();

返回值

指向文档的指针，可在控件中预览该文档的内容。

CMFCPreviewCtrlImpl::m_clrBackColor

预览窗口的背景色。

语法

COLORREF m_clrBackColor;

CMFCPreviewCtrlImpl::m_clrTextColor

预览窗口的文本颜色。

语法

COLORREF m_clrTextColor;

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

语法

CFont m_font;

CMFCPreviewCtrlImpl::m_pDocument

指向文档的指针，可在控件中预览该文档的内容。

语法

ATL::IDocument* m_pDocument;

CMFCPreviewCtrlImpl::Redraw

告知此控件重绘。

语法

virtual void Redraw();

CMFCPreviewCtrlImpl::SetDocument

由预览控件调用，用于创建文档实现和预览控件之间的关系。

语法

void SetDocument(
   IDocument* pDocument
);

参数

pDocument
指向文档实现的指针。

CMFCPreviewCtrlImpl::SetHost

设置此控件的新父级。

语法

virtual void SetHost(
   HWND hWndParent
);

参数

hWndParent
新父窗口的句柄。

CMFCPreviewCtrlImpl::SetPreviewVisuals

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

语法

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

参数

clrBack
预览窗口的背景色。

clrText
预览窗口的文本颜色。

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

CMFCPreviewCtrlImpl::SetRect

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

语法

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

参数

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

bRedraw
指定是否应重绘控件。

注解

通常，在重设主机控件大小时，会设置新边框。

CMFCPreviewCtrlImpl::~CMFCPreviewCtrlImpl

销毁预览控件对象。

语法

virtual ~CMFCPreviewCtrlImpl();

通过