diff options
Diffstat (limited to 'doc/refman.tex')
-rw-r--r-- | doc/refman.tex | 55 |
1 files changed, 48 insertions, 7 deletions
diff --git a/doc/refman.tex b/doc/refman.tex index d979708..489e0a7 100644 --- a/doc/refman.tex +++ b/doc/refman.tex @@ -1136,8 +1136,8 @@ In this chapter, we first list all commands by categories, then we details each \item{Transformations} : \cmdref{rotate} \cmdref{scale} \cmdref{tapply} \cmdref{tdelete} \cmdref{transform} \cmdref{translate} \cmdref{treset} \cmdref{tsave} -\item{Display list or priorities} : \cmdref{chggroup} \cmdref{group} \cmdref{lower} -\cmdref{raise} +\item{Groups, Display list and Priorities} : \cmdref{chggroup} \cmdref{find}('ancestors') \cmdref{group} \cmdref{lower} +\cmdref{raise} \item{Tag management} : \cmdref{addtag} \cmdref{dtag} \cmdref{find} \cmdref{gettags} \cmdref{hastag} @@ -1287,6 +1287,15 @@ reference) and all list parameters are given as array references. more on this subject). \item{\tt\large + pathname {\bf addtag} tag ancestors tagOrId ?tagOrId2?\\ + \$zinc->{\bf addtag}(tag, 'ancestors', tagOrId, ?tagOrId2?);} + + Selects all ancestors (i.e. parent groups) of tagOrId. If + {\tt tagOrId} names more than one item, the first, (or the topmost) + of these items in the display list will be used. If ?tagOrId2? is specified, + only parent groups with this tag are selected. + + \item{\tt\large pathname {\bf addtag} tag below tagOrId\\ \$zinc->{\bf addtag}(tag, 'below', tagOrId);} @@ -1724,11 +1733,43 @@ false. args}. See the \cmdref{addtag} command for an explanation of {\tt searchCommand} and the various {\tt args}. The items are sorted in drawing order, topmost first. \\ For example:\\ - \code{ \# to get the item under the mouse cursor:\\ \$item = \$zinc->find('withtag', - 'current');\\ - \# to get the closest item of a point:\\ \$closest = \$zinc->find ('closest', \$x, \$y); -} - + \code{ \# to get the item under the mouse cursor:\\ + \$item = \$zinc->find('withtag', 'current');\\ + \# to get the closest item of a point:\\ \$closest = \$zinc->find ('closest', \$x, \$y); + } + As detailled in \cmdref{addtag} command the following searchCommands are possible: + \begin{itemize} + \item{\tt\large + pathname {\bf find} above tagOrId \\ + \$zinc->{\bf find}('above', tagOrId);} + \item{\tt\large + pathname {\bf find} all ?inGroup? ?recursive?\\ + \$zinc->{\bf find}('all', ?inGroup?, ?recursive?);} + \item{\tt\large + pathname {\bf find} atpriority priority ?tagOrId?\\ + \$zinc->{\bf find}('atpriority', priority, ?tagOrId?);} + \item{\tt\large + pathname {\bf find} ancestors tagOrId ?tagOrId2?\\ + \$zinc->{\bf find}('ancestors', tagOrId, ?tagOrId2?);} + \item{\tt\large + pathname {\bf find} below tagOrId\\ + \$zinc->{\bf find}('below', tagOrId);} + \item{\tt\large + pathname {\bf find} closest x y ?halo? ?startItem?, ?recursive?\\ + \$zinc->{\bf find}('closest', x, y, ?halo?, ?startItem?, ?recursive?);} + \item{\tt\large + pathname {\bf find} enclosed xo yo xc yc ?inGroup? ?recursive?\\ + \$zinc->{\bf find}('enclosed', xo, yo, xc, yc, ?inGroup?, ?recursive?);} + \item{\tt\large + pathname {\bf find} overlapping xo yo xc yc ?inGroup? ?recursive?\\ + \$zinc->{\bf find}('overlapping', xo, yo, xc, yc, ?inGroup?, ?recursive?);} + \item{\tt\large + pathname {\bf find} withtag tagOrId\\ + \$zinc->{\bf find}('withtag', tagOrId);} + \item{\tt\large + pathname {\bf find} withtype type ?tagOrId?\\ + \$zinc->{\bf find}('withtype', type, ?tagOrId?);} + \end{itemize} \end{blockindent} |