CAtlPreviewCtrlImpl 類別
這個類別是放置於 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::On小畫家 | 處理WM_PAINT訊息。 |
CAtlPreviewCtrlImpl::Redraw | 告知此控制項重繪。 |
CAtlPreviewCtrlImpl::SetHost | 設定這個控制項的新父代。 |
CAtlPreviewCtrlImpl::SetPreviewVisuals | 當需要設定豐富預覽內容的視覺效果時,由 Rich Preview 處理常式呼叫。 |
CAtlPreviewCtrlImpl::SetRect | 設定這個控制項的新周框。 |
受保護的方法
名稱 | 描述 |
---|---|
CAtlPreviewCtrlImpl::D o小畫家 | 由架構呼叫以轉譯預覽。 |
受保護的常數
名稱 | 描述 |
---|---|
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 o小畫家
由架構呼叫以轉譯預覽。
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::On小畫家
處理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
指定控制項是否應該重新繪製。
備註
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應