summaryrefslogtreecommitdiffstats
path: root/doc/treectrl.n
diff options
context:
space:
mode:
Diffstat (limited to 'doc/treectrl.n')
-rw-r--r--doc/treectrl.n45
1 files changed, 44 insertions, 1 deletions
diff --git a/doc/treectrl.n b/doc/treectrl.n
index 932421f..9724c28 100644
--- a/doc/treectrl.n
+++ b/doc/treectrl.n
@@ -6,7 +6,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" $Id: treectrl.n,v 1.68 2007/10/23 23:04:33 treectrl Exp $
+'\" $Id: treectrl.n,v 1.69 2007/11/12 04:15:52 treectrl Exp $
.so man.macros
.TH "treectrl" n 2.2.3 treectrl "Tk Commands"
.BS
@@ -565,6 +565,17 @@ the user is dragging the right edge of the column.
.LP
.nf
.ta 6c
+Command-Line Switch: \fB-columntagexpr\fR
+Database Name: \fBcolumnTagExpr\fR
+Database Class: \fBColumnTagExpr\fR
+
+.fi
+.IP
+Specifies a boolean that enables or disables tag expressions in column
+descriptions. See \fBITEM AND COLUMN TAGS\fR.
+.LP
+.nf
+.ta 6c
Command-Line Switch: \fB-defaultstyle\fR
Database Name: \fBdefaultStyle\fR
Database Class: \fBDefaultStyle\fR
@@ -653,6 +664,17 @@ use it.
.LP
.nf
.ta 6c
+Command-Line Switch: \fB-itemtagexpr\fR
+Database Name: \fBitemTagExpr\fR
+Database Class: \fBItemTagExpr\fR
+
+.fi
+.IP
+Specifies a boolean that enables or disables tag expressions in item
+descriptions. See \fBITEM AND COLUMN TAGS\fR.
+.LP
+.nf
+.ta 6c
Command-Line Switch: \fB-itemwidth\fR
Database Name: \fBitemWidth\fR
Database Class: \fBItemWidth\fR
@@ -1020,6 +1042,27 @@ or equivalently:
.fi
will return the unique ids of any items with either "a" or "b" tags, but not both.
+.PP
+Within a tag expression a tag name may be enclosed in double quotes to avoid special
+processing of the operator characters. For example:
+.nf
+
+.t item id {tag {"a&&b"||c}}
+
+.fi
+will return the unique ids of any items with either "a&&b" or "c" tags; in this
+example the && is not treated as an operator. A double-quote may be escaped within
+a quoted tag name using a backslash '\\'.
+.PP
+Tag operators may be bypassed completely by setting the \fB-columntagexpr\fR and
+\fB-itemtagexpr\fR options. This can be useful if your application has column
+or item tags containing arbitrary text.
+.nf
+
+.t configure -itemtagexpr false
+.t item delete "tag a&&b"
+
+.fi
.SH "WIDGET COMMAND"
The \fBtreectrl\fR command creates a new Tcl command whose
name is the same as the path name of the treectrl's window.