Share via

OleDraw-Funktion (ole2.h)

  • Artikel

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