Método IPicture::Render (ocidl.h)

Representa (dibuja) una parte especificada de la imagen definida por el desplazamiento (xSrc,ySrc) de la imagen de origen y las dimensiones que se van a copiar (cxSrc,xySrc). Esta imagen se representa en el contexto del dispositivo especificado, situado en el punto (x,y) y se escala a las dimensiones (cx,cy). El parámetro prcWBounds especifica la posición de esta representación si el contexto del dispositivo de destino es en sí mismo un metarchivo. Esta información es necesaria para colocar un metarchivo en otro. Para obtener más información, vea el parámetro prcWBounds de IViewObject2::D raw.

Sintaxis

HRESULT Render(
  [in] HDC                hDC,
  [in] LONG               x,
  [in] LONG               y,
  [in] LONG               cx,
  [in] LONG               cy,
  [in] OLE_XPOS_HIMETRIC  xSrc,
  [in] OLE_YPOS_HIMETRIC  ySrc,
  [in] OLE_XSIZE_HIMETRIC cxSrc,
  [in] OLE_YSIZE_HIMETRIC cySrc,
  [in] LPCRECT            pRcWBounds
);

Parámetros

[in] hDC

Identificador del contexto del dispositivo en el que se va a representar la imagen.

[in] x

Coordenada horizontal en hdc en la que se va a colocar la imagen representada.

[in] y

Coordenada vertical en hdc en la que se va a colocar la imagen representada.

[in] cx

Dimensión horizontal (ancho) del rectángulo de destino.

[in] cy

Dimensión vertical (alto) del rectángulo de destino

[in] xSrc

Desplazamiento horizontal en la imagen de origen desde la que se va a empezar a copiar.

[in] ySrc

Desplazamiento vertical en la imagen de origen desde la que se va a empezar a copiar.

[in] cxSrc

Extensión horizontal que se va a copiar desde la imagen de origen.

[in] cySrc

Extensión vertical que se va a copiar de la imagen de origen.

[in] pRcWBounds

Puntero a un rectángulo que contiene la posición del destino dentro de un contexto de dispositivo de metarchivo si hdc es un dc de metarchivo. No puede ser NULL en tales casos.

Valor devuelto

Este método admite los valores devueltos estándar E_FAIL, E_INVALIDARG y E_OUTOFMEMORY, así como lo siguiente:

Código devuelto	Descripción
S_OK	La imagen se ha representado correctamente.
E_POINTER	La dirección de prcWBounds no es válida cuando hdc contiene un contexto de dispositivo de metarchivo.
CTL_E_INVALIDPROPERTYVALUE	El parámetro cx, cy, cxSrc o cySrc tiene un valor de cero.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ocidl.h

Consulte también

IPicture