PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Propriétés spécifiques à la description des variables de type docFragment
  • Fonctions utilisant les variables de type docFragment
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 type docFragment permet de définir toutes les caractéristiques d'un fragment d’un document "docx". Les caractéristiques de ce fragment peuvent être définies et modifiées à l'aide de différentes propriétés WLangage.
Un fragment est défini par ses positions de début et de fin. Il peut donc :
  • s'étendre sur plusieurs paragraphes,
  • commencer au milieu d'un mot quelconque,
  • se terminer au milieu d'un mot quelconque.
Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable.
Exemple
// Changement de la couleur de la sélection
// Récupération de la sélection actuelle
MaSélection est un docFragment(TT_MonDocument, TT_MonDocument..Curseur, ...
TT_MonDocument..LongueurSélection)
// Changement de la couleur
MaSélection..Style..CouleurTexte = RougePastel
// Changement de la couleur de la sélection
// Récupération de la sélection actuelle
MaSélection est un docFragment(TT_MonDocument, TT_MonDocument..Curseur, ...
TT_MonDocument..LongueurSélection)
// Changement de la couleur
MaSélection..MiseEnForme..CouleurTexte = RougePastel
// Chargement du document
MonDoc est un Document = "c:\temp\doc.docx"

// Ajoute du texte à la fin du document
FragmentFin est un docFragment(MonDoc, -1 , 0)
FragmentFin..Texte += "Fin de document"
Syntaxe

Déclarer un fragment d'un document non décrit Masquer les détails

MaVariable est une docFragment
Dans ce cas, le fragment du document n'est pas décrit. La variable devra être affectée avec un fragment existant ou avec le résultat d'une des fonctions de manipulations de documents (par exemple avec la fonction DocRecherche).

Déclarer et décrire un fragment Masquer les détails

MaVariable est un docFragment([<Document> [, <Début du fragment> [, <Longueur>]]])
<Document> : Variable optionnelle de type Document ou chaîne de caractères (avec ou sans guillemets)
Document dans lequel l'extraction d'un fragment doit être effectuée. Ce document correspond :
  • WINDEV au nom d'un champ Traitement de texte.
  • à une variable de type Document.
<Début du fragment> : Entier optionnel
Position du début du fragment du document à manipuler. Cette position est donnée en nombre de caractères :
  • depuis le début du document (nombre positif).
  • depuis la fin du document (nombre négatif).
<Longueur> : Entier optionnel
Longueur du fragment à manipuler, exprimée en nombre de caractères.
Remarques

Propriétés spécifiques à la description des variables de type docFragment

Les propriétés suivantes peuvent être utilisées pour manipuler une variable de type docFragment :
Nom de la propriétéType manipuléEffet
ElémentTableau de docElémentEléments composant le fragment du document manipulé. Il est possible de parcourir les éléments du fragment via l'instruction POUR TOUT.
MotTableau de docFragmentMots composant le fragment du document manipulé. Il est possible de parcourir les mots du fragment via l'instruction POUR TOUT.
ParagrapheTableau de docParagrapheParagraphes concernés par le fragment (cas où un fragment est composé de plusieurs paragraphes). Il est possible de parcourir les paragraphes via l'instruction POUR TOUT.
PositionDébutEntierPosition du début du fragment. Cette position est relative au document entier.
PositionFinEntierPosition de fin du fragment. Cette position est relative au document entier.
StyleInformations des styles combinés de tous les éléments composant le fragment du document manipulé.
Style..AlignementVerticalConstante de type EntierParangonnage du texte :
  • alignementBaseline : Le texte est positionné sur la ligne de base.
  • alignementExposant : Le texte est positionné en exposant.
  • alignementIndice : Le texte est positionné en indice.
Style..CouleurSoulignéEntierCouleur utilisée pour souligner le texte. Cette couleur correspond :
  • soit à une couleur RVB (obtenue avec la fonction RVB).
  • soit à une couleur TSL (obtenue avec la fonction TSL),
  • soit à une couleur prédéfinie dans le WLangage.
Style..CouleurSurlignageEntierCouleur utilisée pour surligner le texte. Seules les couleurs suivantes sont disponibles :
  • Transparent
  • Noir
  • BleuClair
  • CyanClair
  • VertClair
  • MagentaClair
  • RougeClair
  • JauneClair
  • Blanc
  • BleuFoncé
  • CyanFoncé
  • VertFoncé
  • MagentaFoncé
  • RougeFoncé
  • JauneFoncé
  • GrisClair
  • GrisFoncé
Style..CouleurTexteEntierCouleur du texte. Cette couleur correspond :
  • soit à une couleur RVB (obtenue avec la fonction RVB).
  • soit à une couleur TSL (obtenue avec la fonction TSL),
  • soit à une couleur prédéfinie dans le WLangage.
Style..PoliceBarréeEntier
  • 0 : Police non barrée
  • 1 : Police barrée
  • 2 : Indéfini
Style..PoliceGrasEntier
  • 0 : Police non gras
  • 1 : Police gras
  • 2 : Indéfini
Style..PoliceItaliqueEntier
  • 0 : Police non italique
  • 1 : Police italique
  • 2 : Indéfini
Style..PoliceNomChaîne de caractèresNom de la police utilisée pour le fragment.
Style..PoliceSoulignéeConstante de type EntierType de soulignement :
  • soulignéAucun : Aucun soulignement
  • soulignéDouble : Soulignement double
  • soulignéEpais : Soulignement épais
  • soulignéMots : Soulignement des mots uniquement
  • soulignéPointillés : Soulignement en pointillés
  • soulignéPointillésEpais : Soulignement en pointillés épais
  • soulignéPointPointTiret : Soulignement avec des points et des tirets
  • soulignéPointPointTiretEpais : Soulignement avec des points et des tirets épais
  • soulignéPointTiret : Soulignement avec des tirets
  • soulignéPointTiretEpais : Soulignement avec des tirets épais
  • soulignéSimple : Soulignement simple
  • soulignéTiret : Soulignement avec des tirets
  • soulignéTiretEpais : Soulignement avec des tirets épais
