Metodo IPicture::Render (ocidl.h)
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 |
---|---|
|
L'immagine è stata eseguita correttamente. |
|
L'indirizzo in prcWBounds non è valido quando hdc contiene un contesto del dispositivo metafile. |
|
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 |