OleDraw, fonction (ole2.h)

Article
03/04/2024

Permet de dessiner des objets plus facilement. Vous pouvez l’utiliser au lieu d’appeler IViewObject ::D raw directement.

Syntaxe

HRESULT OleDraw(
  [in] LPUNKNOWN pUnknown,
  [in] DWORD     dwAspect,
  [in] HDC       hdcDraw,
  [in] LPCRECT   lprcBounds
);

Paramètres

[in] pUnknown

Pointeur vers l’interface IUnknown sur l’objet de vue à dessiner.

[in] dwAspect

Comment l’objet doit être représenté. Les représentations incluent du contenu, une icône, une miniature ou un document imprimé. Les valeurs possibles sont extraites de l’énumération DVASPECT .

[in] hdcDraw

Contexte de périphérique sur lequel dessiner. Il ne peut pas s’agir d’un contexte d’appareil de métafichier.

[in] lprcBounds

Pointeur vers une structure RECT spécifiant le rectangle dans lequel l’objet doit être dessiné. Ce paramètre est converti en structure RECTL et passé à IViewObject ::D raw.

Valeur retournée

Cette fonction retourne S_OK en cas de réussite. Les autres valeurs possibles sont les suivantes.

Code de retour	Description
OLE_E_BLANK	Aucune donnée à partir de quoi dessiner.
E_ABORT	L’opération de dessin a été abandonnée.
VIEW_E_DRAW	Aucune donnée à partir de quoi dessiner.
OLE_E_INVALIDRECT	Le rectangle n’est pas valide.
E_INVALIDARG	Un ou plusieurs paramètres ne sont pas valides.
E_OUTOFMEMORY	Mémoire insuffisante pour l’opération.
DV_E_NOIVIEWOBJECT	L’objet ne prend pas en charge l’interface IViewObject .

Remarques

La fonction d’assistance OleDraw appelle la méthode QueryInterface pour l’objet spécifié (pUnk), en demandant une interface IViewObject sur cet objet. Ensuite, OleDraw convertit la structure RECT en structure RECTL et appelle IViewObject ::D raw comme suit :

lpViewObj->Draw(dwAspect,-1,0,0,0,hdcDraw,&rectl,0,0,0);

N’utilisez pas cette fonction pour dessiner dans un métafichier, car elle ne spécifie pas le paramètre requis pour le dessin dans les métafichiers.

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	ole2.h (inclure Ole2.h)
Bibliothèque	Ole32.lib
DLL	Ole32.dll
Ensemble d’API	ext-ms-win-com-ole32-l1-1-3 (introduit dans Windows 10, version 10.0.10240)

Voir aussi

IViewObject ::D raw

Partager via