Skip to main content
Skip table of contents

TAB-ACTION

BUT

Ce mot clé permet dans une requête de type RCT de gérer les principales actions de gestion d’un Tableur Dynamique.

SYNTAXE

[VLO. Resultat ] = TAB-ACTION

TAB-ACT = [Action]

LIGNE = [CLO.« Ligne » ] [ VLO.Ligne ] [LIG-COU]

COLONNE = [CLO.« Colonne » ] [ VLO.Colonne ] [COL-COU]

TYPE = [Type]

CLE = [CLO.« Valeur » ] [VLO.Valeur ]

NB-LIGNE = [CLO.« Valeur » ] [VLO.Valeur ]

VALEUR = [CLO.« Valeur » ] [VLO.Valeur ]

ATTRIBUTS = [CLO.« Valeur » ] [VLO.Valeur ]

PARAMETRES

Paramètre

E/S

O

Type

Description

TAB-ACT

E

Oui

Caractère

  • REC-VAL : recherche d'une valeur de cellule

  • MAJ-VAL : mise à jour d'une valeur de cellule

  • POS-CEL : position cellule pour saisie après contrôle

  • MAJ-CLE : mise à jour clé d'une ligne

  • SUP-LIG : suppression de lignes

  • AJU-LIG : ajout de lignes (au-dessus)

  • AJD-LIG : ajout de lignes (en dessous)

  • MAJ-ATT : mise à jour de la couleur de fond, de la couleur et des attributs (gras, italique, barré, souligné) du texte d’une ligne.

  • REC-ATT : recherche de la couleur de fond, de la couleur et des attributs (gras, italique, barré, souligné) du texte d’une ligne

  • MAJ-ATC : mise à jour de la couleur de fond, de la couleur et des attributs (gras, italique, barré, souligné) du texte d’une cellule

  • REC-ATC : recherche de la couleur de fond, de la couleur et des attributs (gras, italique, barré, souligné) du texte d’une cellule

LIGNE

E

Oui

Entier

Ligne correspondante

COLONNE

E

Oui

Caractère

Colonne correspondante (idem REC-ZONE et INIT-ZONE).

CLE 

E

Oui

Caractère

Clé correspondante (pour MAJ-CLE)

NB-LIGNE 

E

Oui

Caractère

Nombre de lignes (pour SUP-LIG, AJU-LIG, AJD-LIG)

TYPE

E

Oui

Caractère

CARACTERE, NUMERIQUE, DATE ou LOGIQUE

VALEUR

E

Oui

Caractère

Valeur correspondante

ATTRIBUTS

E

Oui

Caractère

Liste chaînée contenant les attributs de couleur de fond et de couleur et attributs du texte

DETAIL DES ACTIONS

VLO. Resultat = TAB-ACTION ( TAB-ACT=REC-VAL, LIGNE=LIG-COU, COLONNE=COL-COU, TYPE=CARACTERE, VALEUR=VLO.Valeur )

L’action REC-VAL recherche la valeur d’une cellule (équivalent à REC-ZONE). VLO.Valeur contiendra la valeur trouvée. Ce doit être une variable du type précisé dans le paramètre « TYPE ». VLO.Resultat contiendra le résultat de la mise à jour :

  • <vide> = OK

  • *INC = erreur inconnue

  • *GESNUM = erreur de gestion de la numérotation (soit WfTabGen.GesNum est faux, soit une erreur interne s’est produite)

  • *COL = colonne passée en paramètre inconnue

  • *LIG = ligne passée en paramètre inconnue

Remarque : si le paramètre « TYPE » ne correspond pas au type de la cellule, DIAPASON fera une conversion pour obtenir une valeur dans le type souhaité. Dans ce cas, la valeur retournée peut être erronée.

VLO. Resultat = TAB-ACTION ( TAB-ACT=MAJ-VAL, LIGNE=CLO.8, COLONNE=COL-COU, TYPE=CARACTERE, VALEUR=VLO.Valeur )

L’action MAJ-VAL place une valeur dans une cellule (équivalent à INIT-ZONE). VLO.Valeur contient la valeur à mettre à jour. Ce doit être une variable du type précisé dans le paramètre « TYPE ». VLO.Resultat contiendra le résultat de la mise à jour.

Remarque : si le paramètre « TYPE » ne correspond pas au type de la cellule, DIAPASON fera une conversion pour alimenter la valeur dans le type souhaité. Dans ce cas, la valeur affichée peut être erronée.

