Fonction CVDOCPOS
La fonction CVDOCPOS renvoie des informations sur la position du curseur dans le document. Ces informations peuvent être utilisées pour créer des événements ou ajouter de nouvelles options de menu dans la zone de gel qui nécessitent la position du curseur pour fonctionner.
Syntaxe
CVDOCPOS("prop", <"type">)
L'argument prop définit le nom de la propriété à récupérer.
L'argument peut également spécifier l'une des propriétés par défaut suivantes afin de renvoyer des informations sur l'objet CaseView :
|
#CN |
Numéro de portable |
|
#CT |
La position du curseur dans un tableau est renvoyée sous la forme d'un numéro de cellule. En dehors d'un tableau, ce paramètre renvoie « ». Le nombre est calculé comme si une cellule existait dans les colonnes de ce tableau, même lorsqu'aucune cellule n'y figure. |
|
#TN |
Nom de la table |
|
#TR |
Numéro de ligne du tableau |
|
#TC |
Tableau Colonne Numéro |
Si aucun élément ne répond aux critères, une chaîne vide est renvoyée.
L'argument type est un argument facultatif qui permet de restreindre l'ensemble des objets à rechercher pour la propriété indiquée. Utilisez-le pour lever toute ambiguïté. Par exemple, si le curseur se trouve dans un tableau et que le tableau, la colonne du tableau et la ligne du tableau possèdent chacun une propriété « Supprimer », la fonction ne peut pas déterminer quelle valeur de propriété utiliser. Le type permet d'utiliser des commandes telles que « utiliser la propriété Ligne de tableau » ou « utiliser la propriété Section ».
Les types pouvant être utilisés dans le calcul sont les suivants :
|
P |
Paragraphe |
|
T |
Tableau |
|
TR |
Ligne |
|
TC |
Rubrique |
|
S |
Section |
|
D |
Paramètres du document |
La fonction CVDOCPOS() ne fonctionne que dans les zones suivantes.
-
Dans le volet « Verrouiller le volet » : Infobulles, calculs d'images, menus contextuels (clic gauche ou droit) et calculs de sélection contextuels ;
-
Dans l'ensemble du document : Menus contextuels (clic gauche ou clic droit)
Il est toujours recalculé en dernier, et n'est donc pas pris en compte dans l'ordre de recalcul.
Remarque
- S'il existe plusieurs objets possédant une propriété spécifique, l'ordre dans lequel la valeur de cette propriété est renvoyée n'est pas défini. Ce qui signifie qu'une valeur peut être renvoyée une fois, tandis qu'une autre peut l'être à un autre moment. De même, dans les versions futures, CaseView pourrait ne pas parcourir le document dans le même ordre, ce qui signifie que les résultats pourraient être différents.
-
Essayez d'éviter les situations où l'ordre a de l'importance. Si l'ordre a de l'importance, enchaînez plusieurs fonctions CVDOCPOS en demandant la valeur dans l'ordre requis.
Exemple 1
Si une fonction d'édition de tableau a été utilisée, mais qu'il fallait s'assurer qu'elle ne s'exécute pas lorsque le curseur ne se trouve pas sur une ligne du tableau, veuillez définir une condition de désactivation.
À désactiver si : CVDOCPOS("#TR") = ""
Si vous définissez cette option comme une fonction désactivée, cela signifie que lorsque le curseur ne se trouve pas sur une ligne du tableau (la position du curseur dans le tableau est nulle), la fonction ne s'exécutera pas.
Exemple 2
Si une barre d'outils permettant de supprimer des lignes a été créée, mais qu'il existe des lignes d'en-tête et des lignes de sous-total/total dont la suppression entraînerait des erreurs dans d'autres parties du document CaseView, il convient alors de désactiver cette fonction sur ces lignes spécifiques.
Accédez à Accueil | Tableau | Propriétés | Ligne | Propriétés personnalisées et ajoutez une propriété personnalisée de ligne de tableau intitulée « Supprimer » avec la valeur « Non ». Il est alors possible de désactiver la fonction de suppression de ligne lorsque le curseur ne se trouve pas dans un tableau OU lorsqu'il se trouve sur une ligne dont la propriété « Supprimer » est définie sur « Non ». Voici la syntaxe à saisir dans le champ Désactiver si :
CVDocPos("#TN") = ""|CVDocPos("Supprimer", "TR") = "Non"
Sujets connexes