1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-06 06:20:55 -08:00

Document ses--row and ses--col dynamic binding.

* doc/translations/fr/misc/ses-fr.texi (Local printer functions)
* doc/misc/ses.texi (Local printer functions): Document `ses--row'
and `ses--col' being dynamically bound to the cell coordinates.

* doc/translations/fr/misc/ses-fr.texi (Nonrelocatable
references):
* doc/misc/ses.texi (Nonrelocatable references): `row' renamed to
`ses--row', and so for `col' to `ses--col'.
This commit is contained in:
Vincent Belaïche 2025-07-10 16:46:25 +02:00
parent b2e163ad98
commit 3c0f6584bf
2 changed files with 14 additions and 4 deletions

View file

@ -569,6 +569,10 @@ If you replace command @code{ses-define-local-printer} by function
the definition will occur only if a local printer with the same name the definition will occur only if a local printer with the same name
in not already defined. in not already defined.
Variables @code{ses--row} and @code{ses--col} are dynamically set to the
coordinates of the current cell, so that you may have the output depend
not only of the cell's content, but as well of its position.
@node Writing a lambda printer function @node Writing a lambda printer function
@subsection Writing a lambda printer function @subsection Writing a lambda printer function
@ -1290,8 +1294,8 @@ recorded as a dependency of this cell, so this cell will not be
updated automatically when @samp{B3} is changed, this is why using updated automatically when @samp{B3} is changed, this is why using
@code{ses-rename-cell} is most of the time preferable. @code{ses-rename-cell} is most of the time preferable.
The variables @code{row} and @code{col} are dynamically bound while a The variables @code{ses--row} and @code{ses--col} are dynamically bound
cell formula is being evaluated. You can use while a cell formula is being evaluated. You can use
@lisp @lisp
(ses-cell-value row 0) (ses-cell-value row 0)
@end lisp @end lisp

View file

@ -640,6 +640,11 @@ fonction @code{ses-define-if-new-local-printer}
la définition ne se produira que si aucune fonction dimpression de la définition ne se produira que si aucune fonction dimpression de
même nom nest déjà définie. même nom nest déjà définie.
Les variables @code{ses--row} et @code{ses--col} sont dynamiquement
réglées aux coordonnées de la cellule courante pendant l'évaluation de
la fonction d'impression, de sorte que vous pouvez faire dépendre la
sortie non seulement du contenu de la cellule mais aussi de sa position.
@node Writing a lambda printer function @node Writing a lambda printer function
@subsection Écrire une fonctions dimpression lambda @subsection Écrire une fonctions dimpression lambda
@ -1457,8 +1462,9 @@ cellule ne sera pas mise à jour automatiquement quand @samp{B3} est
modifiée, cest pourquoi lusage de @code{ses-rename-cell} est la modifiée, cest pourquoi lusage de @code{ses-rename-cell} est la
plupart du temps préférable. plupart du temps préférable.
Les variables @code{row} et @code{col} sont liées dynamiquement Les variables @code{ses--row} et @code{ses--col} sont liées
pendant lévaluation dune formule de cellule. Vous pouvez utiliser dynamiquement pendant lévaluation dune formule de cellule. Vous pouvez
utiliser
@lisp @lisp
(ses-cell-value row 0) (ses-cell-value row 0)
@end lisp @end lisp