Metodo IPicture::Render (ocidl.h)

Articolo
02/29/2024

Esegue il rendering (disegna) di una parte specificata dell'immagine definita dall'offset (xSrc,ySrc) dell'immagine di origine e delle dimensioni da copiare (cxSrc,xySrc). Questa immagine viene visualizzata nel contesto del dispositivo specificato, posizionata al punto (x,y) e ridimensionata alle dimensioni (cx,cy). Il parametro prcWBounds specifica la posizione del rendering se il contesto del dispositivo di destinazione è un metafile. Tali informazioni sono necessarie per inserire un metafile in un altro. Per altre informazioni, vedere il parametro prcWBounds di IViewObject2::D raw.

Sintassi

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
);

Parametri

[in] hDC

Handle del contesto del dispositivo su cui eseguire il rendering dell'immagine.

[in] x

Coordinata orizzontale in hdc in cui posizionare l'immagine di cui è stato eseguito il rendering.

[in] y

Coordinata verticale in hdc in cui posizionare l'immagine di cui è stato eseguito il rendering.

[in] cx

Dimensione orizzontale (larghezza) del rettangolo di destinazione.

[in] cy

Dimensione verticale (altezza) del rettangolo di destinazione

[in] xSrc

Offset orizzontale nell'immagine di origine da cui iniziare la copia.

[in] ySrc

Offset verticale nell'immagine di origine da cui iniziare la copia.

[in] cxSrc

Estensione orizzontale da copiare dall'immagine di origine.

[in] cySrc

Estensione verticale da copiare dall'immagine di origine.

[in] pRcWBounds

Puntatore a un rettangolo contenente la posizione della destinazione all'interno di un contesto del dispositivo metafile se hdc è un controller di dominio metafile. Non può essere NULL in questi casi.

Valore restituito

Questo metodo supporta i valori restituiti standard E_FAIL, E_INVALIDARG e E_OUTOFMEMORY, nonché quanto segue:

Codice restituito	Descrizione
S_OK	L'immagine è stata eseguita correttamente.
E_POINTER	L'indirizzo in prcWBounds non è valido quando hdc contiene un contesto del dispositivo metafile.
CTL_E_INVALIDPROPERTYVALUE	Il parametro cx, cy, cxSrc o cySrc ha un valore pari a zero.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ocidl.h

Vedi anche

IPicture

Condividi tramite