Función OleDraw (ole2.h)

Permite dibujar objetos más fácilmente. Puede usarlo en lugar de llamar directamente a IViewObject::D raw .

Sintaxis

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

Parámetros

[in] pUnknown

Puntero a la interfaz IUnknown en el objeto de vista que se va a dibujar.

[in] dwAspect

Cómo se va a representar el objeto. Las representaciones incluyen contenido, un icono, una miniatura o un documento impreso. Los valores posibles se toman de la enumeración DVASPECT .

[in] hdcDraw

Contexto de dispositivo en el que se va a dibujar. No puede ser un contexto de dispositivo de metarchivo.

[in] lprcBounds

Puntero a una estructura RECT que especifica el rectángulo en el que se debe dibujar el objeto. Este parámetro se convierte en una estructura RECTL y se pasa a IViewObject::D raw.

Valor devuelto

Esta función devuelve S_OK si se ejecuta correctamente. Otros valores posibles son los siguientes.

Comentarios

La función auxiliar OleDraw llama al método QueryInterface para el objeto especificado (pUnk), que solicita una interfaz IViewObject en ese objeto. Después, OleDraw convierte la estructura RECT en una estructura RECTL y llama a IViewObject::D raw de la siguiente manera:

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

No use esta función para dibujar en un metarchivo porque no especifica el parámetro necesario para dibujar en metarchivos.

Requisitos

Consulte también

IViewObject::Draw