PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Le format HTML
  • Champ de saisie au format HTML
  • Présentation
  • Remarques :
  • Définir le contenu d'un champ de saisie HTML
  • Mécanisme de sécurité du champ de saisie HTML
  • Connaître la position de la sélection dans un champ de saisie HTML
  • Utilisation des fonctions RTFxxx avec un champ de saisie HTML
  • Exemple : Passer le texte sélectionné en gras
  • Enregistrer un texte dans un fichier HTML
  • Exemple
  • Enregistrer du texte au format HTML dans une rubrique d'un fichier de données HFSQL
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Le format HTML
Le format HTML (HyperText Markup Language) est un langage de balisage utilisé essentiellement dans le domaine du web.
WINDEV et WEBDEV permettent de manipuler du texte au format HTML grâce à l'option "Format HTML" des champs de saisie et au champ HTML.
  • Si le texte au format HTML est affiché dans un champ ne reconnaissant pas le format HTML, les balises seront affichées.
  • Si le texte au format HTML est affiché dans un champ reconnaissant le format HTML, les balises seront automatiquement interprétées et le texte sera mis en forme.
Remarque : Pour utiliser un champ de saisie au format HTML, il est nécessaire de disposer de Microsoft Internet Explorer en version 6 ou supérieure sur le poste exécutant l'application.
Champ de saisie au format HTML

Présentation

Le champ de saisie HTML permet aussi bien d'afficher un texte au format HTML que de saisir un texte au format HTML.
Lors de la saisie d'un texte dans un champ HTML, ce texte est automatiquement mémorisé au format HTML par le champ. Ce texte contient toutes les balises nécessaires au formatage.

Remarques :

  • Il est possible d'afficher une barre de formatage au dessus du champ de saisie. Cette barre permet à l'utilisateur de mettre en forme rapidement le texte saisi. Pour plus de détails, consultez Barre de mise en forme HTML.
  • WINDEV Pour les applications fonctionnant sous Windows Vista (ou supérieur) ou sous Tablet PC, il est possible d'intégrer l'option "Saisie manuscrite". Cette option permet à l'utilisateur de saisir directement le texte dans le champ à l'aide du stylet ou de la souris. Cette fonctionnalité existe par défaut dans les applications fonctionnant sous Mobile.
  • Si vous saisissez un même texte dans un champ de saisie classique et dans un champ de saisie HTML, la taille de la chaîne de caractères présente dans le champ sera supérieure pour le champ de saisie HTML (car les balises HTML sont ajoutées).
Définir le contenu d'un champ de saisie HTML
Pour définir le contenu d'un champ de saisie HTML, il suffit d'affecter sa propriété ..Valeur par programmation (par exemple dans le code d'initialisation du champ).
Par exemple :
// Lecture d'un fichier HTML
PageHTML est une chaîne
PageHTML = fChargeTexte(SysRep(srMesDocuments) + ["\"] + "index.html")

// Initialisation du champ de saisie
SAI_ChampHTML = PageHTML
WINDEV

Mécanisme de sécurité du champ de saisie HTML

Les champs de saisie au format HTML disposent par défaut d'un mécanisme de sécurité contre le code malveillant.
Ce mécanisme est contrôlé :
  • sous l'éditeur grâce à l'option "Autoriser l'exécution des scripts" (onglet "Général" du champ),
  • par programmation grâce à la propriété ..SécuritéHTML.
Si le mécanisme de sécurité est actif (option décochée sous l'éditeur), tous les éléments actifs contenus dans le HTML sont bloqués par défaut. Les éléments actifs sont :
  • Le code Javascript.
  • Les applets Java.
  • Les plugins (correspondant aux balises <OBJECT> en HTML).
Remarque : Lorsque la propriété ..Etat du champ de saisie est égale à Actif, les éléments du champ sont en édition et les éléments actifs sont tous désactivés. La propriété ..SécuritéHTML est utile lorsque la valeur de la propriété ..Etat est égale à AffichageSeulement ou Inactif.
WINDEV

Connaître la position de la sélection dans un champ de saisie HTML

Pour connaitre la position de la sélection, il faut utiliser les propriétés ..Curseur et ..FinCurseur.
Remarque : Ces propriétés renvoient une valeur exprimée en nombre de caractères affichés dans le champ et non dans le code HTML correspondant.
WINDEV

Utilisation des fonctions RTFxxx avec un champ de saisie HTML

Les fonctions de gestion des champs RTF peuvent être utilisées avec un champ de saisie HTML. Quelques particularités sont à respecter :
FonctionParticularités
AjouteLienCette fonction est sans effet.
Son utilisation ne provoque pas d'erreur.
RTFAjouteCette fonction ne peut pas être utilisée sur les champs de saisie HTML.
Son utilisation provoque une erreur.
RTFChargeCette fonction ne peut pas être utilisée sur les champs de saisie HTML.
Son utilisation provoque une erreur.
RTFInsèreCette fonction ne peut pas être utilisée sur les champs de saisie HTML.
Son utilisation provoque une erreur.
RTFRechercheCette fonction ne peut pas être utilisée sur les champs de saisie HTML.
Son utilisation provoque une erreur.
RTFRemplaceCette fonction ne peut pas être utilisée sur les champs de saisie HTML.
Son utilisation provoque une erreur.
RTFSélectionSeule la syntaxe permettant de modifier le texte sélectionné est supportée. La syntaxe prenant en paramètre les positions de début etd e fin du texte à modifier provoquera une erreur.
RTFVersTexteCette fonction retourne le code source HTML.
WINDEVWindowsJava

Exemple : Passer le texte sélectionné en gras

Le code suivant, placé dans le code de sortie d'une champ de saisie au format HTML permet de passer le texte sélectionné en gras.
SI SAI_Saisie1..FinCurseur > SAI_Saisie1..Curseur ALORS
        RTFSélection(SAI_Saisie1, rtfGras, Vrai)
FIN
Enregistrer un texte dans un fichier HTML
Dans un champ de saisie HTML, le texte saisi est automatiquement au format HTML.
Pour enregistrer le contenu d'un champ de saisie au format HTML dans un fichier HTML, il suffit d'utiliser la fonction fSauveTexte sur le champ.

Exemple

Cet exemple permet de créer un fichier "index.html". Ce fichier contient le texte saisit dans le champ de saisie SAI_TexteHTML.
// Sélection du chemin et du nom du fichier
Nomfic est une chaîne
Nomfic = fSélecteur("", "", "Sélectionnez un fichier...", ...
"Fichiers HTML" + TAB + "*.html" + RC + "Tous fichiers (*.*)" + TAB + "*.*", ...
"HTML", fselCrée + fselExiste)

// Enregistrement
fSauveTexte(Nomfic, SAI_TexteHTML)

Enregistrer du texte au format HTML dans une rubrique d'un fichier de données HFSQL

Pour enregistrer un texte au format HTML dans une rubrique d'un fichier de données, il est conseillé de lier le champ de saisie à une rubrique de type Mémo texte.
En effet, le format HTML comprenant de nombreuses balises, une rubrique de type "Chaîne de caractères" est souvent de taille insuffisante.
Liste des exemples associés :
WD Mail Exemples complets (WINDEV) : WD Mail
[ + ] Cette application est un client mail complet développé en WINDEV. Il s'appuie sur les objets Email.
Ce client mail permet de récupérer et d'envoyer des emails en utilisant les protocoles POP, IMAP et SMTP.
Il est possible d'appliquer des filtres sur le courrier entrant.

L'application permet également de gérer plusieurs comptes emails différents. L'écriture d'un email s'appuie sur le champ de saisie HTML.
Version minimum requise
  • Version 15
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire