PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Présentation
  • Champ d'une fenêtre, d'un état ou d'une page statique ou dynamique
  • Utilisation dans une page
  • Créer un champ HTML
  • Notes
  • Champ d'une fenêtre
  • Incompatibilité entre l'ActiveX IE (et oAuth2) et l'utilisation d'assemblage .NET
  • Champ d'une page : largeur et hauteur variable
  • Champ d'un état
Produits
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurWINDEV MobileEtats et Requêtes
Plateformes
WindowsLinuxWindows MobileUniversal Windows 10 AppAndroidWidget AndroidiPhone/iPadApple Watch
Langages
JavaPHPAjaxCode Utilisateur (MCU)Langage Externe
Bases de données
HFSQLHFSQL Client/ServeurProcédures stockéesOLE DBODBCAccès Natifs
Présentation

Champ d'une fenêtre, d'un état ou d'une page statique ou dynamique

Versions 16 et supérieures
WINDEV MobileAndroid Les champs HTML sont désormais disponibles pour les applications Android.
WINDEV MobileUniversal Windows 10 App Les champs HTML sont disponibles pour les applications Windows Phone.
Nouveauté 16
WINDEV MobileAndroid Les champs HTML sont désormais disponibles pour les applications Android.
WINDEV MobileUniversal Windows 10 App Les champs HTML sont disponibles pour les applications Windows Phone.
WINDEV MobileAndroid Les champs HTML sont désormais disponibles pour les applications Android.
WINDEV MobileUniversal Windows 10 App Les champs HTML sont disponibles pour les applications Windows Phone.
Versions 17 et supérieures
WINDEV MobileiPhone/iPad Les champs HTML sont désormais disponibles pour les applications iPhone/iPad.
Nouveauté 17
WINDEV MobileiPhone/iPad Les champs HTML sont désormais disponibles pour les applications iPhone/iPad.
WINDEV MobileiPhone/iPad Les champs HTML sont désormais disponibles pour les applications iPhone/iPad.
Versions 18 et supérieures
WINDEVWINDEV MobileUniversal Windows 10 App Les champs HTML sont désormais disponibles pour les applications en mode Windows Store apps.
Nouveauté 18
WINDEVWINDEV MobileUniversal Windows 10 App Les champs HTML sont désormais disponibles pour les applications en mode Windows Store apps.
WINDEVWINDEV MobileUniversal Windows 10 App Les champs HTML sont désormais disponibles pour les applications en mode Windows Store apps.
Le champ HTML peut être utilisé :
  • WINDEVUniversal Windows 10 AppAndroidiPhone/iPad Dans une fenêtre. Le champ HTML d'une fenêtre permet d'afficher une page HTML.
  • WEBDEV - Code ServeurPHP Dans une page.
    Le champ HTML d'une page permet d'afficher ou d'utiliser du code HTML ou JavaScript. Ce code peut par exemple correspondre à des scripts HTML. Le champ HTML ne permet pas d'afficher une page HTML ou un site HTML. Ce champ permet juste d'afficher du code HTML.
  • Versions 18 et supérieures
    WINDEVWEBDEV - Code ServeurEtats et RequêtesWindowsWindows Mobile Dans un état. Le champ HTML d'un état permet d'imprimer un code HTML ou le contenu d'une page locale.
    Nouveauté 18
    WINDEVWEBDEV - Code ServeurEtats et RequêtesWindowsWindows Mobile Dans un état. Le champ HTML d'un état permet d'imprimer un code HTML ou le contenu d'une page locale.
    WINDEVWEBDEV - Code ServeurEtats et RequêtesWindowsWindows Mobile Dans un état. Le champ HTML d'un état permet d'imprimer un code HTML ou le contenu d'une page locale.
WEBDEV - Code ServeurPHP

Utilisation dans une page

Le champ HTML d'une page permet d'afficher ou d'utiliser du code HTML ou JavaScript. Ce code peut par exemple correspondre à des scripts HTML. Le champ HTML ne permet pas d'afficher une page HTML ou un site HTML. Ce champ permet juste d'afficher du code HTML.
Un champ HTML est programmable en code serveur uniquement si le champ est défini comme étant "Dynamique". Le champ HTML ne peut pas être associé à une rubrique d'un fichier de données.
Attention :
  • Lorsque le champ est défini comme étant dynamique, seule une affectation par programmation est possible.
  • Par défaut, le champ n'a pas l'option "Autoriser l'exécution des scripts" (onglet "Général" de la description du champ).
Si la fenêtre affichée dans le champ HTML contient des scripts, et si l'utilisateur clique sur des zones actives dans ce champ HTML (formulaires, onglet...), l'action demandée provoque l'ouverture du navigateur par défaut et affiche l'URL du champ HTML, afin de permettre à l'utilisateur d'exécuter ces scripts.
Pour autoriser la navigation de l'utilisateur au sein du champ HTML, cochez l'option "Autoriser l'exécution des scripts".
Créer un champ HTML
Pour créer un champ de type HTML :
  1. Sous l'éditeur de fenêtres ou de pages, cliquez sur l'icône Icône HTML (ou utilisez l'option de menu "Insertion .. Champ .. Champ Html").
  2. Cliquez dans la fenêtre ou dans la page à la position où le champ doit être créé. Le champ apparaît en création.
Pour afficher les caractéristiques du champ, sélectionnez l'option "Description" dans le menu contextuel du champ.
WINDEVWINDEV MobileUniversal Windows 10 AppAndroidiPhone/iPad Pour créer un champ de type HTML dans une fenêtre :
  1. Sous le volet "Création", dans le groupe "Autres champs", cliquez sur "HTML".
  2. Cliquez dans la fenêtre à la position où le champ doit être créé. Le champ apparaît en création.
Pour afficher les caractéristiques du champ, sélectionnez l'option "Description" dans le menu contextuel du champ.
WEBDEV - Code ServeurPHP Pour créer un champ de type HTML dans une page :
  1. Sous le volet "Création", dans le groupe "Intégration", cliquez sur "HTML".
  2. Cliquez dans la page à la position où le champ doit être créé. Le champ apparaît en création.
Pour afficher les caractéristiques du champ, sélectionnez l'option "Description" dans le menu contextuel du champ.
Versions 18 et supérieures
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindowsWindows Mobile Pour créer un champ de type HTML dans un état :
  1. Sous le volet "Création", dans le groupe "Champs usuels", cliquez sur "HTML".
  2. Cliquez dans l'état à la position où le champ doit être créé. Le champ apparaît en création.
Pour afficher les caractéristiques du champ, sélectionnez l'option "Description" dans le menu contextuel du champ.
Nouveauté 18
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindowsWindows Mobile Pour créer un champ de type HTML dans un état :
  1. Sous le volet "Création", dans le groupe "Champs usuels", cliquez sur "HTML".
  2. Cliquez dans l'état à la position où le champ doit être créé. Le champ apparaît en création.
Pour afficher les caractéristiques du champ, sélectionnez l'option "Description" dans le menu contextuel du champ.
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindowsWindows Mobile Pour créer un champ de type HTML dans un état :
  1. Sous le volet "Création", dans le groupe "Champs usuels", cliquez sur "HTML".
  2. Cliquez dans l'état à la position où le champ doit être créé. Le champ apparaît en création.
Pour afficher les caractéristiques du champ, sélectionnez l'option "Description" dans le menu contextuel du champ.
Notes
WINDEVWINDEV MobileUniversal Windows 10 AppAndroidiPhone/iPad

Champ d'une fenêtre

Dans la fenêtre de description du champ, il est possible :
  • soit de saisir directement du code HTML dans l'onglet "Général" du champ. Ce code doit obligatoirement être compris entre les balises <HTML> et </HTML>.
  • soit de saisir l'adresse de la page HTML à afficher.
Attention : Pour utiliser un champ HTML :
  • WINDEV dans une application WINDEV, il est nécessaire d'installer Internet Explorer 4 ou supérieure (version 11 conseillée) sur le poste de développement et sur le poste de déploiement de l'application.
  • Universal Windows 10 AppAndroidiPhone/iPad dans une application en mode simulateur, il est nécessaire d'installer Internet Explorer 4 ou supérieure (version 11 conseillée) sur le poste de développement.
  • Versions 21 et supérieures
    iPhone/iPad dans une application iOS 9.0 (et supérieur), il est nécessaire de respecter les options de sécurité. Par défaut, le champ HTML permet d'accéder uniquement aux sites utilisant une connexion HTTPS respectant les préconisations de la société Apple. Pour accéder à d'autres sites (HTTP par exemple), il est nécessaire soit de fournir la liste des domaines correspondants, soit de désactiver la sécurité pour tous les domaines. Ces manipulations sont faites dans l'assistant de création d'une application iOS. Pour plus de détails, consultez Générer une application iOS.
    Nouveauté 21
    iPhone/iPad dans une application iOS 9.0 (et supérieur), il est nécessaire de respecter les options de sécurité. Par défaut, le champ HTML permet d'accéder uniquement aux sites utilisant une connexion HTTPS respectant les préconisations de la société Apple. Pour accéder à d'autres sites (HTTP par exemple), il est nécessaire soit de fournir la liste des domaines correspondants, soit de désactiver la sécurité pour tous les domaines. Ces manipulations sont faites dans l'assistant de création d'une application iOS. Pour plus de détails, consultez Générer une application iOS.
    iPhone/iPad dans une application iOS 9.0 (et supérieur), il est nécessaire de respecter les options de sécurité. Par défaut, le champ HTML permet d'accéder uniquement aux sites utilisant une connexion HTTPS respectant les préconisations de la société Apple. Pour accéder à d'autres sites (HTTP par exemple), il est nécessaire soit de fournir la liste des domaines correspondants, soit de désactiver la sécurité pour tous les domaines. Ces manipulations sont faites dans l'assistant de création d'une application iOS. Pour plus de détails, consultez Générer une application iOS.
Versions 17 et supérieures
Android Remarque : L'option "Autoriser le zoom" (onglet "IHM" de la fenêtre de description du champ) permet à l'utilisateur d'utiliser les options de zoom dans le champ HTML.
Nouveauté 17
Android Remarque : L'option "Autoriser le zoom" (onglet "IHM" de la fenêtre de description du champ) permet à l'utilisateur d'utiliser les options de zoom dans le champ HTML.
Android Remarque : L'option "Autoriser le zoom" (onglet "IHM" de la fenêtre de description du champ) permet à l'utilisateur d'utiliser les options de zoom dans le champ HTML.
Remarques :
  • AndroidiPhone/iPad L'option "Autoriser le zoom" (onglet "IHM" de la fenêtre de description du champ) :
    • AndroidiPhone/iPad permet à l'utilisateur de modifier le zoom en écartant/resserrant les doigts.
    • Android affiche des boutons de zoom.
  • Android Pour jouer des vidéos HTML 5 dans un champ HTML :
    1. Cochez l'option "Autoriser l'exécution des scripts" (onglet "Général" de la fenêtre de description du champ).
    2. Activez l'accélération matériel sur la fenêtre. Pour cela, il faut éditer le manifeste de l'application.
      • Dans l'assistant de génération, affichez l'étape "Configuration".
      • Cliquez sur "Configuration avancée".
      • Cliquer sur "Editer le manifeste".
      • Déroulez le noeud "application".
      • Sélectionnez le noeud "activity" correspondant à la fenêtre contenant le champ HTML.
      • Ajoutez un attribut à ce noeud en lui donnant comme nom "android:hardwareAccelerated" et comme valeur "true".
      • Validez les modifications
      • Terminez l'assistant.
  • Universal Windows 10 App Il n'est pas possible de placer des champs au-dessus du champ HTML. En exécution, Windows place toujours le champ HTML au-dessus.
WINDEV

Incompatibilité entre l'ActiveX IE (et oAuth2) et l'utilisation d'assemblage .NET

Lorsque vous utilisez un champ HTML dans WINDEV, ce champ utilise l'ActiveX système "Navigateur Web Microsoft". Cet ActiveX est également utilisé par WINDEV pour toutes les authentifications OAuth2 (Facebook, Twitter, Google, etc) qui demandent une validation pour la connexion via du code HTML.
Si dans un même projet vous utilisez un champ HTML (ou une authentification OAuth2) et un assemblage ".Net", vous risquez de rencontrer une incompatibilité entre les couches .NET de Microsoft et l'ActiveX.
Il existe une API qui permet de gérer cette cohabitation. Pour cela vous devez utiliser la ligne de code suivante dans le code d'initialisation du projet ou dans le code d'initialisation de classes ou de procédure globale si l'initialisation de l'objet ".Net" est faite dans la classe ou la collection de procédure :
// Permet de gérer la cohabitation de l'ActiveX IE et de .NET
API("OLE32", "CoInitializeEx", Null, 2)
WEBDEV - Code Serveur

Champ d'une page : largeur et hauteur variable

Par défaut, les dimensions du champ HTML sont fixées sous l'éditeur. Si le contenu HTML du champ est plus important, le contenu est tronqué.
Pour modifier ce fonctionnement, cochez les options "Largeur variable" et "Hauteur variable" (onglet "Détail" de la fenêtre de description). Dans ce cas, les dimensions du champ HTML en exécution s'adapteront au contenu du champ, et les champs placés à côté ou en dessous seront décalés.
Versions 18 et supérieures
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindowsWindows Mobile

Champ d'un état

Dans la fenêtre de description du champ, il est possible de saisir directement du texte dans l'onglet "Général" du champ. Ce texte va automatiquement être converti en HTML.
Le champ HTML permet d'afficher par exemple :
  • le contenu d'un fichier HTML local.
  • le contenu HTML d'une rubrique.
Il est possible d'initialiser par programmation le champ HTML en lui affectant :
  • directement un code HTML. Par exemple :
    HTM_Code = "<b>Hello</b>"
  • le chemin d'un fichier HTML local.
    HTM_Code = fRepExe() + "\MonFicHTML.htm"
Remarques :
  • Les images au format PNG et SVG contenues dans le HTML ne sont pas gérées.
  • Si la feuille de styles CSS correspond à un fichier externe, elle n'est pas prise en compte.
  • Tous les fichiers externes à rechercher sur Internet ne sont pas pris en compte.
  • Les codes Javascript ne sont pas exécutés.
Nouveauté 18
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindowsWindows Mobile

Champ d'un état

Dans la fenêtre de description du champ, il est possible de saisir directement du texte dans l'onglet "Général" du champ. Ce texte va automatiquement être converti en HTML.
Le champ HTML permet d'afficher par exemple :
  • le contenu d'un fichier HTML local.
  • le contenu HTML d'une rubrique.
Il est possible d'initialiser par programmation le champ HTML en lui affectant :
  • directement un code HTML. Par exemple :
    HTM_Code = "<b>Hello</b>"
  • le chemin d'un fichier HTML local.
    HTM_Code = fRepExe() + "\MonFicHTML.htm"
Remarques :
  • Les images au format PNG et SVG contenues dans le HTML ne sont pas gérées.
  • Si la feuille de styles CSS correspond à un fichier externe, elle n'est pas prise en compte.
  • Tous les fichiers externes à rechercher sur Internet ne sont pas pris en compte.
  • Les codes Javascript ne sont pas exécutés.
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindowsWindows Mobile

Champ d'un état

Dans la fenêtre de description du champ, il est possible de saisir directement du texte dans l'onglet "Général" du champ. Ce texte va automatiquement être converti en HTML.
Le champ HTML permet d'afficher par exemple :
  • le contenu d'un fichier HTML local.
  • le contenu HTML d'une rubrique.
Il est possible d'initialiser par programmation le champ HTML en lui affectant :
  • directement un code HTML. Par exemple :
    HTM_Code = "<b>Hello</b>"
  • le chemin d'un fichier HTML local.
    HTM_Code = fRepExe() + "\MonFicHTML.htm"
Remarques :
  • Les images au format PNG et SVG contenues dans le HTML ne sont pas gérées.
  • Si la feuille de styles CSS correspond à un fichier externe, elle n'est pas prise en compte.
  • Tous les fichiers externes à rechercher sur Internet ne sont pas pris en compte.
  • Les codes Javascript ne sont pas exécutés.
Liste des exemples associés :
Le champ HTML Exemples unitaires (WINDEV) : Le champ HTML
[ + ] Utilisation d'un champ HTML
Propriété ClasseHTML Exemples unitaires (WEBDEV) : Propriété ClasseHTML
[ + ] La propriété ..ClasseHTML permet de lire et de modifier la valeur de l'attribut HTML "class" du champ.
La valeur de l'attribut HTML "class" permet, entre autres, de sélectionner les styles CSS appliqués sur le champ.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Affectation adresse par programmation sur Android
Contrairement à IOS, il est nécessaire sous Android de préfixer le chemin "file://" sinon "http://" est ajouté automatiquement devant le chemin.

Ce qui donne donc pour mon exemple : "file:///data/data/com.masociete.application/files/html/index.html" (triple "/")
Nicolas COMPAIN
01 sep. 2016