PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Insertion d'images
  • Hauteur de l'image (champ Liste ou champ Combo)
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Construit une séquence de caractères contenant une image.
L'image insérée peut être :
  • soit une image classique,
  • soit une image composée de plusieurs dessins. Cette image aura été préalablement découpée (grâce à la fonction ChargeImage ou à la fonction ChargePlancheImage).
Versions 22 et supérieures
Windows Cette fonction est désormais disponible pour les sites WEBDEV sous Windows.
Nouveauté 22
Windows Cette fonction est désormais disponible pour les sites WEBDEV sous Windows.
Windows Cette fonction est désormais disponible pour les sites WEBDEV sous Windows.
Exemple
Etats et Requêtes
// Ajout de l'image "C:\MesImages\Image.BMP" dans le champ "LISTE_Client"
ListeAjoute(LISTE_Client, gImage("C:\MesImages\Image.BMP"))
// Ajout d'une image constituée de plusieurs dessins
// Découpage en 10 lignes et 2 colonnes
// Chargement en mémoire de l'image "C:\MesImages\ImageDec.BMP"
ChargeImage(IDImage, "C:\MesImages\ImageDec.BMP", 10, 2)
POUR RangDessin = 1 A 10*2
ListeAjoute(LISTE_Client, gImage(IDImage, RangDessin))
FIN
// Ajout d'une image dans le titre d'une colonne d'un champ Table
TABLE_MaTable.COL_MaColonne..Titre = gImage("MonImage.BMP") + "Mon titre"
Syntaxe

Insérer une image classique Masquer les détails

