Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
Keine Daten zum Zeichnen. |
|
Der Zeichnungsvorgang wurde abgebrochen. |
|
Keine Daten zum Zeichnen. |
|
Das Rechteck ist ungültig. |
|
Mindestens ein Parameter ist ungültig. |
|
Unzureichender Arbeitsspeicher für den Vorgang. |
|
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) |