ImageFond (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 des fenêtres, des pages et de leurs champs

Modification de l'image
Modification de l'image de fond dans un état
Limites

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

ImageFond (Propriété)

En anglais : BackgroundImage

La propriété ImageFond permet de connaître et de modifier l'image de fond d'un élément : fenêtre, page, champ ou état.

Remarques :

L'image de fond d'une fenêtre ou d'un champ est définie dans la fenêtre de description de l'élément (onglet "Général" ou "Image").
L'image de fond d'un état est définie dans la fenêtre de description de l'état (onglet "Fond").

Exemple

// Modification de l'image de fond de la fenêtre "FEN_SaisieClient"
FEN_SaisieClient.ImageFond = "C:\MesImages\Image.gif"

// -- Avant impression du bloc Haut_de_page
// Modification de l'image de fond de l'état
// Utiliser une page différente d'un PDF
MonEtat.ImageFondImprimée = Vrai
MonEtat.ImageFond = PDFExtraitPage("Fiche.pdf", 2)

Syntaxe

Connaître l'image de fond d'un champ, d'une fenêtre ou d'un état Masquer les détails

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

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

Nom et chemin de l'image de fond. Cette image de fond peut correspondre à :
L'image de fond d'une fenêtre (sauf des fenêtres de type mère MDI).
L'image de fond de la zone MDI d'une fenêtre de type mère MDI.
L'image associée au cadre d'un bouton.
L'image de fond d'une jauge ou d'un potentiomètre.
L'image de fond d'un état.
L'image de fond d'un champ Forme.
L'image de fond d'un champ Note repositionnable.
L'image de fond des pages, iFrames, Cellules, Superchamps, Modèles de champs, Option de menu, Champ Popup.
L'image de fond des Widgets de tableau de bord.

<Elément manipulé> : Nom de champ, nom de fenêtre, nom de page ou nom d'état

Nom de l'élément manipulé.

Modifier l'image de fond d'un champ, d'une fenêtre ou d'un état Masquer les détails

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

<Elément manipulé> : Nom de champ, nom de fenêtre, nom de page ou nom d'état

Nom de l'élément manipulé.

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

Nom et chemin (complet, relatif ou de type UNC) de la nouvelle image de fond. Cette image peut correspondre à :
L'image de fond d'une fenêtre (sauf des fenêtres de type mère MDI).
L'image de fond de la zone MDI d'une fenêtre de type mère MDI.
L'image associée au cadre d'un bouton.
L'image de fond d'une jauge ou d'un potentiomètre.
L'image de fond d'un état.
L'image de fond d'un champ Forme.
L'image de fond d'un champ Note repositionnable.
L'image de fond des pages, iFrames, Cellules, Superchamps, Modèles de champs, Option de menu, Champ Popup.
L'image de fond des Widgets de tableau de bord.

Remarques

Modification de l'image

Lors du changement de l'image, l'image est recherchée en premier dans la bibliothèque de l'application (fichier WDL) puis sur le disque à l'emplacement spécifié.

Remarque : Si on tente de remplacer l'image présente dans la WDL par une image de même nom présente sur le disque, le changement de l'image n'est pas réalisé.

Modification de l'image de fond dans un état

La propriété ImageFond est disponible dans tous les types d'états. La propriété ImageFond doit être appelée avant le début de l'impression de la page, par exemple dans l'événement "Avant impression du bloc haut de page".

Dans le cas d'un état sur formulaire :

la propriété ImageFond remplace l'image de fond choisie en édition. Tous les types d'images gérés dans les états sont disponibles (PDF, SVG, JPG, PNG, ...).
l'image est sauvegardée par page : il est ainsi possible de renseigner une image de fond différente pour chaque page imprimée.
lorsque la propriété est affectée, la nouvelle image de fond sera imprimée à partir du prochain saut de page.

Dans un état autre que formulaire :

l'image est dessinée en "homothétique".
cette propriété a un effet uniquement en impression réelle, dans le visualisateur de rapports et en export PDF. Elle est sans effet pour les autres types d'exports (RTF, XLS, HTML, XML).

Remarques :

La gestion des marges spécifiée dans l'onglet "Fond" de la description de l'état (option "Ignorer les marges physiques de l'imprimante") est ignorée : les marges physiques sont systématiquement ignorées.
La propriété ImageFondImprimée permet d'imprimer ou non l'image de fond de l'état. Si cette propriété vaut :
- Faux (valeur par défaut), l'impression peut être faite sur du papier pré-imprimé par exemple. L'image de fond apparaît uniquement dans le visualisateur de rapports.
- Vrai, lors de l'impression réelle, l'image de fond est également imprimée (ou exportée au format PDF).
Remarque : L'option "Comportement en impression réelle" présente dans l'onglet "Fond" de la fenêtre de description de l'état permet également d'effectuer ce paramétrage.

Limites