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

Article
03/04/2024

Affiche (dessine) une partie spécifiée de l’image définie par le décalage (xSrc,ySrc) de l’image source et les dimensions à copier (cxSrc,xySrc). Cette image est rendue dans le contexte d’appareil spécifié, positionnée au point (x,y) et mise à l’échelle aux dimensions (cx,cy). Le paramètre prcWBounds spécifie la position de ce rendu si le contexte de l’appareil de destination est lui-même un métafichier. Ces informations sont nécessaires pour placer un métafichier dans un autre. Pour plus d’informations, consultez le paramètre prcWBounds de IViewObject2 ::D raw.

Syntaxe

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

Paramètres

[in] hDC

Handle du contexte de l’appareil sur lequel afficher l’image.

[in] x

Coordonnée horizontale dans hdc à laquelle placer l’image rendue.

[in] y

Coordonnée verticale dans hdc à laquelle placer l’image rendue.

[in] cx

Dimension horizontale (largeur) du rectangle de destination.

[in] cy

Dimension verticale (hauteur) du rectangle de destination

[in] xSrc

Décalage horizontal dans l’image source à partir duquel commencer la copie.

[in] ySrc

Décalage vertical dans l’image source à partir duquel commencer la copie.

[in] cxSrc

Étendue horizontale à copier à partir de l’image source.

[in] cySrc

Étendue verticale à copier à partir de l’image source.

[in] pRcWBounds

Pointeur vers un rectangle contenant la position de la destination dans un contexte de périphérique de métafichier si hdc est un contrôleur de domaine de métafichier. Ne peut pas être NULL dans de tels cas.

Valeur retournée

Cette méthode prend en charge les valeurs de retour standard E_FAIL, E_INVALIDARG et E_OUTOFMEMORY, ainsi que les éléments suivants :

Code de retour	Description
S_OK	L’image a été restituée avec succès.
E_POINTER	L’adresse dans prcWBounds n’est pas valide lorsque hdc contient un contexte d’appareil de métafichier.
CTL_E_INVALIDPROPERTYVALUE	Le paramètre cx, cy, cxSrc ou cySrc a une valeur de zéro.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ocidl.h

Voir aussi

IPicture

Partager via