LOADPICTURE |
Chargement d'une image |
|---|---|
| Visual Basic | |
Syntaxe
| Function LoadPicture(nomfichier As String, [widthDesired As Long], [heightDesired As Long], [flags As LoadPictureConstants = Default]) As IPictureDisp |
| Function LoadPicture(nomfichier As String, [Size As Integer], [ColorDepth As Integer], [X As Integer], [Y As Integer]) As IPictureDisp |
Paramètres
| Nom | Description |
|---|---|
| nomfichier | Ce paramètre permet d'indiquer le nom du fichier. |
| widthDesired | Ce paramètre permet d'indiquer la largeur souhaité. |
| heightDesired | Ce paramètre permet d'indiquer la hauteur souhaité. |
| flags | Ce paramètre permet d'indiquer les options de chargements. |
| Size | Ce paramètre permet d'indiquer la taille. |
| ColorDepth | Ce paramètre permet d'indiquer le nombre de couleur. |
| X | Ce paramètre permet d'indiquer la position X. |
| Y | Ce paramètre permet d'indiquer la position Y. |
Description
Cette fonction permet la lecture d'un «Canvas» contenu dans un fichier de type «Bitmap».
Remarques
- Les formats graphiques reconnus par LoadPicture incluent les fichiers bitmap (.bmp), les fichiers icône ( .ico), les fichiers encodés en longueur d'exécution (.rle), les fichiers métafichiers (.wmf), les métafichiers améliorés (.emf), les fichiers GIF (.gif) et les fichiers JPEG (.jpg).
- La fonction LoadPicture est utilisée pour charger une image depuis un fichier afin de l'afficher dans un contrôle visuel, comme un PictureBox ou une Form. Elle retourne un objet de type IPictureDisp, prêt à être utilisé dans l'interface utilisateur.
- Le premier paramètre nomfichier doit spécifier le chemin complet ou relatif du fichier image à charger. Si le fichier n'existe pas ou n'est pas lisible, la fonction retourne Nothing, sans provoquer d'erreur immédiate.
- Les paramètres optionnels widthDesired et heightDesired permettent de spécifier la taille souhaitée de l'image au moment du chargement, ce qui évite d'avoir à redimensionner l'image manuellement après coup.
- Le paramètre flags utilise des constantes LoadPictureConstants permettant de contrôler le comportement du chargement, comme forcer certaines dimensions, ignorer les erreurs, ou demander une conversion automatique du format.
- La seconde forme de la syntaxe permet de préciser des options avancées comme Size, ColorDepth, X et Y, offrant ainsi un contrôle plus poussé sur l'image chargée, par exemple pour adapter une image à des contraintes spécifiques d'affichage.
- Lorsque LoadPicture est utilisée sans spécifier les dimensions, l'image est chargée dans sa taille d'origine. Cela peut poser problème si l'interface attend une taille précise, et nécessiter un redimensionnement manuel.
- Pour optimiser les performances, il est conseillé d'utiliser LoadPicture de manière raisonnée, car charger plusieurs grandes images simultanément peut ralentir considérablement l'application ou consommer beaucoup de mémoire.
Exemple
Voici un exemple d'une utilisation typique de cette fonction :
- Sub Main()
- Set MonImage = LoadPicture("F:\Inetpub\wwwroot\test\normal.jpg")
- End Sub
Dernière mise à jour : Lundi, le 19 novembre 2012