CAtlPreviewCtrlImpl-Klasse

  • Artikel

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.

Hinweise

Siehe auch

ATL-COM-Desktop-Komponenten