Style..PoliceTailleRéelTaille de la police.
TexteChaîne de caractèresTexte brut correspondant au contenu du fragment manipulé.
Nom de la propriétéType manipuléEffet
ElémentTableau de docElémentEléments composant le fragment du document manipulé. Il est possible de parcourir les éléments du fragment via l'instruction POUR TOUT.
IdentifiantSousDocumentEntierIdentifiant correspondant au sous-document associé au fragment. Cette propriété est d'un usage avancé.
Attention : Cette propriété est disponible uniquement à partir de la version 220071.
LangueOrthographeChaîne de caractèresLangue du fragment. La notation utilisée correspond à la norme 639-1. Par exemple "FR-fr".
En lecture, cette propriété renvoie une information valide uniquement si le fragment correspond à une seule langue.
Remarque : Pour réaliser la correction orthographique correspondant à la langue du fragment, il est nécessaire de charger le dictionnaire de cette langue avec la fonction DictionnaireCharge.
Cette propriété est disponible uniquement à partir de la version 220059U (module du 17/05/2017).
MiseEnFormeVariable de type docMiseEnFormeInformations de mise en forme de tous les éléments composant le fragment du document manipulé.
Attention : A partir de WINDEV version 220052s (module de mise à jour du champ Traitement de Texte applicable sur WINDEV Update 1), la propriété "..Style" s'appelle désormais "..MiseEnForme".
MiseEnPage
Mise en page du fragment en cours.
Attention : Cette propriété est disponible uniquement à partir de la version 220071.
MiseEnPage..CouleurFondEntierCouleur de fond du fragment. Cette couleur peut correspondre :
MiseEnPage..TrameFondVariable de type FondCaractéristiques de fond du fragment.
MotTableau de docFragmentMots composant le fragment du document manipulé. Il est possible de parcourir les mots du fragment via l'instruction POUR TOUT.
ParagrapheTableau de docParagrapheParagraphes concernés par le fragment (cas où un fragment est composé de plusieurs paragraphes). Il est possible de parcourir les paragraphes via l'instruction POUR TOUT.
PositionDébutEntierPosition du début du fragment. Cette position est relative au document entier.
PositionFinEntierPosition de fin du fragment. Cette position est relative au document entier.
StyleIDChaîne de caractèresIdentifiant du style appliqué au fragment. Cet identifiant doit exister parmi les styles liés au document.
Remarque : le changement de style d'un paragraphe ou d'un fragment applique automatiquement le style paragraphe et le style caractère liés s'ils existent.
TexteChaîne de caractèresTexte brut correspondant au contenu du fragment manipulé.
TypeSousDocumentConstante de type EntierPartie du document auquel le fragment appartient.
Attention : Cette propriété est disponible uniquement à partir de la version 220071.
Les valeurs possibles sont les suivantes :
  • Versions 23 et supérieures
    typeSousDocCanvas : Conteneur d'images.
    Nouveauté 23
    typeSousDocCanvas : Conteneur d'images.
    typeSousDocCanvas : Conteneur d'images.
  • typeSousDocCorps : Corps du document.
  • typeSousDocEnTêtePageImpaire : Entête de page impaire.
  • typeSousDocEnTêtePagePaire : Entête de page paire.
  • typeSousDocEnTêtePremièrePage : Entête de la première page.
  • typeSousDocPiedDePageImpaire : Pied de page impaire.
  • typeSousDocPiedDePagePaire : Pied de page paire.
  • typeSousDocPiedDePremièrePage : Pied de page de la première page.
  • Versions 23 et supérieures
    typeSousDocZoneDeTexte : Zone de texte.
    Nouveauté 23
    typeSousDocZoneDeTexte : Zone de texte.
    typeSousDocZoneDeTexte : Zone de texte.
Cette propriété est disponible en lecture uniquement.

Remarque : Ces propriétés peuvent être utilisées en utilisant une des deux syntaxes suivantes :
  • <Nom de la variable>..<Nom de la propriété>
  • <Nom de la variable>.<Nom de la propriété>

Fonctions utilisant les variables de type docFragment

Versions 22 et supérieures
DocAjoute
Nouveauté 22
DocAjoute
DocAjoute
Ajoute :
  • à la fin d'un document de type Traitement de texte : un élément, un document, un paragraphe, un texte, une image ou un fragment.
  • à la fin d'un fragment : un élément, un texte ou une image.
Versions 22 et supérieures
DocInsère
Nouveauté 22
DocInsère
DocInsère
Insère un objet dans un document de type Traitement de texte ou remplace le contenu du fragment en cours. Les objets manipulables sont :
  • un élément,
  • un document,
  • un paragraphe,
  • un texte,
  • une image,
  • un fragment.
Versions 22 et supérieures
DocInsèreTableau
Nouveauté 22
DocInsèreTableau
DocInsèreTableau
Insère un tableau dans un document de type Traitement de texte.
Versions 22 et supérieures
DocRecherche
Nouveauté 22
DocRecherche
DocRecherche
Recherche une chaîne de caractère dans l’ensemble d’un document de type Traitement de texte.
Versions 22 et supérieures
DocSélectionne
Nouveauté 22
DocSélectionne
DocSélectionne
Sélectionne un fragment dans un champ Traitement de texte.
Version minimum requise
  • Version 22
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire