PreviousNext
Help > Programmation avec LAUNCHER Office > Les commandes LNCCMD > Liste des commandes > Commande XLINSERT
Commande XLINSERT

 Insère une cellule, une plage de cellules, une ligne, une colonne dans la feuille de travail et décale les autres cellules.

 

Syntaxe

 

CHGVAR

VAR(&CMD) VALUE('XLINSERT')

CHGVAR

VAR(&PARM1) VALUE('
[Ref="Référence de cellules"]
[;Sheet="Nom de la feuille"]
[;Row=Numéro de ligne ou déplacement]
[;Col=Numéro de colonne ou déplacement]
[;Shift=xlShiftDown/xlShifToRight]
[;Count=nombre]
[;EntireRow=True/False]
[;EntireColumn=True/False]
[;After=True/False]
[;Fill=True/False

')

CHGVAR

VAR(&PARM2) VALUE(' ')

CALL

PGM(LNCCMD) PARM(&HANDLE &CMD &OPT &PARM1 + &PARM2 &RESULT)

 

Paramètres

Paramètres

 

Parm1

Ref : La référence à la cellule peut être donnée sous la forme :

- Syntaxe $B$3. Exemple : $B$3 désigne la colonne B, ligne 3.

- Syntaxe CL. C pour désigner la colonne et L pour désigner la ligne. Exemple : B3 désigne la ligne 3, et la colonne 2 (B).

- Nom symbolique donné à une cellule ou un groupe de cellules.

- "." désignera la cellule active.

 

Sheet : Indique le nom de la feuille à adresser.
Si un nom de cellule est indiqué par Ref, alors le mot clé Sheet n’est pas utile.
Sinon, si le mot clé Sheet est absent, c’est la feuille active qui est adressée.

 

Row, Col : Ces deux mots clés représentent respectivement :

- Les coordonnées (Ligne, Colonne) d’une cellule, si Ref est absent.

- Les coordonnées relatives en lignes et colonnes depuis la base référencée par "Ref=" quand ce dernier est présent. La cellule en haut à gauche a pour coordonnées relatives (1,1).

 

Shift= xlShiftToRight pour décaler les cellules vers la droite, ou xlShiftDown (défaut) pour décaler les cellules vers le bas.

 

Count=Nombre d’insertions à effectuer.

 

EntireRow=True pour insérer des lignes entières, ou False (défaut) pour décaler les cellules vers le bas sur la largeur de la sélection.
Cette option n’est valide que si Shift= xlShiftDown.

 

EntireColumn= True pour insérer des colonnes entières, ou False (défaut) pour décaler les cellules vers la droite sur la hauteur de la sélection.
Cette option n’est valide que si Shift= xlShiftToRight.

 

After=True pour insérer après la sélection, False (défaut) pour insérer à partir de la sélection.

 

Fill=True pour copier la sélection sur l’ensemble des nouvelles cellules insérées, False (défaut) pour laisser les nouvelles cellules vides.
Attention, quand Fill est vrai, il faut aussi que After soit vrai.
Cette option permet de copier les formules de calculs de la première ligne d’un tableau, vers toutes les nouvelles lignes.

 

 

Exemple

L’exemple suivant insère 1 ligne entière, à la position de la cellule active courante.

 

CHGVAR

VAR(&CMD) VALUE('XLINSERT')

CHGVAR

VAR(&PARM1) VALUE('EntireRow=True')

CHGVAR

VAR(&PARM2) VALUE(' ')

CALL

PGM(LNCCMD) PARM(&HANDLE &CMD &OPT &PARM1 +

&PARM2 &RESULT)

 

Insère 10 lignes entières, après la ligne 5, et dupliquer la ligne 5 sur les 10 lignes insérées.

 

CHGVAR

VAR(&CMD) VALUE('XLINSERT')

CHGVAR

VAR(&PARM1) +
VALUE('Ref="$A$5";Count=10;EntireRow=True; +
After =true;Fill=True')

CHGVAR

VAR(&PARM2) VALUE(' ')

CALL

PGM(LNCCMD) PARM(&HANDLE &CMD &OPT &PARM1 +

&PARM2 &RESULT)

 

Voir aussi

         XLCELLS