CAtlPreviewCtrlImpl 類別

發行項
08/03/2024

這個類別是放置於Shell for Rich Preview 所提供之主視窗的ATL實作。

重要

這個類別及其成員不能用於在 Windows 執行階段中執行的應用程式。

語法

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

成員

公用建構函式

名稱	描述
CAtlPreviewCtrlImpl：：~CAtlPreviewCtrlImpl	解構預覽控件物件。
CAtlPreviewCtrlImpl：：CAtlPreviewCtrlImpl	建構預覽控件物件。

公用方法

名稱	描述
CAtlPreviewCtrlImpl：：Create	由 Rich Preview 處理程式呼叫以建立 Windows 視窗。
CAtlPreviewCtrlImpl：:D estroy	需要終結此控件時，由 Rich Preview 處理程式呼叫。
CAtlPreviewCtrlImpl：：Focus	將輸入焦點設定為此控制件。
CAtlPreviewCtrlImpl：：OnPaint	處理WM_PAINT訊息。
CAtlPreviewCtrlImpl：：Redraw	告知此控件重繪。
CAtlPreviewCtrlImpl：：SetHost	設定這個控件的新父代。
CAtlPreviewCtrlImpl：：SetPreviewVisuals	當需要設定豐富預覽內容的視覺效果時，由 Rich Preview 處理程式呼叫。
CAtlPreviewCtrlImpl：：SetRect	設定這個控件的新周框。

受保護的方法

名稱	描述
CAtlPreviewCtrlImpl：:D oPaint	由架構呼叫以轉譯預覽。

受保護的常數

名稱	描述
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
Shell for Rich Preview 所提供的主視窗句柄。

中華人民共和國
指定視窗的初始大小和位置。

傳回值

如果成功，則為 TRUE，否則為 FALSE。

備註

CAtlPreviewCtrlImpl：:D estroy

需要終結此控件時，由 Rich Preview 處理程式呼叫。

virtual void Destroy();

備註

CAtlPreviewCtrlImpl：:D oPaint

由架構呼叫以轉譯預覽。

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);

參數

中華人民共和國
指定預覽控制項的新大小和位置。

bRedraw
指定控制項是否應該重新繪製。

備註

另請參閱

ATL COM 桌面元件

共用方式為