WP INSERER RUPTURE

4D v20 R7

WP INSERER RUPTURE


WP INSERER RUPTURE ( objCible ; typeRupture ; mode {; miseAJourPlage} )

Paramètre	Type	Description
objCible	Objet	Plage ou élément ou document 4D Write Pro
typeRupture	Entier long	Type de rupture à insérer
mode	Entier long	Mode d'insertion
miseAJourPlage	Entier long	Mode de mise à jour de la plage de sélection

Description

La commande WP INSERER RUPTURE insère une nouvelle rupture de type typeRupture dans la plage de sélection objCible selon le mode d'insertion mode et le paramètre miseAJourPlage.

Dans objCible, passez :

une plage, ou
un élément (tableau / ligne / paragraphe / corps / paragraphe / en-tête / pied / image en ligne / section / sous-section), ou
un document 4D Write Pro

Dans typeRupture, passez une des constantes suivantes, du thème Constantes 4D Write Pro, pour définir le type de rupture à insérer :

Constante	Type	Valeur	Comment
wk column break	Entier long	3	Saut de colonne : insère un saut de colonne
wk continuous section break	Entier long	5	Définit un saut de section continu (souvent utilisé pour modifier le nombre de colonnes sans commencer une nouvelle page).
wk line break	Entier long	0	Saut de ligne (dans le même paragraphe)
wk page break	Entier long	2	Saut de page : définit une nouvelle page
wk paragraph break	Entier long	4	Saut de paragraphe : définit un nouveau paragraphe
wk section break	Entier long	1	Saut de section: définit une nouvelle section

Dans le paramètre mode, passez une constante pour indiquer le mode d'insertion à utiliser pour la rupture dans la plage de sélection objCible :

Constante	Type	Valeur	Comment
wk append	Entier long	2	Insère le contenu à la fin de la cible
wk prepend	Entier long	1	Le contenu est inséré au début de la cible
wk replace	Entier long	0	Remplace le contenu de la cible

Si objCible est une plage, vous pouvez utiliser le paramètre optionnel miseAJourPlage pour passer une des constantes suivante et spécifier si le contenu est inclus dans la sélection résultante ou pas :

Constante	Type	Valeur	Comment
wk exclude from range	Entier long	1	Le contenu inséré n'est pas inclus dans la plage mise à jour
wk include in range	Entier long	0	Le contenu inséré est inclus dans la plage mise à jour (défaut)

Si vous ne passez pas un paramètre miseAJourPlage, par défaut, le contenu inséré sera inclus dans la plage mise à jour.

Si objCible n'est pas une plage, miseAJourPlage est ignoré.

Exemple 1

En construisant vos factures, vous souhaitez insérer un saut de page à chaque facture, excepté sur la dernière page :

 $nbInvoices:=Enregistrements trouves([INVOICE])

 Boucle($j;1;$nbInvoices)

    ... //traitement des factures

    Si($j#$nbInvoices) //on insère un saut de page, excepté sur la dernière

       WP INSERER RUPTURE($buildRange;wk page break;wk append;wk exclude from range)

    Fin de si

 Fin de boucle

Exemple 2

Vous souhaitez insérer un saut de section continu pour avoir une section à une seule colonne et une section à deux colonnes sur la même page.

Insérez un saut de section continu au niveau de la sélection pour créer une nouvelle section :

$range:=WP Plage selection(*;"WParea") WP INSERER RUPTURE($range;wk continuous section break;wk append)
Set the column count to 2 for the first section:

$section:=WP Lire section(WParea;1) WP FIXER ATTRIBUTS($section;wk column count;2)

Voir aussi

WP INSERER DOCUMENT
WP Lire sauts