CAtlPreviewCtrlImpl-Klasse
Diese Klasse ist eine ATL-Implementierung eines Fensters, das in einem Hostfenster platziert wird, das von der Shell für Rich Preview bereitgestellt wird.
Wichtig
Diese Klasse und ihre Member können nicht in Anwendungen verwendet werden, die in der Windows-Runtime ausgeführt werden.
Syntax
class CAtlPreviewCtrlImpl : public CWindowImpl<CAtlPreviewCtrlImpl>, public IPreviewCtrl;
Member
Öffentliche Konstruktoren
| Name | Beschreibung |
|---|---|
| CAtlPreviewCtrlImpl::~CAtlPreviewCtrlImpl | Destruktiert ein Vorschausteuerelementobjekt. |
| CAtlPreviewCtrlImpl::CAtlPreviewCtrlImpl | Erstellt ein Vorschausteuerelementobjekt. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CAtlPreviewCtrlImpl::Create | Wird von einem Rich Preview-Handler aufgerufen, um das Windows-Fenster zu erstellen. |
| CAtlPreviewCtrlImpl::D estroy | Wird von einem Rich Preview-Handler aufgerufen, wenn es dieses Steuerelement zerstören muss. |
| CAtlPreviewCtrlImpl::Focus | Legt den Eingabefokus auf dieses Steuerelement fest. |
| CAtlPreviewCtrlImpl::OnPaint | Behandelt die WM_PAINT Nachricht. |
| CAtlPreviewCtrlImpl::Redraw | Weist dieses Steuerelement an, neu zu zeichnen. |
| CAtlPreviewCtrlImpl::SetHost | Legt ein neues übergeordnetes Element für dieses Steuerelement fest. |
| CAtlPreviewCtrlImpl::SetPreviewVisuals | Wird von einem Rich Preview-Handler aufgerufen, wenn visuelle Elemente von rich Preview-Inhalten festgelegt werden müssen. |
| CAtlPreviewCtrlImpl::SetRect | Legt ein neues umgebendes Rechteck für dieses Steuerelement fest. |
Geschützte Methoden
| Name | Beschreibung |
|---|---|
| CAtlPreviewCtrlImpl::D oPaint | Vom Framework aufgerufen, um die Vorschau zu rendern. |
Geschützte Konstanten
| Name | Beschreibung |
|---|---|
| CAtlPreviewCtrlImpl::m_plf | Schriftart, die zum Anzeigen von Text im Vorschaufenster verwendet wird. |
Geschützte Datenmember
| Name | Beschreibung |
|---|---|
| CAtlPreviewCtrlImpl::m_clrBack | Hintergrundfarbe des Vorschaufensters. |
| CAtlPreviewCtrlImpl::m_clrText | Textfarbe des Vorschaufensters. |
Hinweise
Vererbungshierarchie
TBase
ATL::CMessageMap
ATL::CWindowImplRoot<TBase>
ATL::CWindowImplBaseT<TBase,TWinTraits>
ATL::CWindowImpl<CAtlPreviewCtrlImpl>
IPreviewCtrl
ATL::CAtlPreviewCtrlImpl
Anforderungen
Header: atlpreviewctrlimpl.h
CAtlPreviewCtrlImpl::CAtlPreviewCtrlImpl
Erstellt ein Vorschausteuerelementobjekt.
CAtlPreviewCtrlImpl(void) : m_clrText(0),
m_clrBack(RGB(255, 255, 255)), m_plf(NULL);
Hinweise
CAtlPreviewCtrlImpl::~CAtlPreviewCtrlImpl
Destruktiert ein Vorschausteuerelementobjekt.
virtual ~CAtlPreviewCtrlImpl(void);
Hinweise
CAtlPreviewCtrlImpl::Create
Wird von einem Rich Preview-Handler aufgerufen, um das Windows-Fenster zu erstellen.
virtual BOOL Create(HWND hWndParent, const RECT* prc);
Parameter
hWndParent
Ein Handle für das Hostfenster, das von der Shell für Rich Preview bereitgestellt wird.
vr china
Gibt die Anfängliche Größe und Position des Fensters an.
Rückgabewert
TRUE, wenn erfolgreich, andernfalls FALSE.
Hinweise
CAtlPreviewCtrlImpl::D estroy
Wird von einem Rich Preview-Handler aufgerufen, wenn es dieses Steuerelement zerstören muss.
virtual void Destroy();
Hinweise
CAtlPreviewCtrlImpl::D oPaint
Vom Framework aufgerufen, um die Vorschau zu rendern.
virtual void DoPaint(HDC hdc);
Parameter
hdc
Ein Handle zu einem Gerätekontext zum Zeichnen.
Hinweise
CAtlPreviewCtrlImpl::Focus
Legt den Eingabefokus auf dieses Steuerelement fest.
virtual void Focus();
Hinweise
CAtlPreviewCtrlImpl::m_clrBack
Hintergrundfarbe des Vorschaufensters.
COLORREF m_clrBack;
Hinweise
CAtlPreviewCtrlImpl::m_clrText
Textfarbe des Vorschaufensters.
COLORREF m_clrText;
Hinweise
CAtlPreviewCtrlImpl::m_plf
Schriftart, die zum Anzeigen von Text im Vorschaufenster verwendet wird.
const LOGFONTW* m_plf;
Hinweise
CAtlPreviewCtrlImpl::OnPaint
Behandelt die WM_PAINT Nachricht.
LRESULT OnPaint(
UINT nMsg,
WPARAM wParam,
LPARAM lParam,
BOOL& bHandled);
Parameter
nMsg
Auf WM_PAINT festgelegt.
wParam
Dieser Parameter wird nicht verwendet.
lParam
Dieser Parameter wird nicht verwendet.
bHandled
Wenn diese Funktion zurückgegeben wird, enthält sie WAHR.
Rückgabewert
Es wird immer 0 zurückgegeben.
Hinweise
CAtlPreviewCtrlImpl::Redraw
Weist dieses Steuerelement an, neu zu zeichnen.
virtual void Redraw();
Hinweise
CAtlPreviewCtrlImpl::SetHost
Legt ein neues übergeordnetes Element für dieses Steuerelement fest.
virtual void SetHost(HWND hWndParent);
Parameter
hWndParent
Ein Handle für das neue übergeordnete Fenster.
Hinweise
CAtlPreviewCtrlImpl::SetPreviewVisuals
Wird von einem Rich Preview-Handler aufgerufen, wenn visuelle Elemente von rich Preview-Inhalten festgelegt werden müssen.
virtual void SetPreviewVisuals(
COLORREF clrBack,
COLORREF clrText,
const LOGFONTW* plf);
Parameter
clrBack
Hintergrundfarbe des Vorschaufensters.
clrText
Textfarbe des Vorschaufensters.
Plf
Schriftart, die zum Anzeigen von Text im Vorschaufenster verwendet wird.
Hinweise
CAtlPreviewCtrlImpl::SetRect
Legt ein neues umgebendes Rechteck für dieses Steuerelement fest.
virtual void SetRect(const RECT* prc, BOOL bRedraw);
Parameter
vr china
Gibt die neue Größe und Position des Vorschausteuerelements an.
bRedraw
Gibt an, ob das Steuerelement neu gezeichnet werden soll.