OleDraw-Funktion (ole2.h)

Artikel
08/25/2023

Ermöglicht das Zeichnen von Objekten einfacher. Sie können es verwenden, anstatt IViewObject::D raw direkt aufzurufen.

Syntax

HRESULT OleDraw(
  [in] LPUNKNOWN pUnknown,
  [in] DWORD     dwAspect,
  [in] HDC       hdcDraw,
  [in] LPCRECT   lprcBounds
);

Parameter

[in] pUnknown

Zeiger auf die IUnknown-Schnittstelle des zu zeichnenden Ansichtsobjekts.

[in] dwAspect

Wie das Objekt dargestellt werden soll. Darstellungen umfassen Inhalt, ein Symbol, eine Miniaturansicht oder ein gedrucktes Dokument. Mögliche Werte werden der DVASPECT-Enumeration entnommen.

[in] hdcDraw

Der Gerätekontext, auf dem gezeichnet werden soll. Kann kein Metadateigerätekontext sein.

[in] lprcBounds

Zeiger auf eine RECT-Struktur , die das Rechteck angibt, in dem das Objekt gezeichnet werden soll. Dieser Parameter wird in eine RECTL-Struktur konvertiert und an IViewObject::D raw übergeben.

Rückgabewert

Diese Funktion gibt bei Erfolg S_OK zurück. Weitere mögliche Werte sind:

Rückgabecode	Beschreibung
OLE_E_BLANK	Keine Daten zum Zeichnen.
E_ABORT	Der Zeichnungsvorgang wurde abgebrochen.
VIEW_E_DRAW	Keine Daten zum Zeichnen.
OLE_E_INVALIDRECT	Das Rechteck ist ungültig.
E_INVALIDARG	Mindestens ein Parameter ist ungültig.
E_OUTOFMEMORY	Unzureichender Arbeitsspeicher für den Vorgang.
DV_E_NOIVIEWOBJECT	Das -Objekt unterstützt die IViewObject-Schnittstelle nicht.

Hinweise

Die OleDraw-Hilfsfunktion ruft die QueryInterface-Methode für das angegebene Objekt (pUnk) auf und fragt nach einer IViewObject-Schnittstelle für dieses Objekt. Anschließend konvertiert OleDraw die RECT-Struktur in eine RECTL-Struktur und ruft IViewObject::D raw wie folgt auf:

lpViewObj->Draw(dwAspect,-1,0,0,0,hdcDraw,&rectl,0,0,0);

Verwenden Sie diese Funktion nicht, um in eine Metadatei zu zeichnen, da sie nicht den Parameter angibt, der zum Zeichnen in Metadateien erforderlich ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ole2.h (einschließlich Ole2.h)
Bibliothek	Ole32.lib
DLL	Ole32.dll
APIs	ext-ms-win-com-ole32-l1-1-3 (eingeführt in Windows 10, Version 10.0.10240)

Weitere Informationen

IViewObject::D raw

Freigeben über