VLO. Resultat = TAB-ACTION (TAB-ACT=MAJ-CLE, LIGNE= LIG-COU, CLE=VLO.Valeur )

L’action MAJ-CLE met à jour la clé d’une ligne (WfTabVal.CleLig). Cette clé est alimentée automatiquement pour les lignes créées dans la requête REB/RTD avec le contenu de la colonne précisée dans WfTabGen.CleCol.

VLO. Resultat = TAB-ACTION ( TAB-ACT=SUP-LIG, LIGNE=LIG-COU, NB-LIGNE=VLO.NbLigASup )

L’action SUP-LIG supprime n lignes à partir et en dessous de la ligne précisée dans le paramètre « LIGNE ». Chaque suppression de ligne va exécuter la requête RCT correspondante et un « LC-ERREUR » annule les suppressions suivantes.

VLO. Resultat = TAB-ACTION ( TAB-ACT=AJU-LIG, LIGNE=LIG-COU, NB-LIGNE=VLO.NbLigAInser )

L’action AJU-LIG ajoute n lignes au-dessus de la ligne précisée dans le paramètre « LIGNE ». Chaque création de ligne va exécuter la requête RCT correspondante et un « LC-ERREUR » annule les créations suivantes.

VLO. Resultat = TAB-ACTION ( TAB-ACT=AJD-LIG, LIGNE=LIG-COU, NB-LIGNE=VLO.NbLigAInser )

L’action AJD-LIG ajoute n lignes en dessous de la ligne précisée dans le paramètre « LIGNE ». Chaque création de ligne va exécuter la requête RCT correspondante et un « LC-ERREUR » annule les créations suivantes.

VLO. Resultat = TAB-ACTION ( TAB-ACT=MAJ-ATT,LIGNE=LIG-COU, ATTRIBUTS=VLO.Att )

L’action MAJ-ATT met à jour la couleur de fond ainsi que la couleur et les attributs du texte de la ligne précisée dans le paramètre « LIGNE », avec les attributs donnés dans le paramètre « ATTRIBUTS ».

La variable VLO.Att doit être initialisée comme suit :

VLO.Att = CLO."Référence_Apparence_Liste" où Référence_Apparence_Liste est une référence d’apparence liste définie dans le DIAPASON courant (visibles dans le « A Propos de DIAPASON » ou depuis l’application de définition des apparences listes)

OU

VLO.Att = CLO."LIG-BG=15;LIG-FG=VERT;LIG-AT=GRA"

  • Syntaxe pour couleur du fond de la ligne : LIG-BG. Si le paramètre passé à la fonction TAB-ACTION contient « LIG-BG= » suivi d’un code couleur, la couleur est appliquée à la ligne. Le code couleur doit faire partie de la liste suivante :

    • ROUGE

    • VERT

    • BLEU

    • MAUVE

    • JAUNE

    • ROSE

    • ORANGE

    • Un numéro de couleur DIAPASON (les couleurs sont visibles dans le « A propos de DIAPASON »)

    • Vide ou *DFT : couleur de fond normale (blanc)

  • Syntaxe pour couleur du texte de la ligne : LIG-FG. Si le paramètre passé à la fonction TAB-ACTION contient « LIG-FG= » suivi d’un code couleur, la couleur est appliquée à la ligne. Le code couleur doit faire partie de la liste suivante :

    • ROUGE

    • VERT

    • BLEU

    • MAUVE

    • JAUNE

    • ROSE

    • ORANGE

    • Un numéro de couleur DIAPASON (les couleurs sont visibles dans le « A propos de DIAPASON »)

    • Vide ou *DFT : couleur de texte normale (noir).

  • Syntaxe pour les attributs du texte de la ligne : LIG-AT. Si le paramètre passé à la fonction TAB-ACTION contient « LIG-AT= » suivi d’un code attribut, cet attribut est appliqué à la ligne. Le code attribut doit faire partie de la liste suivante :

    • GRA : gras

    • ITA : italique

    • BAR : barré

    • SOU : souligné

    • Vide ou *DFT : texte normal.

    • VLO. Resultat = TAB-ACTION ( TAB-ACT=REC-ATT,LIGNE=LIG-COU, ATTRIBUTS=VLO.Att )

L’action REC-ATT recherche la couleur de fond ainsi que la couleur et les attributs du texte de la ligne précisée dans le paramètre « LIGNE » et la variable VLO.Resultat contient la liste chaînée des attributs sous la forme :

VLO.Att = CLO."Référence_Apparence_Liste" où Référence_Apparence_Liste est une référence d’apparence liste définie dans le DIAPASON courant (visibles dans le « A Propos de DIAPASON » ou depuis l’application de définition des apparences listes)

OU

VLO.Att = "LIG-BG=couleur_de_fond;LIG-FG=couleur_du_texte;LIG-AT=attribut_du_texte"

  • Syntaxe pour couleur du fond de la ligne : LIG-BG. Le code couleur fait partie de la liste suivante :

    • ROUGE

    • VERT

    • BLEU

    • MAUVE

    • JAUNE

    • ROSE

    • ORANGE

    • Un numéro de couleur DIAPASON (les couleurs sont visibles dans le « A propos de DIAPASON »)

    • Vide ou *DFT : couleur de fond normale (blanc)

  • Syntaxe pour couleur du texte de la ligne : LIG-FG. Le code couleur fait partie de la liste suivante :

    • ROUGE

    • VERT

    • BLEU

    • MAUVE

    • JAUNE

    • ROSE

    • ORANGE

    • Un numéro de couleur DIAPASON (les couleurs sont visibles dans le « A propos de DIAPASON »)

    • Vide ou *DFT : couleur de texte normale (noir).

  • Syntaxe pour les attributs du texte de la ligne : LIG-AT. Le code attribut fait partie de la liste suivante :

    • GRA : gras

    • ITA : italique

    • BAR : barré

    • SOU : souligné

    • Vide ou *DFT : texte normal.

VLO. Resultat = TAB-ACTION ( TAB-ACT=MAJ-ATC,LIGNE=LIG-COU,COLONNE=COL-COU, ATTRIBUTS=VLO.Att )

L’action MAJ-ATC met à jour la couleur de fond ainsi que la couleur et les attributs du texte de la cellule précisée avec les paramètres « LIGNE » et « COLONNE », avec les attributs donnés dans le paramètre « ATTRIBUTS ».

La variable VLO.Att doit être initialisée comme suit :

VLO.Att = CLO."Référence_Apparence_Zone" où Référence_Apparence_Zone est une référence d’apparence zone définie dans le DIAPASON courant (visibles dans le « A Propos de DIAPASON » ou depuis l’application de définition des apparences zones)

OU

VLO.Att = CLO."LIG-BG=15;LIG-FG=VERT;LIG-AT=GRA"

  • Syntaxe pour couleur du fond de la cellule : LIG-BG. Si le paramètre passé à la fonction TAB-ACTION contient « LIG-BG= » suivi d’un code couleur, la couleur est appliquée à la cellule. Le code couleur doit faire partie de la liste suivante :

    • ROUGE

    • VERT

    • BLEU

    • MAUVE

    • JAUNE

    • ROSE

    • ORANGE

    • Un numéro de couleur DIAPASON (les couleurs sont visibles dans le « A propos de DIAPASON »)

    • Vide ou *DFT : couleur de fond normale (blanc)

  • Syntaxe pour couleur du texte de la cellule : LIG-FG. Si le paramètre passé à la fonction TAB-ACTION contient « LIG-FG= » suivi d’un code couleur, la couleur est appliquée à la cellule. Le code couleur doit faire partie de la liste suivante :

    • ROUGE

    • VERT

    • BLEU

    • MAUVE

    • JAUNE

    • ROSE

    • ORANGE

    • Un numéro de couleur DIAPASON (les couleurs sont visibles dans le « A propos de DIAPASON »)

    • Vide ou *DFT : couleur de texte normale (noir).

  • Syntaxe pour les attributs du texte de la ligne : LIG-AT. Si le paramètre passé à la fonction TAB-ACTION contient « LIG-AT= » suivi d’un code attribut, cet attribut est appliqué à la cellule. Le code attribut doit faire partie de la liste suivante :

    • GRA : gras

    • ITA : italique

    • BAR : barré

    • SOU : souligné

    • Vide ou *DFT : texte normal.

    • Syntaxe pour les attributs du texte de la ligne : LIG-APP

Si le paramètre passé à la fonction TAB-ACTION contient « LIG-APP= » suivi d’un code attribut, cet attribut est appliqué à la cellule. Le code attribut doit être une référence apparence de type liste définie dans le DIAPASON courant (visibles dans le « A Propos de DIAPASON » ou depuis l’application de définition des apparences listes).

VLO. Resultat = TAB-ACTION ( TAB-ACT=REC-ATC,LIGNE=LIG-COU,COLONNE=COL-COU, ATTRIBUTS=VLO.Att )

