ImageFond (Propriété)

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").

Versions 15 et supérieures

Cette propriété est désormais disponible pour les applications Android.

Nouveauté 15

Cette propriété est désormais disponible pour les applications Android.

Versions 17 et supérieures

Cette propriété est désormais disponible pour les applications iPhone/iPad.

Nouveauté 17

Cette propriété est désormais disponible pour les applications iPhone/iPad.

Versions 18 et supérieures

Cette propriété est désormais disponible en mode Windows Store apps.

Nouveauté 18

Cette propriété est désormais disponible en mode Windows Store apps.

Versions 21 et supérieures

Cette propriété est désormais disponible en mode Universal Windows 10 App.

Nouveauté 21

Cette propriété est désormais disponible en mode Universal Windows 10 App.

Versions 22 et supérieures

Cette propriété est désormais disponible en code navigateur.

Cette propriété est désormais disponible pour les sites WEBDEV.

Cette propriété est désormais disponible pour les sites PHP.

Nouveauté 22

Cette propriété est désormais disponible en code navigateur.

Cette propriété est désormais disponible pour les sites WEBDEV.

Cette propriété est désormais disponible pour les sites PHP.

Cette propriété est désormais disponible en code navigateur.

Cette propriété est désormais disponible pour les sites WEBDEV.

Cette propriété est désormais disponible pour les sites PHP.

Exemple

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

Versions 20 et supérieures

// -- 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)

Nouveauté 20

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.
Versions 20 et supérieures
L'image de fond d'un état.
Nouveauté 20
L'image de fond d'un état.
L'image de fond d'un état.
Versions 21 et supérieures
L'image de fond d'un champ Forme.
Nouveauté 21
L'image de fond d'un champ Forme.
L'image de fond d'un champ Forme.
Versions 21 et supérieures
L'image de fond d'un champ Note repositionnable.
Nouveauté 21
L'image de fond d'un champ Note repositionnable.
L'image de fond d'un champ Note repositionnable.
Versions 22 et supérieures
L'image de fond des pages, iFrames, Cellules, Superchamps, Modèles de champs, Option de menu, Champ Popup.
Nouveauté 22
L'image de fond des pages, iFrames, Cellules, Superchamps, Modèles de champs, Option de menu, Champ Popup.
L'image de fond des pages, iFrames, Cellules, Superchamps, Modèles de champs, Option de menu, Champ Popup.
Versions 22 et supérieures
L'image de fond des Widgets de tableau de bord.
Nouveauté 22
L'image de fond des Widgets de tableau de bord.
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.
Versions 20 et supérieures
L'image de fond d'un état.
Nouveauté 20
L'image de fond d'un état.
L'image de fond d'un état.
Versions 21 et supérieures
L'image de fond d'un champ Forme.
Nouveauté 21
L'image de fond d'un champ Forme.
L'image de fond d'un champ Forme.
Versions 21 et supérieures
L'image de fond d'un champ Note repositionnable.
Nouveauté 21
L'image de fond d'un champ Note repositionnable.
L'image de fond d'un champ Note repositionnable.
Versions 22 et supérieures
L'image de fond des pages, iFrames, Cellules, Superchamps, Modèles de champs, Option de menu, Champ Popup.
Nouveauté 22
L'image de fond des pages, iFrames, Cellules, Superchamps, Modèles de champs, Option de menu, Champ Popup.
L'image de fond des pages, iFrames, Cellules, Superchamps, Modèles de champs, Option de menu, Champ Popup.
Versions 22 et supérieures
L'image de fond des Widgets de tableau de bord.
Nouveauté 22
L'image de fond des Widgets de tableau de bord.
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é.

Versions 20 et supérieures

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.

Nouveauté 20

Modification de l'image de fond dans un état

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.

Modification de l'image de fond dans un état

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

Dans une fenêtre, la propriété ImageFond s'applique uniquement aux :

fenêtres,
boutons,
jauges,
potentiomètres,
Versions 20 et supérieures
états.
Nouveauté 20
états.
états.
Versions 21 et supérieures
champs Forme dans une fenêtre.
Nouveauté 21
champs Forme dans une fenêtre.
champs Forme dans une fenêtre.
Versions 21 et supérieures
champs Note repositionnable dans une fenêtre.
Nouveauté 21
champs Note repositionnable dans une fenêtre.
champs Note repositionnable dans une fenêtre.