<Résultat> = gImage(<Nom de l'image>)
<Résultat> : Chaîne de caractères
Séquence de caractères de la forme <Identifiant de l'image>, <Rang du dessin>.
<Nom de l'image> : Chaîne de caractères
  • Nom et chemin complet (ou relatif) de l'image à insérer. Un chemin de type UNC peut être utilisé.
  • Nom d'un champ Image contenant l'image à insérer.
Versions 25 et supérieures

Insérer une image contenue dans une variable Image Masquer les détails

<Résultat> = gImage(<Image> [, <Mode>])
<Résultat> : Chaîne de caractères
Séquence de caractères de la forme <Identifiant de l'image>, <Rang du dessin>.
<Image> : Variable de type image
Nom de la variable de type Image à insérer.
<Mode> : Constante optionnelle de type Entier
Mode d'affichage de l'image :
imgCentréCentrée : Image centrée dans le champ.
imgEtiréEtiré : Image déformée pour occuper toute la surface du champ.
imgHCHomothétique centré : Image agrandie ou rétrécie en respectant les proportions de l'image d'origine pour être affichée entièrement dans le champ et centrée dans le champ.
imgHEHomothétique étendu : Image agrandie ou rétrécie en respectant les proportions de l'image d'origine pour que le plus petit côté de l'image soit affiché entièrement dans le champ.
imgHECHomothétique étendu centré : Image agrandie ou rétrécie en respectant les proportions de l'image d'origine pour que le plus petit côté de l'image soit affiché entièrement dans le champ et que l'image soit centrée dans le champ.
imgHSAHomothétique sans agrandissement : Si l'image peut être affichée entièrement dans le champ, elle est affichée à 100%. Sinon, l'image est automatiquement réduite proportionnellement pour être affichée entièrement.
imgHSACHomothétique sans agrandissement : Si l'image peut être affichée entièrement dans le champ, elle est affichée à 100% et centrée dans le champ. Sinon, l'image est automatiquement réduite proportionnellement pour être affichée entièrement au centre du champ.
imgNormal100% : Image affichée à 100% en haut à gauche du champ.
imgSansEchelleEn mode "Grandes polices" de Windows, l'image affichée dans un champ Image est automatiquement zoomée.
La constante imgSansEchelle permet de ne pas zoomer l'image en mode "Grandes polices". Cette constante est utile notamment pour les champs dans lesquels un dessin est réalisé sur une image bitmap provenant d'une copie d'écran.
Cette constante doit être combinée avec une des constantes permettant de définir le mode d'affichage de l'image.
Nouveauté 25

Insérer une image contenue dans une variable Image Masquer les détails

<Résultat> = gImage(<Image> [, <Mode>])
<Résultat> : Chaîne de caractères
Séquence de caractères de la forme <Identifiant de l'image>, <Rang du dessin>.
<Image> : Variable de type image
Nom de la variable de type Image à insérer.
<Mode> : Constante optionnelle de type Entier
Mode d'affichage de l'image :
imgCentréCentrée : Image centrée dans le champ.
imgEtiréEtiré : Image déformée pour occuper toute la surface du champ.
imgHCHomothétique centré : Image agrandie ou rétrécie en respectant les proportions de l'image d'origine pour être affichée entièrement dans le champ et centrée dans le champ.
imgHEHomothétique étendu : Image agrandie ou rétrécie en respectant les proportions de l'image d'origine pour que le plus petit côté de l'image soit affiché entièrement dans le champ.
imgHECHomothétique étendu centré : Image agrandie ou rétrécie en respectant les proportions de l'image d'origine pour que le plus petit côté de l'image soit affiché entièrement dans le champ et que l'image soit centrée dans le champ.
imgHSAHomothétique sans agrandissement : Si l'image peut être affichée entièrement dans le champ, elle est affichée à 100%. Sinon, l'image est automatiquement réduite proportionnellement pour être affichée entièrement.
imgHSACHomothétique sans agrandissement : Si l'image peut être affichée entièrement dans le champ, elle est affichée à 100% et centrée dans le champ. Sinon, l'image est automatiquement réduite proportionnellement pour être affichée entièrement au centre du champ.
imgNormal100% : Image affichée à 100% en haut à gauche du champ.
imgSansEchelleEn mode "Grandes polices" de Windows, l'image affichée dans un champ Image est automatiquement zoomée.
La constante imgSansEchelle permet de ne pas zoomer l'image en mode "Grandes polices". Cette constante est utile notamment pour les champs dans lesquels un dessin est réalisé sur une image bitmap provenant d'une copie d'écran.
Cette constante doit être combinée avec une des constantes permettant de définir le mode d'affichage de l'image.

Insérer une image contenue dans une variable Image Masquer les détails

<Résultat> = gImage(<Image> [, <Mode>])
<Résultat> : Chaîne de caractères
Séquence de caractères de la forme <Identifiant de l'image>, <Rang du dessin>.
<Image> : Variable de type image
Nom de la variable de type Image à insérer.
<Mode> : Constante optionnelle de type Entier
Mode d'affichage de l'image :
imgCentréCentrée : Image centrée dans le champ.
imgEtiréEtiré : Image déformée pour occuper toute la surface du champ.
imgHCHomothétique centré : Image agrandie ou rétrécie en respectant les proportions de l'image d'origine pour être affichée entièrement dans le champ et centrée dans le champ.
imgHEHomothétique étendu : Image agrandie ou rétrécie en respectant les proportions de l'image d'origine pour que le plus petit côté de l'image soit affiché entièrement dans le champ.
imgHECHomothétique étendu centré : Image agrandie ou rétrécie en respectant les proportions de l'image d'origine pour que le plus petit côté de l'image soit affiché entièrement dans le champ et que l'image soit centrée dans le champ.
imgHSAHomothétique sans agrandissement : Si l'image peut être affichée entièrement dans le champ, elle est affichée à 100%. Sinon, l'image est automatiquement réduite proportionnellement pour être affichée entièrement.
imgHSACHomothétique sans agrandissement : Si l'image peut être affichée entièrement dans le champ, elle est affichée à 100% et centrée dans le champ. Sinon, l'image est automatiquement réduite proportionnellement pour être affichée entièrement au centre du champ.
imgNormal100% : Image affichée à 100% en haut à gauche du champ.
imgSansEchelleEn mode "Grandes polices" de Windows, l'image affichée dans un champ Image est automatiquement zoomée.
La constante imgSansEchelle permet de ne pas zoomer l'image en mode "Grandes polices". Cette constante est utile notamment pour les champs dans lesquels un dessin est réalisé sur une image bitmap provenant d'une copie d'écran.
Cette constante doit être combinée avec une des constantes permettant de définir le mode d'affichage de l'image.
Remarques

Insertion d'images

  • La fonction gImage peut être utilisée pour insérer une image :
    • dans les barres de titre et de message d'une fenêtre ou dans un champ Libellé.
    • dans un champ Table. Dans ce cas, l'image doit être insérée dans une colonne de type texte.
  • Pour afficher un texte sur une image :
    • Insérez une image avec la fonction gImage,
    • Décrivez la couleur de fond du texte avec la fonction gFond en utilisant la constante Transparent,
    • Affichez le texte.
      Par exemple :
      ListeAjoute(LISTE_ListeImage, gImage(CheminImage) + gFond(Transparent) + gCoord(0, 0) + ...
      "Texte")
  • Versions 17 et supérieures
    Si une ligne d'un champ Combo affiche une image à l'aide de la fonction gImage, lorsque cette ligne est sélectionnée, l'image est reprise en ligne principale.
    Nouveauté 17
    Si une ligne d'un champ Combo affiche une image à l'aide de la fonction gImage, lorsque cette ligne est sélectionnée, l'image est reprise en ligne principale.
    Si une ligne d'un champ Combo affiche une image à l'aide de la fonction gImage, lorsque cette ligne est sélectionnée, l'image est reprise en ligne principale.

Hauteur de l'image (champ Liste ou champ Combo)

La hauteur de l'image affichée dans un élément d'un champ Liste ou champ Combo est tronquée au nombre de pixels indiqué lors de la création du champ (onglet "Style" de la description du champ).
Classification Métier / UI : Code neutre
Composante : wd250mdl.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire