Cette fonction permet de créer une image gérée sous forme d'interface COM.
En pratique, cette fonction permet de fournir à un contrôle d'une fenêtre Visual Adélia issu de l'intégration d'un ActiveX un pointeur d'interface IDispatch gérant l'image.
Les formats supportés sont : bmp, cut, emf, eps, ico, gif, iff, jpg, jp2, mng, pcx, png, ppm, pgm, pbm, psp, tif, tga, wmf. Avec le runtime Adélia Mobile, seuls les formats suivants sont supportés : bmp, gif, jpg, png et ico.
La notion de transparence n'est pas prise en compte.
Domaine d'application
Client Windows.
Paramètres
ALPHA(n) |
Entrée |
NomFichier |
Répertoire et nom du fichier contenant l'image. |
POINTEUR *IDispatch |
Sortie |
pDispImg |
Pointeur d'interface IDispatch sur l'image, ou *NULL en cas d'échec. |
NUM_BIN_4 |
Sortie |
CodeRetour |
Code retour de l'opération : 0 L'opération s'est déroulée correctement. -1 le chargement de l'image a échoué (format non supporté, chemin ou nom de fichier incorrect). Autre valeur : Erreur système inattendue. |
Par exemple
NomFichier = 'c:\DirImg\MyBitmapFile.bmp'
pDispImg = *NULL
APPELER_DLL 'VaToolBx.Dll' 'VaToolBxCreatePicture' NomFichier pDispImg CodeRetour