L’action REC-ATC recherche la couleur de fond ainsi que la couleur et les attributs du texte de la cellule précisée par les paramètres « LIGNE » et « COLONNE » et la variable VLO.Resultat contient la liste chaînée des attributs sous la forme :

"Référence_Apparence_Liste" : Code apparence de type liste .

OU

"LIG-BG=couleur_de_fond;LIG-FG=couleur_du_texte;LIG-AT=attribut_du_texte"

  • Syntaxe pour couleur du fond de la cellule : LIG-BG. Le code couleur fait partie de la liste suivante :

    • ROUGE

    • VERT

    • BLEU

    • MAUVE

    • JAUNE

    • ROSE

    • ORANGE

    • Un numéro de couleur DIAPASON (les couleurs sont visibles dans le « A propos de DIAPASON »)

    • Vide ou *DFT : couleur de fond normale (blanc)

  • Syntaxe pour couleur du texte de la cellule : LIG-FG. Le code couleur fait partie de la liste suivante :

    • ROUGE

    • VERT

    • BLEU

    • MAUVE

    • JAUNE

    • ROSE

    • ORANGE

    • Un numéro de couleur DIAPASON (les couleurs sont visibles dans le « A propos de DIAPASON »)

    • Vide ou *DFT : couleur de texte normale (noir).

  • Syntaxe pour les attributs du texte de la cellule : LIG-AT. Le code attribut fait partie de la liste suivante :

    • GRA : gras

    • ITA : italique

    • BAR : barré

    • SOU : souligné

    • Vide ou *DFT : texte normal.

  • Syntaxe pour les attributs du texte de la cellule : LIG-APP

    • La référence apparence liste fait partie des références définies dans le DIAPASON courant (visibles dans le « A Propos de DIAPASON » ou depuis l’application de définition des apparences listes)

EXEMPLES

Exemple 1 : Cette requête permet de mettre à jour la ligne suivant la ligne de saisie avec la valeur courante.

SI SCR.RCT_TypeAction = CLO."MOD"

COMMENTAIRE : "Recherche valeur courante"

VLO.Resultat = TAB-ACTION( TAB-ACT= REC-VAL , LIGNE= LIG-COU , COLONNE= COL-COU , TYPE= CARACTERE , VALEUR= VLO.ValeurC )

VLO.LigSuiv = SCR.RCT_NumLig + 1.

COMMENTAIRE : "Mise à jour ligne suivante"

VLO.Resultat = TAB-ACTION( TAB-ACT= MAJ-VAL , LIGNE= VLO.LigSuiv, COLONNE= COL-COU , TYPE= CARACTERE , VALEUR= VLO.ValeurC )

FIN BLOC

Exemple 2 : Cette requête permet de mettre à jour la « clé » de la ligne courante avec le contenu d’une colonne.

SI SCR.RCT_TypeAction = CLO."MOD"

COMMENTAIRE : "Recherche valeur de la clé"

VLO.Resultat = TAB-ACTION( TAB-ACT= REC-VAL , LIGNE= LIG-COU , COLONNE= CLO."Reference" , TYPE= CARACTERE , VALEUR= VLO.ValeurC )

COMMENTAIRE : "Mise à jour clé ligne"

VLO.Resultat = TAB-ACTION( TAB-ACT= MAJ-CLE , LIGNE= LIG-COU , CLE= VLO.ValeurC )

FIN BLOC

Exemple 3 : Cette requête permet de supprimer 2 lignes au-dessus de la courante.

VLO.LigASup = SCR.RCT_NumLig – CLO.2

VLO.Resultat = TAB-ACTION( TAB-ACT= SUP-LIG , LIGNE= VLO.LigASup , NB-LIGNE= CLO.2 )

Exemple 4 : Cette instruction permet d’insérer une ligne en dessous de la courante.

VLO.Resultat = TAB-ACTION( TAB-ACT= AJD-LIG , LIGNE= LIG-COU , NB-LIGNE= CLO.1 )

REMARQUES

Important : l’utilisation de cette fonction est possible à condition de renseigner « WFTabGen .GesNum » dans la requête REB/RTD correspondante. Si ce n’est pas le cas, la fonction renverra « *GESNUM ».

L’utilisation de « LC-ERREUR » dans une RCT déclenchée par un « TAB-ACTION » annule l’action prévue.

Les variables suivantes sont utiles avec le TAB-ACTION :

  • SCR.RCT_NumLig : numéro de la ligne courante.

  • SCR.RCT_CleLig : clé de la ligne courante

Dans cette version, l’utilisation de cette fonction en mode caractère est limitée à « REC-VAL » et « MAJ-VAL ».

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.