DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Traitement de texte
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
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,
  • une table des matières.
Exemple
// Insère une image à la position du curseur
// Sélection du fichier image
sFichier est chaîne 
sFichier = fSélecteurImage(fRepEnCours(), "", ...
	"Insérer une image","JPEG (*.JPG)" + TAB + "*.jpg" + RC + ...
	"PNG (*.PNG)" + TAB + "*.png" + RC + "Tous les fichiers (*.*)" + TAB + "*.*")
SI sFichier = "" ALORS
	RETOUR
FIN
// Le fichier image est transféré dans une variable de type Image
img est une Image
img = sFichier
// Déclaration d'un élément de type Image (à insérer dans le document)
elt est un docElément
elt.Type = typeDocElémentImage
elt.Image.BufferImage = img
elt.Image.Habillage = docHabillageAlignéSurLeTexte

// Calcul des largeurs et hauteurs de l'image présente dans l'élément
// La taille de l'image est en pixels dans la variable de type Image. 
// Cette taille est convertie en mm dans l'élément (unité utilisée dans un document)
elt.Image.Largeur = img.Largeur * 25.4 / 96.0
elt.Image.Hauteur = img.Hauteur * 25.4 / 96.0
// Position de l'image
elt.Image.X = 0
elt.Image.Y = 0

DocInsère(TT_MonDocument, TT_MonDocument.Curseur, elt)
doc est un Document <- TT_MonDocument.Valeur
// Recherche de la position du signet 
fragmentSignet est un docFragment = doc.Signet["Signet 1"]
SI fragmentSignet <> Null ALORS
	// Insertion du texte à la fin du signet
	soit nPositionInsertion = fragmentSignet.PositionFin
	// Insertion à proprement dite
	DocInsère(TT_MonDocument, nPositionInsertion, "Texte à insérer à la position du signet")
SINON
	Erreur("Signet 'Signet 1' non trouvé dans le document")
FIN
Syntaxe

Insérer un objet à une position Masquer les détails

<Résultat> = DocInsère(<Document> , <Position> , <Elément>)
<Résultat> : Variable de type docFragment
Variable de type docFragment contenant le fragment inséré.
<Document> : Variable de type Document ou chaîne de caractères
Document à manipuler. Ce document correspond :
<Position> : Entier
Position à laquelle l'élément doit être inséré. Cette position est exprimée en nombre de caractères.
<Elément> : Type correspondant à l'élément à insérer
Elément à insérer :
  • Elément : Nom de la variable de type docElément correspondant à l'élément à insérer.
  • Document : Nom de la variable de type Document correspondant au document à insérer.
    Attention : Les éléments suivants du document inséré ne sont pas conservés :
    • La mise en page par défaut du document inséré (par exemple les marges).
    • Les paramètres de la section principale du document inséré (par exemple les entêtes et les pieds de page).
  • Paragraphe : Nom de la variable de type docParagraphe correspondant au paragraphe à insérer.
  • Texte sous forme de chaîne de caractères : Texte à insérer.
    Il est possible d'utiliser les constantes suivantes dans le texte à insérer pour gérer les différents sauts possibles :
    docSautDeColonneAjoute un saut de colonne dans une section multicolonne. Si la section n'est pas multicolonne, un saut de page est ajouté.
    docSautDeLigneAjoute un saut de ligne.
    docSautDePageAjoute un saut de page.
    docSautDeParagrapheAjoute un saut de paragraphe.
  • Image : Nom de la variable de type Image à insérer à la position spécifiée.
  • Fragment : Nom de la variable de type docFragment à insérer à la position spécifiée.

Remplacer un fragment par un objet (texte, document, fragment, paragraphe, ...) Masquer les détails

<Résultat> = DocInsère(<Fragment> , <Objet à manipuler>)
<Résultat> : Variable de type docFragment
Variable de type docFragment contenant le fragment inséré.
<Fragment> : Variable de type docFragment
Nom de la variable de type docFragment à manipuler. Le contenu de ce fragment sera remplacé par l'objet spécifié.
<Objet à manipuler> : Variable correspondant au type de l'objet
Objet remplaçant le contenu du fragment. Cet objet peut correspondre :
  • à une chaîne de caractères.
    Il est possible d'utiliser les constantes suivantes dans le texte pour gérer les différents sauts possibles :
    docSautDeColonneAjoute un saut de colonne dans une section multicolonne. Si la section n'est pas multicolonne, un saut de page est ajouté.
    docSautDeLigneAjoute un saut de ligne.
    docSautDePageAjoute un saut de page.
    docSautDeParagrapheAjoute un saut de paragraphe.
Classification Métier / UI : Code UI
Composante : wd300mdl.dll
Version minimum requise
  • Version 22
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 05/06/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale