PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Présentation du champ RTF
  • Le champ RTF est uniquement utilisable dans un état
  • Comment modifier le texte d'un champ RTF d'un état?
  • Remarques
  • Limitations
  • Transformer un champ Libellé ou un champ Rubrique en un champ RTF et inversement
  • Transformer un champ "Libellé" en champ "RTF"
  • Transformer un champ "Rubrique" en champ "RTF"
  • Transformer un champ "RTF" en champ "Rubrique" ou en champ "Libellé"
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
Présentation du champ RTF

Le champ RTF est uniquement utilisable dans un état

Le champ "RTF" (Rich Text Format) permet d'afficher une chaîne de caractères formatée dans votre état. Cette chaîne de caractères est au format RTF, c'est-à-dire que des balises spécifiques permettent de définir la mise en forme de chaque caractère ou chaîne de caractères. Ces balises ne sont pas affichées dans le champ, bien entendu.
Par exemple, un champ "RTF" permet d'afficher le texte suivant :
Pour créer un champ "RTF" :
  1. Sous l'éditeur d'états :
    • soit cliquez sur l'icône .
    • soit sélectionnez l'option "Insertion .. Nouveau champ .. Rich Edit (RTF)".
    Sous le volet "Création", dans le groupe "Champs usuels", cliquez sur "RTF".
    Sous le volet "Création", dans le groupe "Texte", cliquez sur "RTF".
  2. Cliquez dans l'état à la position où le champ doit être créé.
Remarques :
  • A partir de la version 22, le champ RTF d'un état correspond à un champ Libellé de type RTF.
  • Dans une fenêtre, il est possible d'utiliser un champ de saisie ou un libellé RTF. Pour plus de détails, consultez Champ de saisie ou Champ Libellé.
Comment modifier le texte d'un champ RTF d'un état?
Le texte d'un champ "RTF" peut être modifié :
  • par programmation (propriété ..Libellé).
    WINDEV Remarque : Il est également possible d'utiliser la fonction RTFCharge pour affecter le champ RTF.
  • sous l'éditeur d'états.
Pour modifier le texte du champ RTF sous l'éditeur d'états :
  1. Sélectionnez le champ. Les poignées de sélection apparaissent autour du champ.
  2. Cliquez une nouvelle fois sur le champ. Le curseur de la souris se transforme en curseur de saisie.
  3. Saisissez le nouveau texte du champ.
  4. Modifiez si nécessaire la mise en forme du texte grâce à la barre de mise en forme.
  5. Dès qu'un clic est effectué en dehors du champ, le champ repasse en affichage.

Remarques

  • Le texte affiché dans le champ RTF peut contenir la valeur d'une rubrique imprimée dans l'état.
    Pour insérer la valeur d'une rubrique ou d'un champ de l'état dans le texte du libellé, saisissez le nom de la rubrique ou du champ entre les caractères [% et %].
    Par exemple, le texte du champ peut correspondre à : Le fournisseur [%NomFournisseur%] vend le produit [%NomProduit%] pour [%PrixTTC%]. Les rubriques NomFournisseur, NomProduit et PrixTTC seront remplacées par leur valeur à l'exécution de l'état.
  • Le texte affiché dans le champ RTF peut provenir d'une rubrique de type texte présente dans la source de données de l'état.
    Si le champ est lié à une rubrique, le nom de la rubrique associée est affiché dans la combo "Rubrique liée" de l'onglet "Général" de la description du champ.

Limitations

Par défaut :
  • Le format des fichiers RTF gérés dans les impressions WINDEV et WEBDEV est le même que le format RTF géré par "Wordpad" (jusqu'à Windows XP). Quelques limites supplémentaires sont à noter lors de l'export d'un état vers un document RTF (par exemple, les tableaux et les zones de texte ne sont pas gérés).
  • Pour imprimer un champ RTF, le fichier "RICHED20.DLL" doit être présent sur le poste en cours. Le fichier "RICHED20.DLL" est généralement présent dans le répertoire système de Windows.
  • Si le fichier RTF est généré par un autre outil (Word...), afin de vérifier la compatibilité du RTF, il est conseillé d'ouvrir le fichier avec Wordpad. L'affichage du fichier sous Wordpad donnera un aperçu plus réel de ce qui sera imprimé.
  • Dans tous les cas, il est conseillé de ré-enregistrer le fichier avec Wordpad pour forcer le format du RTF.
  • Les options de zoom sur le champ RTF sont incompatibles avec l'affichage de liens dans le texte. Si des liens sont ajoutés avec la fonction AjouteLien, le zoom sera automatiquement forcé à 100%.
  • Il n'est pas possible de récupérer les tableaux et les images d'un document RTF dans un champ RTF.
    Versions 22 et supérieures
    Pour récupérer les tableaux et les images d'un document RTF dans un champ RTF, cochez l'option "RTF avec images et tableaux" (onglet "Général" de la fenêtre de description du champ). Dans ce cas, la compatibilité avec Wordpad et la présence du fichier RICHED20.DLL ne sont plus obligatoires.
    Nouveauté 22
    Pour récupérer les tableaux et les images d'un document RTF dans un champ RTF, cochez l'option "RTF avec images et tableaux" (onglet "Général" de la fenêtre de description du champ). Dans ce cas, la compatibilité avec Wordpad et la présence du fichier RICHED20.DLL ne sont plus obligatoires.
    Pour récupérer les tableaux et les images d'un document RTF dans un champ RTF, cochez l'option "RTF avec images et tableaux" (onglet "Général" de la fenêtre de description du champ). Dans ce cas, la compatibilité avec Wordpad et la présence du fichier RICHED20.DLL ne sont plus obligatoires.
Versions 17 et supérieures
Si vous utilisez la fonction iParamètre avec le paramètre "RTFWINDOWS=NON" ou la constante iRTFAvecImagesEtTableaux, l'impression des tableaux et des images dans les champs RTF est disponible. La compatibilité avec Wordpad et la présence du fichier RICHED20.DLL ne sont plus obligatoires.
Nouveauté 17
Si vous utilisez la fonction iParamètre avec le paramètre "RTFWINDOWS=NON" ou la constante iRTFAvecImagesEtTableaux, l'impression des tableaux et des images dans les champs RTF est disponible. La compatibilité avec Wordpad et la présence du fichier RICHED20.DLL ne sont plus obligatoires.
Si vous utilisez la fonction iParamètre avec le paramètre "RTFWINDOWS=NON" ou la constante iRTFAvecImagesEtTableaux, l'impression des tableaux et des images dans les champs RTF est disponible. La compatibilité avec Wordpad et la présence du fichier RICHED20.DLL ne sont plus obligatoires.
Transformer un champ Libellé ou un champ Rubrique en un champ RTF et inversement

Transformer un champ "Libellé" en champ "RTF"

Pour afficher du texte au format RTF dans un champ "Libellé" :
  1. Affichez la fenêtre de description du champ (option "Description" du menu contextuel du champ).
  2. Dans l'onglet "Détail", cochez l'option "Format RTF".
  3. Validez la fenêtre de description.
Le champ "Libellé" devient un champ "RTF". Toutes les caractéristiques du champ "Libellé" sont conservées.

Transformer un champ "Rubrique" en champ "RTF"

Pour afficher du texte au format RTF dans un champ "Rubrique" :
  1. Affichez la fenêtre de description du champ (option "Description" du menu contextuel du champ).
  2. Dans l'onglet "Détail", cochez l'option "Format RTF".
  3. Validez la fenêtre de description.
Le champ "Rubrique" devient un champ "RTF". Toutes les caractéristiques du champ "Rubrique" sont conservées.

Transformer un champ "RTF" en champ "Rubrique" ou en champ "Libellé"

Pour afficher les balises RTF ou pour lier le champ à une rubrique de type autre que texte :
  1. Affichez la fenêtre de description du champ (option "Description" du menu contextuel du champ).
  2. Dans l'onglet "Détail", décochez l'option "Format RTF".
  3. Validez la fenêtre de description.
Si le champ "RTF" est lié à une rubrique, le champ "RTF" devient un champ "Rubrique". Toutes les caractéristiques du champ "RTF" sont conservées.
Si le champ "RTF" n'est pas lié à une rubrique, le champ "RTF" devient un champ "Libellé". Toutes les caractéristiques du champ "RTF" sont conservées.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
adresse de messagerie
lors de la composition, l'adresse de messagerie est normale. A la confirmation pour sortir du champ, cette adresse est maintenue mais elle est suivie de la mention mailto:bidule@domaine.fr

impossible de supprimer cette mention inutile et qui va s'imprimer !
MARC CHERNET
25 aoû. 2018