CAtlPreviewCtrlImpl Class
此类是窗口的 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
指定是否应重绘控件。