Image (Propriété)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / WLangage / Propriétés WLangage / Propriétés diverses

Image associée à un champ ou à un bloc d'un état
Image scannée dans un état
Image dans une option de menu
Image d'un onglet ou d'un volet d'onglet
Image des coches d'interrupteur et de sélecteur
Image de l'icône affichée dans l'Action Bar
Limites

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

Image (Propriété)

En anglais : Image

La propriété Image permet de connaître et de modifier l'image de fond associée à un élément.

Dans un état, la propriété Image permet de connaître et de modifier l'image de fond d'un champ ou d'un bloc.

Dans une fenêtre, la propriété Image permet de connaître et de modifier l'image :

affichée dans la barre d'icônes d'une fenêtre de type mère MDI (uniquement en WINDEV),
associée au libellé d'un bouton,
associée à un volet d'onglet ou à un onglet,
associée aux volets d'une boîte à outils ou à un bouton d'un volet de la boîte à outils,
associée au libellé d'une option de menu,
utilisée comme curseur dans une jauge ou dans un potentiomètre non rotatif,
utilisée pour la coche des interrupteurs ou des sélecteurs (uniquement en WINDEV),
utilisée dans les options des interrupteurs et sélecteurs au look Vista,
utilisée en image de fond d'un champ Calendrier.
utilisée dans un champ Notation.
utilisée pour les marqueurs d'un champ Carte.
utilisée en icône dans une Action Bar (propriété disponible à partir de la version 4.0 d'Android (Ice cream sandwich, api level 14)).
utilisée pour un regroupement lorsque le regroupement d'un ruban est fermé.
utilisée pour représenter une jauge infinie.

Dans une page, la propriété Image permet de connaître et de modifier l'image associée :

à un champ Image,
à un champ Web Caméra (code serveur uniquement),
à un bouton à image fixe (code navigateur uniquement),
à un champ Vignette,
à un champ Calendrier (image de fond).
à un champ Réseau social (dont l'image est personnalisée).
aux marqueurs d'un champ Carte.

Remarque : Ces images sont définies sous l'éditeur dans la description du champ, de la fenêtre ou de la page (onglet "Général" ou "Détail").

Exemple

// Modification de l'image associée au libellé du bouton "Aide"
BTN_Aide.Image = "C:\MesImages\Aide.ICO"

// Modification de l'image associée à la case à cocher d'un interrupteur
INT_Inter.Image = "C:\MesImages\Interrupteur_anim.gif"

// Modifier l'image de fond du champ "NomClient"
NomClient.Image ="C:\MesImages\Image.BMP"

Syntaxe

Connaître l'image de fond d'un élément d'un état Masquer les détails

<Résultat> = <Elément manipulé>.Image

<Résultat> : Chaîne de caractères

Nom et chemin complet de l'image de fond associée à l'objet spécifié.

<Elément manipulé> : Nom de champ ou nom de bloc

Nom de l'élément (champ ou bloc) à manipuler.

Modifier l'image de fond d'un élément d'un état Masquer les détails

<Elément manipulé>.Image = <Nouvelle image>

<Elément manipulé> : Nom de champ ou nom de bloc

Nom de l'élément (champ ou bloc) à manipuler.

<Nouvelle image> : Chaîne de caractères

Nom et chemin complet de la nouvelle image de fond associée à l'objet spécifié. Un chemin de type UNC peut être utilisé.

Connaître l'image associée à un champ ou à une fenêtre Masquer les détails

<Image actuelle> = <Elément manipulé>.Image

<Image actuelle> : Chaîne de caractères

Nom et chemin de l'image :
affichée dans la barre d'icônes d'une fenêtre de type mère MDI,
associée à la case à cocher d'un interrupteur ou sélecteur,
associée au libellé d'un bouton,
associée à un volet d'onglet ou à un onglet,
associée aux volets d'une barre d'outils ou à un bouton d'un volet
associée au libellé d'une option de menu,
utilisée comme curseur dans une jauge ou dans un potentiomètre non rotatif.
associée à l'option d'un champ Sélecteur ou Interrupteur au look Vista.
utilisée en image de fond d'un champ Calendrier.
associée à un champ Notation.
utilisée pour les marqueurs d'un champ Carte.
utilisée en icône dans une Action Bar.
associée à un regroupement fermé d'un ruban.
utilisée pour représenter une jauge infinie.

<Elément manipulé> : Nom de champ ou nom de fenêtre

Nom de l'élément à manipuler.

Modifier l'image associée à un champ ou à une fenêtre Masquer les détails

<Elément manipulé>.Image = <Nouvelle image>

<Elément manipulé> : Nom de champ ou nom de fenêtre

Nom de l'élément à manipuler.

<Nouvelle image> : Chaîne de caractères

Nom et chemin (complet, relatif ou de type UNC) de la nouvelle image :
affichée dans la barre d'icônes d'une fenêtre de type mère MDI,
associée à la case à cocher d'un interrupteur ou d'un sélecteur,
associée au libellé d'un bouton,
associée à un volet d'onglet ou à un onglet,
associée aux volets d'une barre d'outils ou à un bouton d'un volet
associée au libellé d'une option de menu,
utilisée comme curseur dans une jauge ou dans un potentiomètre non rotatif.
associée à l'option d'un champ Sélecteur ou Interrupteur au look Vista.
utilisée en image de fond d'un champ Calendrier.
associée à un champ Notation.
utilisée pour les marqueurs d'un champ Carte.
utilisée en icône dans une Action Bar.
associée à un regroupement fermé d'un ruban.
utilisée pour représenter une jauge infinie.

Connaître l'image associée à un champ d'une page Masquer les détails

<Image actuelle> = <Champ manipulé>.Image

<Image actuelle> : Chaîne de caractères

Nom et chemin de l'image.
En code serveur, le chemin complet de l'image est donné.
En code navigateur, le chemin de l'image est donné par rapport au répertoire _WEB du site (par exemple http://localhost/REWALI7_WEB/AXP01020_4E97E1FF_FR.gif).

<Champ manipulé> : Nom de champ

Nom du champ à manipuler.

Modifier l'image associée à un champ d'une page Masquer les détails

<Champ manipulé>.Image = <Nouvelle image>

<Champ manipulé> : Nom de champ

Nom du champ à manipuler.

<Nouvelle image> : Chaîne de caractères

Nom et chemin (complet, relatif ou de type UNC) de la nouvelle image :
Image statique : Modification sans effet
Image dynamique : chemin du type "image2.gif" (avec "image2.gif" dans le sous-répertoire "_WEB\" du projet)
Image générée : chemin complet du type "c:\mes images\image2.gif"

Remarques

Image associée à un champ ou à un bloc d'un état

L'image d'un champ Image peut être connue et/ou modifiée sous l'éditeur d'états dans l'onglet "Général" de la description du champ.
L'image de fond d'un champ ou d'un bloc peut être connue et/ou modifiée sous l'éditeur d'états, dans l'onglet "Style" de la description du champ ou du bloc. Il suffit de sélectionner l'élément "Image de fond".

Image scannée dans un état

La propriété Image ne permet pas de modifier l'image scannée d'un état. En effet, l'image scannée d'un état permet de :

faciliter le positionnement des différents champs dans l'état,
visualiser le résultat lors de l'aperçu avant impression.

Image dans une option de menu

Si une image est associée à une option de menu marquée, l'image remplace la marque.

Image d'un onglet ou d'un volet d'onglet

Pour modifier l'image d'un onglet (c'est-à-dire l'image des boutons de l'onglet), il suffit d'utiliser le code suivant :

ONG_Onglet.Image = "Exemple.jpg"

Pour modifier l'image affichée dans le bouton de l'onglet (à côté du libellé), il suffit de préciser l'indice de l'onglet à modifier :

ONG_Onglet[1].Image = "Exemple.jpg"

Image des coches d'interrupteur et de sélecteur

La propriété Image permet de changer la coche des interrupteurs et des sélecteurs. Cette propriété correspond à l'option "Image des coches" dans l'onglet "Détail" de la description du champ.

Si l'image de la coche ne doit pas être animée : l'image utilisée doit être constituée des deux ou trois états de la coche : Coché, Décoché et Indéfini si nécessaire.

Si l'image de la coche est animée, l'image utilisée doit être une image GIF, contenant pour chaque état principal (Coché, Décoché et Indéfini), les images suivantes :

Coche active (pas d'animation)
Coche enfoncée (animation)
Coche grisée (pas d'animation)
Coche survolée (animation)

Exemple d'image utilisée pour une coche animée :

1. Images pour l'état coché.

2. Images pour l'état décoché.

3. Images pour l'état indéfini.

Image de l'icône affichée dans l'Action Bar

La propriété Image permet de changer l'icône affichée dans l'Action Bar de la fenêtre. Si la propriété Image correspond à une chaîne vide (""), l'icône de l'application sera utilisée (cas par défaut).

Attention : cette propriété est disponible uniquement à partir de la version 4.0 d'Android (Ice cream sandwich, api level 14). Si la propriété Image est utilisée avec une version antérieure, elle sera sans effet.

Limites

Dans un état, la propriété Image ne peut pas être utilisée sur :

un état.
un code-barres.
un champ Interrupteur.

Formats d'images autorisés :

Les formats d'images pouvant être affichés sont les suivants : tous les formats décrits dans la fonction fFiltreImage.
Les formats d'images pouvant être affichés sont les suivants : BMP, ICO, JPEG, et GIF.

La propriété Image peut être utilisée uniquement sur :

une fenêtre de type MDI,
un bouton,
un volet d'onglet ou un onglet,
un volet d'une barre d'outils ou un bouton d'un volet,
une option de menu,
une jauge,
un potentiomètre non rotatif,
un interrupteur,
un sélecteur,
un champ Calendrier,
un champ Notation.
un marqueur d'un champ Carte.
un champ Jauge infinie personnalisé.

La propriété Image peut être utilisée uniquement sur :

un champ Image.
un champ Web Camera.
un champ Calendrier.
un champ Réseau social (dont l'image est personnalisée).
un marqueur d'un champ Carte.

La propriété Image peut être utilisée uniquement sur :

un bouton à image fixe.
un champ Image.
un marqueur d'un champ Carte.

La propriété Image s'applique uniquement aux éléments suivants :

Bouton.
Fenêtre.

Voir Aussi

Version minimum requise

Version 9

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 08/09/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale