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

Artigo
02/29/2024

Renderiza (desenha) uma parte especificada da imagem definida pelo deslocamento (xSrc,ySrc) da imagem de origem e as dimensões a serem copiadas (cxSrc,xySrc). Essa imagem é renderizada no contexto do dispositivo especificado, posicionada no ponto (x,y) e dimensionada para as dimensões (cx,cy). O parâmetro prcWBounds especifica a posição dessa renderização se o contexto do dispositivo de destino for um metafile. Essas informações são necessárias para colocar um metarquivo em outro. Para obter mais informações, consulte o parâmetro prcWBounds de IViewObject2::D raw.

Sintaxe

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

Um identificador do contexto do dispositivo no qual renderizar a imagem.

[in] x

A coordenada horizontal no hdc na qual colocar a imagem renderizada.

[in] y

A coordenada vertical no hdc na qual colocar a imagem renderizada.

[in] cx

A dimensão horizontal (largura) do retângulo de destino.

[in] cy

A dimensão vertical (altura) do retângulo de destino

[in] xSrc

O deslocamento horizontal na imagem de origem da qual começar a copiar.

[in] ySrc

O deslocamento vertical na imagem de origem da qual começar a copiar.

[in] cxSrc

A extensão horizontal a ser copiada da imagem de origem.

[in] cySrc

A extensão vertical a ser copiada da imagem de origem.

[in] pRcWBounds

Um ponteiro para um retângulo que contém a posição do destino dentro de um contexto de dispositivo de metarquivo se hdc for um DC de metafile. Não pode ser NULL nesses casos.

Retornar valor

Esse método dá suporte aos valores de retorno padrão E_FAIL, E_INVALIDARG e E_OUTOFMEMORY, bem como o seguinte:

Código de retorno	Descrição
S_OK	A imagem foi renderizada com êxito.
E_POINTER	O endereço em prcWBounds não é válido quando o hdc contém um contexto de dispositivo de metarquivo.
CTL_E_INVALIDPROPERTYVALUE	O parâmetro cx, cy, cxSrc ou cySrc tem um valor igual a zero.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ocidl.h

Confira também

Ipicture