'\"
|
'\"
|
'\" Copyright (c) 1996, Expert Interface Technologies
|
'\" Copyright (c) 1996, Expert Interface Technologies
|
'\"
|
'\"
|
'\" See the file "license.terms" for information on usage and redistribution
|
'\" See the file "license.terms" for information on usage and redistribution
|
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
|
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
|
'\"
|
'\"
|
'\" The file man.macros and some of the macros used by this file are
|
'\" The file man.macros and some of the macros used by this file are
|
'\" copyrighted: (c) 1990 The Regents of the University of California.
|
'\" copyrighted: (c) 1990 The Regents of the University of California.
|
'\" (c) 1994-1995 Sun Microsystems, Inc.
|
'\" (c) 1994-1995 Sun Microsystems, Inc.
|
'\" The license terms of the Tcl/Tk distrobution are in the file
|
'\" The license terms of the Tcl/Tk distrobution are in the file
|
'\" license.tcl.
|
'\" license.tcl.
|
.so man.macros
|
.so man.macros
|
'----------------------------------------------------------------------
|
'----------------------------------------------------------------------
|
.HS tixHList tix 4.0
|
.HS tixHList tix 4.0
|
.BS
|
.BS
|
'
|
'
|
'
|
'
|
'----------------------------------------------------------------------
|
'----------------------------------------------------------------------
|
.SH NAME
|
.SH NAME
|
tixHList \- Create and manipulate Tix Hierarchial List widgets
|
tixHList \- Create and manipulate Tix Hierarchial List widgets
|
'
|
'
|
'
|
'
|
'----------------------------------------------------------------------
|
'----------------------------------------------------------------------
|
.SH SYNOPSIS
|
.SH SYNOPSIS
|
\fBtixHList\fI \fIpathName ?\fIoptions\fR?
|
\fBtixHList\fI \fIpathName ?\fIoptions\fR?
|
'
|
'
|
'
|
'
|
'----------------------------------------------------------------------
|
'----------------------------------------------------------------------
|
.PP
|
.PP
|
.SH SUPER-CLASS
|
.SH SUPER-CLASS
|
None.
|
None.
|
'
|
'
|
'----------------------------------------------------------------------
|
'----------------------------------------------------------------------
|
.SH "STANDARD OPTIONS"
|
.SH "STANDARD OPTIONS"
|
'
|
'
|
.LP
|
.LP
|
.nf
|
.nf
|
.ta 4c 8c 12c
|
.ta 4c 8c 12c
|
\fBbackground\fR \fBborderWidth\fR \fBcursor\fR \fBforeground\fR
|
\fBbackground\fR \fBborderWidth\fR \fBcursor\fR \fBforeground\fR
|
\fBfont\fR \fBheight\fR \fBhighlightColor \fBhighlightThickness
|
\fBfont\fR \fBheight\fR \fBhighlightColor \fBhighlightThickness
|
\fBrelief\fR \fBselectBackground\fR \fBselectForeground\fR
|
\fBrelief\fR \fBselectBackground\fR \fBselectForeground\fR
|
\fBxScrollCommand\fR \fByScrollCommand\fR \fBwidth\fR
|
\fBxScrollCommand\fR \fByScrollCommand\fR \fBwidth\fR
|
.ta 4c
|
.ta 4c
|
.fi
|
.fi
|
.LP
|
.LP
|
See the \fBoptions(n)\fR manual entry for details on the standard options.
|
See the \fBoptions(n)\fR manual entry for details on the standard options.
|
'
|
'
|
'
|
'
|
'----------------------------------------------------------------------
|
'----------------------------------------------------------------------
|
.SH "WIDGET-SPECIFIC OPTIONS"
|
.SH "WIDGET-SPECIFIC OPTIONS"
|
'
|
'
|
'----------BEGIN
|
'----------BEGIN
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBbrowsecmd\fR
|
Name: \fBbrowsecmd\fR
|
Class: \fBBrowseCmd\fR
|
Class: \fBBrowseCmd\fR
|
Switch: \fB\-browsecmd\fR
|
Switch: \fB\-browsecmd\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies a TCL command to be executed when the user browses through the
|
Specifies a TCL command to be executed when the user browses through the
|
entries in the HList widget.
|
entries in the HList widget.
|
'----------END
|
'----------END
|
'
|
'
|
'----------BEGIN
|
'----------BEGIN
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBcolumns\fR
|
Name: \fBcolumns\fR
|
Class: \fBColumns\fR
|
Class: \fBColumns\fR
|
Switch: \fB\-columns\fR
|
Switch: \fB\-columns\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies the number of columns in this HList widget. This option can
|
Specifies the number of columns in this HList widget. This option can
|
only be set during the creation of the HList widget and cannot be
|
only be set during the creation of the HList widget and cannot be
|
changed subsequently.
|
changed subsequently.
|
'----------END
|
'----------END
|
'
|
'
|
'----------BEGIN
|
'----------BEGIN
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBcommand\fR
|
Name: \fBcommand\fR
|
Class: \fBCommand\fR
|
Class: \fBCommand\fR
|
Switch: \fB\-command\fR
|
Switch: \fB\-command\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies the TCL command to be executed when the user invokes a list
|
Specifies the TCL command to be executed when the user invokes a list
|
entry in the HList widget. Normally the user invokes a list
|
entry in the HList widget. Normally the user invokes a list
|
entry by double-clicking it or pressing the Return key.
|
entry by double-clicking it or pressing the Return key.
|
'----------END
|
'----------END
|
'
|
'
|
'----------BEGIN
|
'----------BEGIN
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBdrawBranch\fR
|
Name: \fBdrawBranch\fR
|
Class: \fBDrawBranch\fR
|
Class: \fBDrawBranch\fR
|
Switch: \fB\-drawbranch\fR
|
Switch: \fB\-drawbranch\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
A Boolean value to specify whether branch line should be drawn to
|
A Boolean value to specify whether branch line should be drawn to
|
connect list entries to their parents.
|
connect list entries to their parents.
|
'----------END
|
'----------END
|
'
|
'
|
'
|
'
|
'----------BEGIN
|
'----------BEGIN
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBforeground\fR
|
Name: \fBforeground\fR
|
Class: \fBForeground\fR
|
Class: \fBForeground\fR
|
Switch: \fB\-foreground\fR
|
Switch: \fB\-foreground\fR
|
Alias: \fB\-fg\fR
|
Alias: \fB\-fg\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
\fB[OBSOLETE]\fR Specifies the default foreground color for the list entries.
|
\fB[OBSOLETE]\fR Specifies the default foreground color for the list entries.
|
'----------END
|
'----------END
|
'
|
'
|
'
|
'
|
'----------BEGIN
|
'----------BEGIN
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBgap\fR
|
Name: \fBgap\fR
|
Class: \fBGap\fR
|
Class: \fBGap\fR
|
Switch: \fB\-gap\fR
|
Switch: \fB\-gap\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
\fB[OBSOLETE]\fR The default distance between the bitmap/image and the
|
\fB[OBSOLETE]\fR The default distance between the bitmap/image and the
|
text in list entries.
|
text in list entries.
|
'----------END
|
'----------END
|
'
|
'
|
'----------BEGIN
|
'----------BEGIN
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBheader\fR
|
Name: \fBheader\fR
|
Class: \fBHeader\fR
|
Class: \fBHeader\fR
|
Switch: \fB\-header\fR
|
Switch: \fB\-header\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
A Boolean value specifying whether headers should be displayed for
|
A Boolean value specifying whether headers should be displayed for
|
this HList widget (see the \fBheader\fR widget command below).
|
this HList widget (see the \fBheader\fR widget command below).
|
'----------END
|
'----------END
|
'
|
'
|
'----------BEGIN
|
'----------BEGIN
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBheight\fR
|
Name: \fBheight\fR
|
Class: \fBHeight\fR
|
Class: \fBHeight\fR
|
Switch: \fB\-height\fR
|
Switch: \fB\-height\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies the desired height for the window in number of characters.
|
Specifies the desired height for the window in number of characters.
|
'----------END
|
'----------END
|
'
|
'
|
'----------BEGIN
|
'----------BEGIN
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBindent\fR
|
Name: \fBindent\fR
|
Class: \fBIndent\fR
|
Class: \fBIndent\fR
|
Switch: \fB\-indent\fR
|
Switch: \fB\-indent\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies the amount of horizontal indentation between a list entry
|
Specifies the amount of horizontal indentation between a list entry
|
and its children. Must be a valid screen distance value.
|
and its children. Must be a valid screen distance value.
|
'----------END
|
'----------END
|
'
|
'
|
'----------BEGIN
|
'----------BEGIN
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBindicator\fR
|
Name: \fBindicator\fR
|
Class: \fBIndicator\fR
|
Class: \fBIndicator\fR
|
Switch: \fB\-indicator\fR
|
Switch: \fB\-indicator\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies whether the indicators should be displayed inside the HList
|
Specifies whether the indicators should be displayed inside the HList
|
widget. See the \fBindicator\fR widget command below.
|
widget. See the \fBindicator\fR widget command below.
|
'----------END
|
'----------END
|
'
|
'
|
'
|
'
|
'----------BEGIN
|
'----------BEGIN
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBindicatorCmd\fR
|
Name: \fBindicatorCmd\fR
|
Class: \fBIndicatorCmd\fR
|
Class: \fBIndicatorCmd\fR
|
Switch: \fB\-indicatorcmd\fR
|
Switch: \fB\-indicatorcmd\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies a TCL command to be executed when the user manipulates the
|
Specifies a TCL command to be executed when the user manipulates the
|
indicator of an HList entry. The \fB\-indicatorcmd\fR is triggered
|
indicator of an HList entry. The \fB\-indicatorcmd\fR is triggered
|
when the user press or releases the mouse button over the indicator in
|
when the user press or releases the mouse button over the indicator in
|
an HList entry. By default the TCL command specified by
|
an HList entry. By default the TCL command specified by
|
\fB\-indicatorcmd\fR is executed with one additional argument, the
|
\fB\-indicatorcmd\fR is executed with one additional argument, the
|
entryPath of the entry whose indicator has been triggered. Additional
|
entryPath of the entry whose indicator has been triggered. Additional
|
information about the event can be obtained by the \fBtixEvent\fR
|
information about the event can be obtained by the \fBtixEvent\fR
|
command.
|
command.
|
'----------END
|
'----------END
|
'
|
'
|
'
|
'
|
'----------BEGIN
|
'----------BEGIN
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBitemType\fR
|
Name: \fBitemType\fR
|
Class: \fBItemType\fR
|
Class: \fBItemType\fR
|
Switch: \fB\-itemtype\fR
|
Switch: \fB\-itemtype\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies the default type of display item for this HList widget. When
|
Specifies the default type of display item for this HList widget. When
|
you call the add and addchild widget commands, display items of this
|
you call the add and addchild widget commands, display items of this
|
type will be created if the \fB\-itemtype\fR option is not specified .
|
type will be created if the \fB\-itemtype\fR option is not specified .
|
'----------END
|
'----------END
|
'
|
'
|
'----------BEGIN
|
'----------BEGIN
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBpadX\fR
|
Name: \fBpadX\fR
|
Class: \fBPad\fR
|
Class: \fBPad\fR
|
Switch: \fB\-padx\fR
|
Switch: \fB\-padx\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
\fB[OBSOLETE]\fR The default horizontal padding for list entries.
|
\fB[OBSOLETE]\fR The default horizontal padding for list entries.
|
'----------END
|
'----------END
|
'
|
'
|
'----------BEGIN
|
'----------BEGIN
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBpadY\fR
|
Name: \fBpadY\fR
|
Class: \fBPad\fR
|
Class: \fBPad\fR
|
Switch: \fB\-padx\fR
|
Switch: \fB\-padx\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
\fB[OBSOLETE]\fR The default vertical padding for list entries.
|
\fB[OBSOLETE]\fR The default vertical padding for list entries.
|
'----------END
|
'----------END
|
'----------BEGIN
|
'----------BEGIN
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBselectBackground\fR
|
Name: \fBselectBackground\fR
|
Class: \fBSelectBackground\fR
|
Class: \fBSelectBackground\fR
|
Switch: \fB\-selectbackground\fR
|
Switch: \fB\-selectbackground\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies the background color for the selected list entries.
|
Specifies the background color for the selected list entries.
|
'----------END
|
'----------END
|
'
|
'
|
'----------BEGIN
|
'----------BEGIN
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBselectBorderWidth\fR
|
Name: \fBselectBorderWidth\fR
|
Class: \fBBorderWidth\fR
|
Class: \fBBorderWidth\fR
|
Switch: \fB\-selectborderwidth\fR
|
Switch: \fB\-selectborderwidth\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies a non-negative value indicating the width of the 3-D border
|
Specifies a non-negative value indicating the width of the 3-D border
|
to draw around selected items. The value may have any of the forms
|
to draw around selected items. The value may have any of the forms
|
acceptable to \fBTk_GetPixels\fR.
|
acceptable to \fBTk_GetPixels\fR.
|
'----------END
|
'----------END
|
'
|
'
|
'----------BEGIN
|
'----------BEGIN
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBselectForeground\fR
|
Name: \fBselectForeground\fR
|
Class: \fBSelectForeground\fR
|
Class: \fBSelectForeground\fR
|
Switch: \fB\-selectforeground\fR
|
Switch: \fB\-selectforeground\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies the foreground color for the selected list entries.
|
Specifies the foreground color for the selected list entries.
|
'----------END
|
'----------END
|
'
|
'
|
'----------BEGIN
|
'----------BEGIN
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBselectMode\fR
|
Name: \fBselectMode\fR
|
Class: \fBSelectMode\fR
|
Class: \fBSelectMode\fR
|
Switch: \fB\-selectmode\fR
|
Switch: \fB\-selectmode\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies one of several styles for manipulating the selection. The
|
Specifies one of several styles for manipulating the selection. The
|
value of the option may be arbitrary, but the default bindings expect
|
value of the option may be arbitrary, but the default bindings expect
|
it to be either \fBsingle\fR, \fBbrowse\fR, \fBmultiple\fR, or
|
it to be either \fBsingle\fR, \fBbrowse\fR, \fBmultiple\fR, or
|
\fBextended\fR; the default value is \fBsingle\fR.
|
\fBextended\fR; the default value is \fBsingle\fR.
|
'----------END
|
'----------END
|
'
|
'
|
'----------BEGIN
|
'----------BEGIN
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBsizeCmd\fR
|
Name: \fBsizeCmd\fR
|
Class: \fBSizeCmd\fR
|
Class: \fBSizeCmd\fR
|
Switch: \fB\-sizecmd\fR
|
Switch: \fB\-sizecmd\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies a TCL script to be called whenever the HList widget
|
Specifies a TCL script to be called whenever the HList widget
|
changes its size. This command can be useful to implement "user scroll
|
changes its size. This command can be useful to implement "user scroll
|
bars when needed" features.
|
bars when needed" features.
|
'----------END
|
'----------END
|
'
|
'
|
'----------BEGIN
|
'----------BEGIN
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBseparator\fR
|
Name: \fBseparator\fR
|
Class: \fBSeparator\fR
|
Class: \fBSeparator\fR
|
Switch: \fB\-separator\fR
|
Switch: \fB\-separator\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies the character to used as the separator character when
|
Specifies the character to used as the separator character when
|
intepreting the path-names of list entries. By default the character
|
intepreting the path-names of list entries. By default the character
|
"." is used.
|
"." is used.
|
'----------END
|
'----------END
|
'
|
'
|
'----------BEGIN
|
'----------BEGIN
|
.LP
|
.LP
|
.nf
|
.nf
|
Name: \fBwidth\fR
|
Name: \fBwidth\fR
|
Class: \fBWidth\fR
|
Class: \fBWidth\fR
|
Switch: \fB\-width\fR
|
Switch: \fB\-width\fR
|
.fi
|
.fi
|
.IP
|
.IP
|
Specifies the desired width for the window in characters.
|
Specifies the desired width for the window in characters.
|
'----------END
|
'----------END
|
.BE
|
.BE
|
'
|
'
|
'
|
'
|
'----------------------------------------------------------------------
|
'----------------------------------------------------------------------
|
.SH DESCRIPTION
|
.SH DESCRIPTION
|
'
|
'
|
.PP
|
.PP
|
'
|
'
|
The \fBtixHList\fR command creates a new window (given by the
|
The \fBtixHList\fR command creates a new window (given by the
|
\fIpathName\fR argument) and makes it into a HList widget.
|
\fIpathName\fR argument) and makes it into a HList widget.
|
Additional options, described above, may be specified on the command
|
Additional options, described above, may be specified on the command
|
line or in the option database to configure aspects of the
|
line or in the option database to configure aspects of the
|
HList widget such as its cursor and relief.
|
HList widget such as its cursor and relief.
|
.PP
|
.PP
|
The HList widget can be used to display any data that have a
|
The HList widget can be used to display any data that have a
|
hierarchical structure, for example, file system directory trees. The
|
hierarchical structure, for example, file system directory trees. The
|
list entries are indented and connected by branch lines according to
|
list entries are indented and connected by branch lines according to
|
their places in the hierachy.
|
their places in the hierachy.
|
.PP
|
.PP
|
Each list entry is identified by an \fBentryPath\fR. The entryPath is a
|
Each list entry is identified by an \fBentryPath\fR. The entryPath is a
|
sequence of \fBentry names\fR separated by the separator charactor
|
sequence of \fBentry names\fR separated by the separator charactor
|
(specified by the \fB\-separator\fR option). An \fBentry name\fR can be
|
(specified by the \fB\-separator\fR option). An \fBentry name\fR can be
|
any string that does not contain the separator charactor, or it can be
|
any string that does not contain the separator charactor, or it can be
|
the a string that contains only one separator charactor.
|
the a string that contains only one separator charactor.
|
.PP
|
.PP
|
For example, when "." is used as the separator charactor,
|
For example, when "." is used as the separator charactor,
|
"one.two.three" is the entryPath for a list entry whose parent is
|
"one.two.three" is the entryPath for a list entry whose parent is
|
"one.two", whose parent is "one", which is a toplevel entry (has no
|
"one.two", whose parent is "one", which is a toplevel entry (has no
|
parents).
|
parents).
|
.PP
|
.PP
|
Another examples: ".two.three" is the entryPath for a list entry whose
|
Another examples: ".two.three" is the entryPath for a list entry whose
|
parent is ".two", whose parent is ".", which is a toplevel entry.
|
parent is ".two", whose parent is ".", which is a toplevel entry.
|
'
|
'
|
.SH "DISPLAY ITEMS"
|
.SH "DISPLAY ITEMS"
|
.PP
|
.PP
|
Each list entry in an HList widget is associated with a \fBdisplay
|
Each list entry in an HList widget is associated with a \fBdisplay
|
item\fR. The display item determines what visual information should
|
item\fR. The display item determines what visual information should
|
be displayed for this list entry. Please see the \fBDItem(n)\fR manual
|
be displayed for this list entry. Please see the \fBDItem(n)\fR manual
|
page for a list of all display items.
|
page for a list of all display items.
|
|
|
When a list entry is created by the \fBadd\fR or \fBaddchild\fR widget
|
When a list entry is created by the \fBadd\fR or \fBaddchild\fR widget
|
commands, the type of its display item is determined by the
|
commands, the type of its display item is determined by the
|
\fB\-itemtype\fR option passed to these commands. If the
|
\fB\-itemtype\fR option passed to these commands. If the
|
\fB\-itemtype\fR is omitted, then by default the type specified by
|
\fB\-itemtype\fR is omitted, then by default the type specified by
|
this HList widget's \fB\-itemtype\fR option is used.
|
this HList widget's \fB\-itemtype\fR option is used.
|
'----------------------------------------------------------------------
|
'----------------------------------------------------------------------
|
.SH "WIDGET COMMAND"
|
.SH "WIDGET COMMAND"
|
.PP
|
.PP
|
'
|
'
|
The \fBtixHList\fR command creates a new Tcl command whose name is the
|
The \fBtixHList\fR command creates a new Tcl command whose name is the
|
same as the path name of the HList widget's window. This command
|
same as the path name of the HList widget's window. This command
|
may be used to invoke various operations on the widget. It has the
|
may be used to invoke various operations on the widget. It has the
|
following general form:
|
following general form:
|
'
|
'
|
.DS C
|
.DS C
|
'
|
'
|
\fIpathName option \fR?\fIarg arg ...\fR?
|
\fIpathName option \fR?\fIarg arg ...\fR?
|
.PP
|
.PP
|
.DE
|
.DE
|
'
|
'
|
\fIPathName\fR is the name of the command, which is the same as
|
\fIPathName\fR is the name of the command, which is the same as
|
the HList widget's path name. \fIOption\fR and the \fIarg\fRs
|
the HList widget's path name. \fIOption\fR and the \fIarg\fRs
|
determine the exact behavior of the command. The following
|
determine the exact behavior of the command. The following
|
commands are possible for HList widgets:
|
commands are possible for HList widgets:
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBadd\fI entryPath \fR?\fIoption value ...\fR?
|
\fIpathName \fBadd\fI entryPath \fR?\fIoption value ...\fR?
|
'
|
'
|
Creates a new list entry with the pathname \fIentryPath\fR. A list
|
Creates a new list entry with the pathname \fIentryPath\fR. A list
|
entry must be created after its parent is created (unless this entry
|
entry must be created after its parent is created (unless this entry
|
is a top-level entry, which has no parent). This command returns the
|
is a top-level entry, which has no parent). This command returns the
|
entryPath of the newly created list entry. The following
|
entryPath of the newly created list entry. The following
|
configuration options can be given to configure the list entry:
|
configuration options can be given to configure the list entry:
|
'
|
'
|
.RS
|
.RS
|
'
|
'
|
.TP
|
.TP
|
\fB\-at\fI position\fR
|
\fB\-at\fI position\fR
|
'
|
'
|
Insert the new list at the position given by \fIposition\fR.
|
Insert the new list at the position given by \fIposition\fR.
|
\fIposition\fR must be a valid integer. the Position \fB0\fR indicates
|
\fIposition\fR must be a valid integer. the Position \fB0\fR indicates
|
the first position, \fB1\fR indicates the second position, and so on.
|
the first position, \fB1\fR indicates the second position, and so on.
|
'
|
'
|
.TP
|
.TP
|
\fB\-after\fI afterWhich\fR
|
\fB\-after\fI afterWhich\fR
|
'
|
'
|
Insert the new list entry after the entry identified by
|
Insert the new list entry after the entry identified by
|
\fIafterWhich\fR. \fIafterWhich\fR must be a valid list entry and it
|
\fIafterWhich\fR. \fIafterWhich\fR must be a valid list entry and it
|
mush have the same parent as the new list entry
|
mush have the same parent as the new list entry
|
'
|
'
|
.TP
|
.TP
|
\fB\-before\fI beforeWhich\fR
|
\fB\-before\fI beforeWhich\fR
|
'
|
'
|
Insert the new list entry before the entry identified by
|
Insert the new list entry before the entry identified by
|
\fIbeforeWhich\fR. \fIbeforeWhich\fR must be a valid list entry and it
|
\fIbeforeWhich\fR. \fIbeforeWhich\fR must be a valid list entry and it
|
mush have the same parent as the new list entry
|
mush have the same parent as the new list entry
|
'
|
'
|
.TP
|
.TP
|
\fB\-data\fI string\fR
|
\fB\-data\fI string\fR
|
'
|
'
|
Specifies a string to associate with this list entry. This string can
|
Specifies a string to associate with this list entry. This string can
|
be queried by the \fBinfo\fR widget command. The application
|
be queried by the \fBinfo\fR widget command. The application
|
programmer can use the \fB\-data\fR option to associate the list entry
|
programmer can use the \fB\-data\fR option to associate the list entry
|
with the data it represents.
|
with the data it represents.
|
'
|
'
|
.TP
|
.TP
|
\fB\-itemtype\fI type\fR
|
\fB\-itemtype\fI type\fR
|
'
|
'
|
Specifies the type of display item to be display for the new list
|
Specifies the type of display item to be display for the new list
|
entry. \fBtype\fR must be a valid display item type. Currently the
|
entry. \fBtype\fR must be a valid display item type. Currently the
|
available display item types are \fBimagetext\fR, \fBtext\fR, and
|
available display item types are \fBimagetext\fR, \fBtext\fR, and
|
\fBwindow\fR. If this option is not specified, then by default the
|
\fBwindow\fR. If this option is not specified, then by default the
|
type specified by this HList widget's \fB\-itemtype\fR option is used.
|
type specified by this HList widget's \fB\-itemtype\fR option is used.
|
'
|
'
|
.TP
|
.TP
|
\fB\-state\fR
|
\fB\-state\fR
|
'
|
'
|
Specifies whether this entry can be selected or invoked by the user.
|
Specifies whether this entry can be selected or invoked by the user.
|
Must be either \fBnormal\fR or \fBdisabled\fR.
|
Must be either \fBnormal\fR or \fBdisabled\fR.
|
'
|
'
|
.RE
|
.RE
|
'
|
'
|
The \fBadd\fR widget command accepts additional configuration options
|
The \fBadd\fR widget command accepts additional configuration options
|
to configure the display item associated with this list entry. The set
|
to configure the display item associated with this list entry. The set
|
of additional configuration options depends on the type of the display
|
of additional configuration options depends on the type of the display
|
item given by the \fB\-itemtype\fR option. Please see the
|
item given by the \fB\-itemtype\fR option. Please see the
|
\fBDItem(n)\fR manual page for a list of the configuration options for
|
\fBDItem(n)\fR manual page for a list of the configuration options for
|
each of the display item types.
|
each of the display item types.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBaddchild\fI parentPath \fR?\fIoption value ... \fR?
|
\fIpathName \fBaddchild\fI parentPath \fR?\fIoption value ... \fR?
|
'
|
'
|
Adds a new child entry to the children list of the list entry
|
Adds a new child entry to the children list of the list entry
|
identified by \fIparentPath\fR. Or, if \fIparentPath\fR is set to be
|
identified by \fIparentPath\fR. Or, if \fIparentPath\fR is set to be
|
the empty string, then creates a new toplevel entry. The name of the
|
the empty string, then creates a new toplevel entry. The name of the
|
new list entry will be a unique name automatically generated by the
|
new list entry will be a unique name automatically generated by the
|
HList widget. Usually if \fIparentPath\fR is \fBfoo\fR, then the
|
HList widget. Usually if \fIparentPath\fR is \fBfoo\fR, then the
|
entryPath of the new entry will be \fBfoo.1\fR, \fBfoo.2\fR, ... etc.
|
entryPath of the new entry will be \fBfoo.1\fR, \fBfoo.2\fR, ... etc.
|
This command returns the entryPath of the newly created list entry.
|
This command returns the entryPath of the newly created list entry.
|
\fIoption\fR can be any option for the \fBadd\fR widget command.
|
\fIoption\fR can be any option for the \fBadd\fR widget command.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBanchor set \fIentryPath\fR
|
\fIpathName \fBanchor set \fIentryPath\fR
|
'
|
'
|
Sets the anchor to the list entry identified by \fIentryPath\fR. The
|
Sets the anchor to the list entry identified by \fIentryPath\fR. The
|
anchor is the end of the selection that is fixed while the user is
|
anchor is the end of the selection that is fixed while the user is
|
dragging out a selection with the mouse.
|
dragging out a selection with the mouse.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBanchor clear\fR
|
\fIpathName \fBanchor clear\fR
|
'
|
'
|
Removes the anchor, if any, from this HList widget. This only
|
Removes the anchor, if any, from this HList widget. This only
|
removes the surrounding highlights of the anchor entry and does not
|
removes the surrounding highlights of the anchor entry and does not
|
affect its selection status.
|
affect its selection status.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBcget\fR \fIoption\fR
|
\fIpathName \fBcget\fR \fIoption\fR
|
'
|
'
|
Returns the current value of the configuration option given by
|
Returns the current value of the configuration option given by
|
\fIoption\fR. \fIOption\fR may have any of the values accepted by the
|
\fIoption\fR. \fIOption\fR may have any of the values accepted by the
|
\fBtixHList\fR command.
|
\fBtixHList\fR command.
|
'
|
'
|
.TP
|
.TP
|
'
|
'
|
\fIpathName \fBcolumn width \fIcol\fR ?\fI\-char\fR? ?\fIwidth\fR?
|
\fIpathName \fBcolumn width \fIcol\fR ?\fI\-char\fR? ?\fIwidth\fR?
|
'
|
'
|
Querys or sets the width of a the column \fIcol\fR in the HList
|
Querys or sets the width of a the column \fIcol\fR in the HList
|
widget. The value of \fIcol\fR is zero-based: 0 stands for the first
|
widget. The value of \fIcol\fR is zero-based: 0 stands for the first
|
column, 1 stands for the second, and so on. If no further parameters
|
column, 1 stands for the second, and so on. If no further parameters
|
are given, returns the current width of this column (in number of
|
are given, returns the current width of this column (in number of
|
pixels). Additional parameters can be given to set the width of this
|
pixels). Additional parameters can be given to set the width of this
|
column:
|
column:
|
.PP
|
.PP
|
.RS
|
.RS
|
.TP
|
.TP
|
\fIpathName \fBcolumn width \fIcol\fR \fB{}\fR
|
\fIpathName \fBcolumn width \fIcol\fR \fB{}\fR
|
'
|
'
|
An empty string indicates that the width of the column should be just
|
An empty string indicates that the width of the column should be just
|
wide enough to display the widest element in this column. In this
|
wide enough to display the widest element in this column. In this
|
case, the width of this column may change as a result of the elements
|
case, the width of this column may change as a result of the elements
|
in this column changing their sizes.
|
in this column changing their sizes.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBcolumn width \fIcol\fR \fIwidth\fR
|
\fIpathName \fBcolumn width \fIcol\fR \fIwidth\fR
|
'
|
'
|
\fIwidth\fR must be in a form accepted by \fBTk_GetPixels(3)\fR.
|
\fIwidth\fR must be in a form accepted by \fBTk_GetPixels(3)\fR.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBcolumn width \fIcol\fR \fB-char\fR \fInChars\fR
|
\fIpathName \fBcolumn width \fIcol\fR \fB-char\fR \fInChars\fR
|
'
|
'
|
The width is set to be the average width occupied by \fInChars\fR
|
The width is set to be the average width occupied by \fInChars\fR
|
number of characters of the font specified by the \fB\-font\fR option
|
number of characters of the font specified by the \fB\-font\fR option
|
of this HList widget.
|
of this HList widget.
|
'
|
'
|
.RE
|
.RE
|
.TP
|
.TP
|
'
|
'
|
\fIpathName \fBconfigure\fR ?\fIoption\fR? \fI?value option value ...\fR?
|
\fIpathName \fBconfigure\fR ?\fIoption\fR? \fI?value option value ...\fR?
|
'
|
'
|
Query or modify the configuration options of the widget. If no
|
Query or modify the configuration options of the widget. If no
|
\fIoption\fR is specified, returns a list describing all of the
|
\fIoption\fR is specified, returns a list describing all of the
|
available options for \fIpathName\fR (see \fBTk_ConfigureInfo\fR for
|
available options for \fIpathName\fR (see \fBTk_ConfigureInfo\fR for
|
information on the format of this list). If \fIoption\fR is specified
|
information on the format of this list). If \fIoption\fR is specified
|
with no \fIvalue\fR, then the command returns a list describing the
|
with no \fIvalue\fR, then the command returns a list describing the
|
one named option (this list will be identical to the corresponding
|
one named option (this list will be identical to the corresponding
|
sublist of the value returned if no \fIoption\fR is specified). If
|
sublist of the value returned if no \fIoption\fR is specified). If
|
one or more \fIoption\-value\fR pairs are specified, then the command
|
one or more \fIoption\-value\fR pairs are specified, then the command
|
modifies the given widget option(s) to have the given value(s); in
|
modifies the given widget option(s) to have the given value(s); in
|
this case the command returns an empty string. \fIOption\fR may have
|
this case the command returns an empty string. \fIOption\fR may have
|
any of the values accepted by the \fBtixHList\fR command.
|
any of the values accepted by the \fBtixHList\fR command.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBdelete\fR \fIoption\fR ?\fIentryPath\fR?
|
\fIpathName \fBdelete\fR \fIoption\fR ?\fIentryPath\fR?
|
Delete one or more list entries. \fIoption\fR may be one of the
|
Delete one or more list entries. \fIoption\fR may be one of the
|
following:
|
following:
|
.RS
|
.RS
|
.TP
|
.TP
|
\fBall\fR
|
\fBall\fR
|
Delete all entries in the HList. In this case the \fIentryPath\fR
|
Delete all entries in the HList. In this case the \fIentryPath\fR
|
does not need to be specified.
|
does not need to be specified.
|
'
|
'
|
.TP
|
.TP
|
\fBentry\fR
|
\fBentry\fR
|
Delete the entry specified by \fIentryPath\fR and all its offsprings,
|
Delete the entry specified by \fIentryPath\fR and all its offsprings,
|
if any.
|
if any.
|
'
|
'
|
.TP
|
.TP
|
\fBoffsprings\fR
|
\fBoffsprings\fR
|
Delete all the offsprings, if any, of the entry specified by
|
Delete all the offsprings, if any, of the entry specified by
|
\fIentryPath\fR. However, \fIentryPath\fR itself is not deleted.
|
\fIentryPath\fR. However, \fIentryPath\fR itself is not deleted.
|
'
|
'
|
.TP
|
.TP
|
\fBsiblings\fR
|
\fBsiblings\fR
|
Delete all the list entries that share the same parent with the entry
|
Delete all the list entries that share the same parent with the entry
|
specified by \fIentryPath\fR. However, \fIentryPath\fR itself is not
|
specified by \fIentryPath\fR. However, \fIentryPath\fR itself is not
|
deleted.
|
deleted.
|
.RE
|
.RE
|
'
|
'
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBdragsite set \fIentryPath\fR
|
\fIpathName \fBdragsite set \fIentryPath\fR
|
'
|
'
|
Sets the dragsite to the list entry identified by
|
Sets the dragsite to the list entry identified by
|
\fIentryPath\fR. The dragsite is used to indicate the source of a
|
\fIentryPath\fR. The dragsite is used to indicate the source of a
|
drag-and-drop action. Currently drag-and-drop functionality has not
|
drag-and-drop action. Currently drag-and-drop functionality has not
|
been implemented in Tix yet.
|
been implemented in Tix yet.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBdragsite clear\fR
|
\fIpathName \fBdragsite clear\fR
|
Remove the dragsite, if any, from the this HList widget. This only
|
Remove the dragsite, if any, from the this HList widget. This only
|
removes the surrounding highlights of the dragsite entry and does not
|
removes the surrounding highlights of the dragsite entry and does not
|
affect its selection status.
|
affect its selection status.
|
'
|
'
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBdropsite set \fIentryPath\fR
|
\fIpathName \fBdropsite set \fIentryPath\fR
|
'
|
'
|
Sets the dropsite to the list entry identified by \fIentryPath\fR. The
|
Sets the dropsite to the list entry identified by \fIentryPath\fR. The
|
dropsite is used to indicate the target of a grag-and-drop
|
dropsite is used to indicate the target of a grag-and-drop
|
action. Currently drag-and-drop functionality has not been implemented
|
action. Currently drag-and-drop functionality has not been implemented
|
in Tix yet.
|
in Tix yet.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBdropsite clear\fR
|
\fIpathName \fBdropsite clear\fR
|
'
|
'
|
Remove the dropsite, if any, from the this HList widget. This only
|
Remove the dropsite, if any, from the this HList widget. This only
|
removes the surrounding highlights of the dropsite entry and does not
|
removes the surrounding highlights of the dropsite entry and does not
|
affect its selection status.
|
affect its selection status.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBentrycget\fR \fI entryPath option\fR
|
\fIpathName \fBentrycget\fR \fI entryPath option\fR
|
'
|
'
|
Returns the current value of the configuration option given by
|
Returns the current value of the configuration option given by
|
\fIoption\fR for the entry indentfied by \fIentryPath\fR. \fIOption\fR
|
\fIoption\fR for the entry indentfied by \fIentryPath\fR. \fIOption\fR
|
may have any of the values accepted by the \fBadd\fR widget command.
|
may have any of the values accepted by the \fBadd\fR widget command.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBentryconfigure\fI entryPath \fR?\fIoption\fR? \fI?value option value ...\fR?
|
\fIpathName \fBentryconfigure\fI entryPath \fR?\fIoption\fR? \fI?value option value ...\fR?
|
'
|
'
|
Query or modify the configuration options of the list entry indentfied
|
Query or modify the configuration options of the list entry indentfied
|
by \fIentryPath\fR. If no \fIoption\fR is specified, returns a list
|
by \fIentryPath\fR. If no \fIoption\fR is specified, returns a list
|
describing all of the available options for \fIentryPath\fR (see
|
describing all of the available options for \fIentryPath\fR (see
|
\fBTk_ConfigureInfo\fR for information on the format of this list.) If
|
\fBTk_ConfigureInfo\fR for information on the format of this list.) If
|
\fIoption\fR is specified with no \fIvalue\fR, then the command
|
\fIoption\fR is specified with no \fIvalue\fR, then the command
|
returns a list describing the one named option (this list will be
|
returns a list describing the one named option (this list will be
|
identical to the corresponding sublist of the value returned if no
|
identical to the corresponding sublist of the value returned if no
|
\fIoption\fR is specified). If one or more \fIoption\-value\fR pairs
|
\fIoption\fR is specified). If one or more \fIoption\-value\fR pairs
|
are specified, then the command modifies the given option(s) to have
|
are specified, then the command modifies the given option(s) to have
|
the given value(s); in this case the command returns an empty string.
|
the given value(s); in this case the command returns an empty string.
|
\fIOption\fR may have any of the values accepted by the \fBadd\fR or
|
\fIOption\fR may have any of the values accepted by the \fBadd\fR or
|
\fBaddchild\fR widget command. The exact set of options depends on the
|
\fBaddchild\fR widget command. The exact set of options depends on the
|
value of the \fB\-itemtype\fR option passed to the the \fBadd\fR or
|
value of the \fB\-itemtype\fR option passed to the the \fBadd\fR or
|
\fBaddchild\fR widget command when this list entry is created.
|
\fBaddchild\fR widget command when this list entry is created.
|
'
|
'
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBheader \fIoption\fR \fIcol\fR ?\fIargs ...\fR?
|
\fIpathName \fBheader \fIoption\fR \fIcol\fR ?\fIargs ...\fR?
|
'
|
'
|
Manipulates the header items of this HList widget. If the
|
Manipulates the header items of this HList widget. If the
|
\fB\-header\fR option of this HList widget is set to true, then a
|
\fB\-header\fR option of this HList widget is set to true, then a
|
header item is displayed at the top of each column. The \fIcol\fR
|
header item is displayed at the top of each column. The \fIcol\fR
|
argument for this command must be a valid integer. 0 indicates the
|
argument for this command must be a valid integer. 0 indicates the
|
first column, 1 the second column, ... and so on. This command
|
first column, 1 the second column, ... and so on. This command
|
supports the following options:
|
supports the following options:
|
'
|
'
|
.RS
|
.RS
|
.TP
|
.TP
|
\fIpathName \fBheader \fBcget\fR \fIcol\fR \fIoption\fR
|
\fIpathName \fBheader \fBcget\fR \fIcol\fR \fIoption\fR
|
'
|
'
|
If the \fIcol\fR-th column has a header display item, returns the
|
If the \fIcol\fR-th column has a header display item, returns the
|
value of the specified \fIoption\fR of the header item. If the header
|
value of the specified \fIoption\fR of the header item. If the header
|
doesn't exist, returns an error.
|
doesn't exist, returns an error.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBheader \fBconfigure\fR \fIcol\fR ?\fIoption\fR? \fI?value option value ...\fR?
|
\fIpathName \fBheader \fBconfigure\fR \fIcol\fR ?\fIoption\fR? \fI?value option value ...\fR?
|
'
|
'
|
Query or modify the configuration options of the header display item
|
Query or modify the configuration options of the header display item
|
of the \fIcol\fR-th column. The header item must exist, or an error
|
of the \fIcol\fR-th column. The header item must exist, or an error
|
will result. If no \fIoption\fR is specified, returns a list
|
will result. If no \fIoption\fR is specified, returns a list
|
describing all of the available options for the header display item
|
describing all of the available options for the header display item
|
(see \fBTk_ConfigureInfo(3)\fR for information on the format of this
|
(see \fBTk_ConfigureInfo(3)\fR for information on the format of this
|
list.) If \fIoption\fR is specified with no \fIvalue\fR, then the
|
list.) If \fIoption\fR is specified with no \fIvalue\fR, then the
|
command returns a list describing the one named option (this list will
|
command returns a list describing the one named option (this list will
|
be identical to the corresponding sublist of the value returned if no
|
be identical to the corresponding sublist of the value returned if no
|
\fIoption\fR is specified). If one or more \fIoption\-value\fR pairs
|
\fIoption\fR is specified). If one or more \fIoption\-value\fR pairs
|
are specified, then the command modifies the given option(s) to have
|
are specified, then the command modifies the given option(s) to have
|
the given value(s); in this case the command returns an empty
|
the given value(s); in this case the command returns an empty
|
string. \fIOption\fR may have any of the values accepted by the
|
string. \fIOption\fR may have any of the values accepted by the
|
\fBheader create\fR widget command. The exact set of options depends
|
\fBheader create\fR widget command. The exact set of options depends
|
on the value of the \fB\-itemtype\fR option passed to the the \fBheader
|
on the value of the \fB\-itemtype\fR option passed to the the \fBheader
|
create\fR widget command when this display item was created.
|
create\fR widget command when this display item was created.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBheader \fBcreate\fR \fIcol\fR ?\fI\-itemtype type\fR? ?\fIoption value ...\fR?
|
\fIpathName \fBheader \fBcreate\fR \fIcol\fR ?\fI\-itemtype type\fR? ?\fIoption value ...\fR?
|
'
|
'
|
Creates a new display item as the header for the \fIcol\fR-th
|
Creates a new display item as the header for the \fIcol\fR-th
|
column. If an header display item already exists for this column, it
|
column. If an header display item already exists for this column, it
|
will be replaced by the new item. An optional parameter
|
will be replaced by the new item. An optional parameter
|
\fI\-itemtype\fR can be used to specify what type of display item
|
\fI\-itemtype\fR can be used to specify what type of display item
|
should be created. If the \fI\-itemtype\fR is not given, then by
|
should be created. If the \fI\-itemtype\fR is not given, then by
|
default the type specified by this HList widget's \fB\-itemtype\fR
|
default the type specified by this HList widget's \fB\-itemtype\fR
|
option is used. Additional parameters, in \fIoption-value\fR pairs,
|
option is used. Additional parameters, in \fIoption-value\fR pairs,
|
can be passed to configure the appearance of the display item. Each
|
can be passed to configure the appearance of the display item. Each
|
\fIoption-value\fR pair must be a valid option for this type of
|
\fIoption-value\fR pair must be a valid option for this type of
|
display item or one of the following:
|
display item or one of the following:
|
.RS
|
.RS
|
'
|
'
|
.TP
|
.TP
|
\fB\-borderwidth\fR
|
\fB\-borderwidth\fR
|
'
|
'
|
Specifies the border width of this header item.
|
Specifies the border width of this header item.
|
'
|
'
|
.TP
|
.TP
|
\fB\-headerbackground\fR
|
\fB\-headerbackground\fR
|
'
|
'
|
Specifies the background color of this header item.
|
Specifies the background color of this header item.
|
'
|
'
|
.TP
|
.TP
|
\fB\-relief\fR
|
\fB\-relief\fR
|
'
|
'
|
Specifies the relief type of the border of this header item.
|
Specifies the relief type of the border of this header item.
|
'
|
'
|
.RE
|
.RE
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBheader \fBdelete \fIcol\fR
|
\fIpathName \fBheader \fBdelete \fIcol\fR
|
'
|
'
|
Deletes the header display item for the \fIcol\fR-th column.
|
Deletes the header display item for the \fIcol\fR-th column.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBheader \fBexists \fIcol\fR
|
\fIpathName \fBheader \fBexists \fIcol\fR
|
'
|
'
|
Return true if an header display item exists for the \fIcol\fR-th
|
Return true if an header display item exists for the \fIcol\fR-th
|
column; return false otherwise.
|
column; return false otherwise.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBheader \fBsize \fIentryPath\fR
|
\fIpathName \fBheader \fBsize \fIentryPath\fR
|
'
|
'
|
If an header display item exists for the \fIcol\fR-th column , returns
|
If an header display item exists for the \fIcol\fR-th column , returns
|
its size in a two element list of the form {\fIwidth height\fR};
|
its size in a two element list of the form {\fIwidth height\fR};
|
returns an error if the header display item does not exist.
|
returns an error if the header display item does not exist.
|
'
|
'
|
.RE
|
.RE
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBhide \fIoption ?entryPath?\fR
|
\fIpathName \fBhide \fIoption ?entryPath?\fR
|
'
|
'
|
Makes some of entries invisible invisible without deleting them.
|
Makes some of entries invisible invisible without deleting them.
|
\fIOption\fR can be one of the following:
|
\fIOption\fR can be one of the following:
|
.RS
|
.RS
|
.TP
|
.TP
|
\fBentry\fR
|
\fBentry\fR
|
Hides the list entry identified by \fIentryPath\fR.
|
Hides the list entry identified by \fIentryPath\fR.
|
.PP
|
.PP
|
Currently only the \fBentry\fR option is supported. Other options will
|
Currently only the \fBentry\fR option is supported. Other options will
|
be added in the next release.
|
be added in the next release.
|
.RE
|
.RE
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBindicator \fIoption\fR entryPath ?\fIargs ...\fR?
|
\fIpathName \fBindicator \fIoption\fR entryPath ?\fIargs ...\fR?
|
'
|
'
|
Manipulates the indicator on the list entries. An indicator is usually
|
Manipulates the indicator on the list entries. An indicator is usually
|
a small display item (such as an image) that is displayed to the left
|
a small display item (such as an image) that is displayed to the left
|
to an entry to indicate the status of the entry. For example, it may
|
to an entry to indicate the status of the entry. For example, it may
|
be used to indicator whether a directory is opened or
|
be used to indicator whether a directory is opened or
|
closed. \fIoption\fR can be one of the following:
|
closed. \fIoption\fR can be one of the following:
|
'
|
'
|
.RS
|
.RS
|
.TP
|
.TP
|
\fIpathName \fBindicator \fBcget\fR \fIentryPath\fR \fIoption\fR
|
\fIpathName \fBindicator \fBcget\fR \fIentryPath\fR \fIoption\fR
|
'
|
'
|
If the list entry given by \fIentryPath\fR has an indicator, returns
|
If the list entry given by \fIentryPath\fR has an indicator, returns
|
the value of the specified \fIoption\fR of the indicator. If the
|
the value of the specified \fIoption\fR of the indicator. If the
|
indicator doesn't exist, returns an error.
|
indicator doesn't exist, returns an error.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBindicator \fBconfigure\fR \fIentryPath\fR ?\fIoption\fR? \fI?value option value ...\fR?
|
\fIpathName \fBindicator \fBconfigure\fR \fIentryPath\fR ?\fIoption\fR? \fI?value option value ...\fR?
|
'
|
'
|
Query or modify the configuration options of the indicator display
|
Query or modify the configuration options of the indicator display
|
item of the entry specified by \fIentryPath\fR. The indicator item
|
item of the entry specified by \fIentryPath\fR. The indicator item
|
must exist, or an error will result. If no \fIoption\fR is specified,
|
must exist, or an error will result. If no \fIoption\fR is specified,
|
returns a list describing all of the available options for the
|
returns a list describing all of the available options for the
|
indicator display item (see \fBTk_ConfigureInfo(3)\fR for information
|
indicator display item (see \fBTk_ConfigureInfo(3)\fR for information
|
on the format of this list). If \fIoption\fR is specified with no
|
on the format of this list). If \fIoption\fR is specified with no
|
\fIvalue\fR, then the command returns a list describing the one named
|
\fIvalue\fR, then the command returns a list describing the one named
|
option (this list will be identical to the corresponding sublist of
|
option (this list will be identical to the corresponding sublist of
|
the value returned if no \fIoption\fR is specified). If one or more
|
the value returned if no \fIoption\fR is specified). If one or more
|
\fIoption\-value\fR pairs are specified, then the command modifies the
|
\fIoption\-value\fR pairs are specified, then the command modifies the
|
given option(s) to have the given value(s); in this case the command
|
given option(s) to have the given value(s); in this case the command
|
returns an empty string. \fIOption\fR may have any of the values
|
returns an empty string. \fIOption\fR may have any of the values
|
accepted by the \fBindicator create\fR widget command. The exact set
|
accepted by the \fBindicator create\fR widget command. The exact set
|
of options depends on the value of the \fB\-itemtype\fR option passed
|
of options depends on the value of the \fB\-itemtype\fR option passed
|
to the the \fBindicator create\fR widget command when this display item
|
to the the \fBindicator create\fR widget command when this display item
|
was created.
|
was created.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBindicator \fBcreate\fR \fIentryPath\fR ?\fI\-itemtype type\fR? ?\fIoption value ...\fR?
|
\fIpathName \fBindicator \fBcreate\fR \fIentryPath\fR ?\fI\-itemtype type\fR? ?\fIoption value ...\fR?
|
'
|
'
|
Creates a new display item as the indicator for the entry specified by
|
Creates a new display item as the indicator for the entry specified by
|
\fIentryPath\fR. If an indicator display item already exists for this
|
\fIentryPath\fR. If an indicator display item already exists for this
|
entry, it will be replaced by the new item. An optional parameter
|
entry, it will be replaced by the new item. An optional parameter
|
\fI\-itemtype\fR can be used to specify what type of display item
|
\fI\-itemtype\fR can be used to specify what type of display item
|
should be created. If the \fI\-itemtype\fR is not given, then by
|
should be created. If the \fI\-itemtype\fR is not given, then by
|
default the type specified by this HList widget's \fB\-itemtype\fR
|
default the type specified by this HList widget's \fB\-itemtype\fR
|
option is used. Additional parameters, in \fIoption-value\fR pairs,
|
option is used. Additional parameters, in \fIoption-value\fR pairs,
|
can be passed to configure the appearance of the display item. Each
|
can be passed to configure the appearance of the display item. Each
|
\fIoption-value\fR pair must be a valid option for this type of
|
\fIoption-value\fR pair must be a valid option for this type of
|
display item.
|
display item.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBindicator \fBdelete \fIentryPath\fR
|
\fIpathName \fBindicator \fBdelete \fIentryPath\fR
|
'
|
'
|
Deletes the indicator display item for the entry given by \fIentryPath\fR.
|
Deletes the indicator display item for the entry given by \fIentryPath\fR.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBindicator \fBexists \fIentryPath\fR
|
\fIpathName \fBindicator \fBexists \fIentryPath\fR
|
'
|
'
|
Return true if an indicator display item exists for the entry given by
|
Return true if an indicator display item exists for the entry given by
|
\fIentryPath\fR; return false otherwise.
|
\fIentryPath\fR; return false otherwise.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBindicator \fBsize \fIentryPath\fR
|
\fIpathName \fBindicator \fBsize \fIentryPath\fR
|
'
|
'
|
If an indicator display item exists for the entry given by
|
If an indicator display item exists for the entry given by
|
\fIentryPath\fR, returns its size in a two element list of the form
|
\fIentryPath\fR, returns its size in a two element list of the form
|
{\fIwidth height\fR}; returns an error if the indicator display item
|
{\fIwidth height\fR}; returns an error if the indicator display item
|
does not exist.
|
does not exist.
|
'
|
'
|
.RE
|
.RE
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBinfo \fIoption\fR \fIarg ...\fR
|
\fIpathName \fBinfo \fIoption\fR \fIarg ...\fR
|
'
|
'
|
Query information about the HList widget. \fIoption\fR can be one
|
Query information about the HList widget. \fIoption\fR can be one
|
of the following:
|
of the following:
|
.RS
|
.RS
|
.TP
|
.TP
|
\fIpathName \fBinfo \fBanchor\fR
|
\fIpathName \fBinfo \fBanchor\fR
|
'
|
'
|
Returns the entryPath of the current anchor, if any, of the HList
|
Returns the entryPath of the current anchor, if any, of the HList
|
widget. If the anchor is not set, returns the empty string.
|
widget. If the anchor is not set, returns the empty string.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBinfo bbox\fR \fIentryPath\fR
|
\fIpathName \fBinfo bbox\fR \fIentryPath\fR
|
'
|
'
|
Returns a list of four numbers describing the visible bounding box of
|
Returns a list of four numbers describing the visible bounding box of
|
the entry given \fIentryPath\fR. The first two elements of the list
|
the entry given \fIentryPath\fR. The first two elements of the list
|
give the x and y coordinates of the upper-left corner of the screen
|
give the x and y coordinates of the upper-left corner of the screen
|
area covered by the entry (specified in pixels relative to the widget)
|
area covered by the entry (specified in pixels relative to the widget)
|
and the last two elements give the lower-right corner of the area, in
|
and the last two elements give the lower-right corner of the area, in
|
pixels. If no part of the entry given by index is visible on the
|
pixels. If no part of the entry given by index is visible on the
|
screen then the result is an empty string; if the entry is partially
|
screen then the result is an empty string; if the entry is partially
|
visible, the result gives the only the visible area of the entry.
|
visible, the result gives the only the visible area of the entry.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBinfo \fBchildren\fR ?\fIentryPath\fR?
|
\fIpathName \fBinfo \fBchildren\fR ?\fIentryPath\fR?
|
'
|
'
|
If \fIentrpyPath\fR is given, returns a list of the entryPath's of its
|
If \fIentrpyPath\fR is given, returns a list of the entryPath's of its
|
children entries. Otherwise returns a list of the toplevel
|
children entries. Otherwise returns a list of the toplevel
|
entryPath's.
|
entryPath's.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBinfo \fBdata\fR ?\fIentryPath\fR?
|
\fIpathName \fBinfo \fBdata\fR ?\fIentryPath\fR?
|
'
|
'
|
Returns the data associated with \fIentryPath\fR.
|
Returns the data associated with \fIentryPath\fR.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBinfo \fBdragsite\fR
|
\fIpathName \fBinfo \fBdragsite\fR
|
'
|
'
|
Returns the entryPath of the current dragsite, if any, of the HList
|
Returns the entryPath of the current dragsite, if any, of the HList
|
widget. If the dragsite is not set, returns the empty string.
|
widget. If the dragsite is not set, returns the empty string.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBinfo \fBdropsite\fR
|
\fIpathName \fBinfo \fBdropsite\fR
|
'
|
'
|
Returns the entryPath of the current dropsite, if any, of the HList
|
Returns the entryPath of the current dropsite, if any, of the HList
|
widget. If the dropsite is not set, returns the empty string.
|
widget. If the dropsite is not set, returns the empty string.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBinfo \fBexists\fR \fIentryPath\fR
|
\fIpathName \fBinfo \fBexists\fR \fIentryPath\fR
|
Returns a boolean value indicating whether the list entry
|
Returns a boolean value indicating whether the list entry
|
\fIentrpyPath\fR exists.
|
\fIentrpyPath\fR exists.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBinfo \fBhidden\fR \fIentryPath\fR
|
\fIpathName \fBinfo \fBhidden\fR \fIentryPath\fR
|
'
|
'
|
Returns a boolean value indicating whether the list entry
|
Returns a boolean value indicating whether the list entry
|
\fBentrpyPath\fR is hidden or not.
|
\fBentrpyPath\fR is hidden or not.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBinfo \fBnext\fR \fIentryPath\fR
|
\fIpathName \fBinfo \fBnext\fR \fIentryPath\fR
|
Returns the entryPath of the list entry, if any, immediately below
|
Returns the entryPath of the list entry, if any, immediately below
|
this list entry. If this entry is already at the bottom of the HList
|
this list entry. If this entry is already at the bottom of the HList
|
widget, returns an empty string.
|
widget, returns an empty string.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBinfo \fBparent\fR \fIentryPath\fR
|
\fIpathName \fBinfo \fBparent\fR \fIentryPath\fR
|
Returns the name of the parent of the list entry identified by
|
Returns the name of the parent of the list entry identified by
|
\fIentrpyPath\fR. If \fIentrpyPath\fR is a toplevel list entry,
|
\fIentrpyPath\fR. If \fIentrpyPath\fR is a toplevel list entry,
|
returns the empty string.
|
returns the empty string.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBinfo \fBprev\fR \fIentryPath\fR
|
\fIpathName \fBinfo \fBprev\fR \fIentryPath\fR
|
'
|
'
|
Returns the entryPath of the list entry, if any, immediately above
|
Returns the entryPath of the list entry, if any, immediately above
|
this list entry. If this entry is already at the top of the HList
|
this list entry. If this entry is already at the top of the HList
|
widget, returns an empty string.
|
widget, returns an empty string.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBinfo \fBselection\fR
|
\fIpathName \fBinfo \fBselection\fR
|
'
|
'
|
Returns a list of selected entries in the HList widget. If no entries
|
Returns a list of selected entries in the HList widget. If no entries
|
are selectd, returns an empty string.
|
are selectd, returns an empty string.
|
.RE
|
.RE
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBitem \fIoption\fR ?\fIargs ...\fR?
|
\fIpathName \fBitem \fIoption\fR ?\fIargs ...\fR?
|
'
|
'
|
Creates and configures the display items at individual columns the
|
Creates and configures the display items at individual columns the
|
entries. The form of additional of arguments depends on the choice of
|
entries. The form of additional of arguments depends on the choice of
|
\fIoption\fR:
|
\fIoption\fR:
|
'
|
'
|
.RS
|
.RS
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBitem \fBcget \fIentryPath col option\fR
|
\fIpathName \fBitem \fBcget \fIentryPath col option\fR
|
'
|
'
|
'
|
'
|
Returns the current value of the configure \fIoption\fR of the display
|
Returns the current value of the configure \fIoption\fR of the display
|
item at the column designated by \fIcol\fR of the entry specified by
|
item at the column designated by \fIcol\fR of the entry specified by
|
\fIentryPath\fR.
|
\fIentryPath\fR.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBitem configure \fIentryPath col\fR ?\fIoption\fR? \fI?value option value ...\fR?
|
\fIpathName \fBitem configure \fIentryPath col\fR ?\fIoption\fR? \fI?value option value ...\fR?
|
'
|
'
|
Query or modify the configuration options of the display item at the
|
Query or modify the configuration options of the display item at the
|
column designated by \fIcol\fR of the entry specified by
|
column designated by \fIcol\fR of the entry specified by
|
\fIentryPath\fR. If no \fIoption\fR is specified, returns a list
|
\fIentryPath\fR. If no \fIoption\fR is specified, returns a list
|
describing all of the available options for \fIentryPath\fR (see
|
describing all of the available options for \fIentryPath\fR (see
|
\fBTk_ConfigureInfo(3)\fR for information on the format of this
|
\fBTk_ConfigureInfo(3)\fR for information on the format of this
|
list). If \fIoption\fR is specified with no \fIvalue\fR, then the
|
list). If \fIoption\fR is specified with no \fIvalue\fR, then the
|
command returns a list describing the one named option (this list will
|
command returns a list describing the one named option (this list will
|
be identical to the corresponding sublist of the value returned if no
|
be identical to the corresponding sublist of the value returned if no
|
\fIoption\fR is specified). If one or more \fIoption\-value\fR pairs
|
\fIoption\fR is specified). If one or more \fIoption\-value\fR pairs
|
are specified, then the command modifies the given option(s) to have
|
are specified, then the command modifies the given option(s) to have
|
the given value(s); in this case the command returns an empty string.
|
the given value(s); in this case the command returns an empty string.
|
\fIOption\fR may have any of the values accepted by the \fBitem
|
\fIOption\fR may have any of the values accepted by the \fBitem
|
create\fR widget command. The exact set of options depends on the
|
create\fR widget command. The exact set of options depends on the
|
value of the \fB\-itemtype\fR option passed to the the \fBitem
|
value of the \fB\-itemtype\fR option passed to the the \fBitem
|
create\fR widget command when this display item was created.
|
create\fR widget command when this display item was created.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBitem create \fIentryPath col\fR ?\fI\-itemtype type\fR? ?\fIoption value ...\fR?
|
\fIpathName \fBitem create \fIentryPath col\fR ?\fI\-itemtype type\fR? ?\fIoption value ...\fR?
|
'
|
'
|
'
|
'
|
Creates a new display item at the column designated by \fIcol\fR of
|
Creates a new display item at the column designated by \fIcol\fR of
|
the entry specified by \fIentryPath\fR. An optional parameter
|
the entry specified by \fIentryPath\fR. An optional parameter
|
\fI\-itemtype\fR can be used to specify what type of display items
|
\fI\-itemtype\fR can be used to specify what type of display items
|
should be created. If the \fI\-itemtype\fR is not specified, then by
|
should be created. If the \fI\-itemtype\fR is not specified, then by
|
default the type specified by this HList widget's \fB\-itemtype\fR
|
default the type specified by this HList widget's \fB\-itemtype\fR
|
option is used. Additional parameters, in \fIoption-value\fR pairs,
|
option is used. Additional parameters, in \fIoption-value\fR pairs,
|
can be passed to configure the appearance of the display item. Each
|
can be passed to configure the appearance of the display item. Each
|
\fIoption- value\fR pair must be a valid option for this type of
|
\fIoption- value\fR pair must be a valid option for this type of
|
display item.
|
display item.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBitem delete \fIentryPath col\fR
|
\fIpathName \fBitem delete \fIentryPath col\fR
|
'
|
'
|
Deletes the display item at the column designated by \fIcol\fR of
|
Deletes the display item at the column designated by \fIcol\fR of
|
the entry specified by \fIentryPath\fR.
|
the entry specified by \fIentryPath\fR.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBitem exists \fIentryPath col\fR
|
\fIpathName \fBitem exists \fIentryPath col\fR
|
'
|
'
|
Returns true if there is a display item at the column designated by
|
Returns true if there is a display item at the column designated by
|
\fIcol\fR of the entry specified by \fIentryPath\fR; returns false
|
\fIcol\fR of the entry specified by \fIentryPath\fR; returns false
|
otherwise.
|
otherwise.
|
'
|
'
|
.RE
|
.RE
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBnearest \fIy\fR
|
\fIpathName \fBnearest \fIy\fR
|
'
|
'
|
Given a y-coordinate within the HList window, this command returns
|
Given a y-coordinate within the HList window, this command returns
|
the entryPath of the (visible) HList element nearest to that
|
the entryPath of the (visible) HList element nearest to that
|
y-coordinate.
|
y-coordinate.
|
'
|
'
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBsee \fIentryPath\fR
|
\fIpathName \fBsee \fIentryPath\fR
|
'
|
'
|
Adjust the view in the HList so that the entry given by \fIentryPath\fR is
|
Adjust the view in the HList so that the entry given by \fIentryPath\fR is
|
visible. If the entry is already visible then the command has no
|
visible. If the entry is already visible then the command has no
|
effect; if the entry is near one edge of the window then the HList
|
effect; if the entry is near one edge of the window then the HList
|
scrolls to bring the element into view at the edge; otherwise the
|
scrolls to bring the element into view at the edge; otherwise the
|
HList widget scrolls to center the entry.
|
HList widget scrolls to center the entry.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBselection \fIoption\fR \fIarg ...\fR
|
\fIpathName \fBselection \fIoption\fR \fIarg ...\fR
|
'
|
'
|
This command is used to adjust the selection within a HList widget. It
|
This command is used to adjust the selection within a HList widget. It
|
has several forms, depending on \fIoption\fR:
|
has several forms, depending on \fIoption\fR:
|
.RS
|
.RS
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBselection clear \fR?\fIfrom\fR? ?\fIto\fR?
|
\fIpathName \fBselection clear \fR?\fIfrom\fR? ?\fIto\fR?
|
'
|
'
|
When no extra arguments are given, deselects all of the list entrie(s)
|
When no extra arguments are given, deselects all of the list entrie(s)
|
in this HList widget. When only \fIfrom\fR is given, only the list
|
in this HList widget. When only \fIfrom\fR is given, only the list
|
entry identified by \fIfrom\fR is deselected. When both \fIfrom\fR and
|
entry identified by \fIfrom\fR is deselected. When both \fIfrom\fR and
|
\fIto\fR are given, deselects all of the list entrie(s) between
|
\fIto\fR are given, deselects all of the list entrie(s) between
|
between \fIfrom\fR and \fIto\fR, inclusive, without affecting the
|
between \fIfrom\fR and \fIto\fR, inclusive, without affecting the
|
selection state of entries outside that range.
|
selection state of entries outside that range.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBselection get\fR
|
\fIpathName \fBselection get\fR
|
'
|
'
|
This is an alias for the \fBinfo selection\fR widget command.
|
This is an alias for the \fBinfo selection\fR widget command.
|
,
|
,
|
.TP
|
.TP
|
\fIpathName \fBselection includes \fIentryPath\fR
|
\fIpathName \fBselection includes \fIentryPath\fR
|
'
|
'
|
Returns 1 if the list entry indicated by \fIentryPath\fR is currently
|
Returns 1 if the list entry indicated by \fIentryPath\fR is currently
|
selected; returns 0 otherwise.
|
selected; returns 0 otherwise.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBselection set \fIfrom\fR ?\fIto\fR?
|
\fIpathName \fBselection set \fIfrom\fR ?\fIto\fR?
|
'
|
'
|
Selects all of the list entrie(s) between between \fIfrom\fR and
|
Selects all of the list entrie(s) between between \fIfrom\fR and
|
\fIto\fR, inclusive, without affecting the selection state of entries
|
\fIto\fR, inclusive, without affecting the selection state of entries
|
outside that range. When only \fIfrom\fR is given, only the list entry
|
outside that range. When only \fIfrom\fR is given, only the list entry
|
identified by \fIfrom\fR is selected.
|
identified by \fIfrom\fR is selected.
|
.RE
|
.RE
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBshow \fIoption ?entryPath?\fR
|
\fIpathName \fBshow \fIoption ?entryPath?\fR
|
'
|
'
|
Show the entries that are hidden by the \fBhide\fR command,
|
Show the entries that are hidden by the \fBhide\fR command,
|
\fIoption\fR can be one of the following:
|
\fIoption\fR can be one of the following:
|
.RS
|
.RS
|
.TP
|
.TP
|
\fBentry\fR
|
\fBentry\fR
|
Shows the list entry identified by \fIentryPath\fR.
|
Shows the list entry identified by \fIentryPath\fR.
|
.PP
|
.PP
|
Currently only the \fBentry\fR option is supported. Other options will
|
Currently only the \fBentry\fR option is supported. Other options will
|
be added in future releases.
|
be added in future releases.
|
.RE
|
.RE
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBxview \fIargs\fR
|
\fIpathName \fBxview \fIargs\fR
|
This command is used to query and change the horizontal position of the
|
This command is used to query and change the horizontal position of the
|
information in the widget's window. It can take any of the following
|
information in the widget's window. It can take any of the following
|
forms:
|
forms:
|
.RS
|
.RS
|
.TP
|
.TP
|
\fIpathName \fBxview\fR
|
\fIpathName \fBxview\fR
|
'
|
'
|
Returns a list containing two elements. Each element is a real
|
Returns a list containing two elements. Each element is a real
|
fraction between 0 and 1; together they describe the horizontal span
|
fraction between 0 and 1; together they describe the horizontal span
|
that is visible in the window. For example, if the first element is
|
that is visible in the window. For example, if the first element is
|
.2 and the second element is .6, 20% of the HList entry is
|
.2 and the second element is .6, 20% of the HList entry is
|
off-screen to the left, the middle 40% is visible in the window, and
|
off-screen to the left, the middle 40% is visible in the window, and
|
40% of the entry is off-screen to the right. These are the same values
|
40% of the entry is off-screen to the right. These are the same values
|
passed to scrollbars via the \fB\-xscrollcommand\fR option.
|
passed to scrollbars via the \fB\-xscrollcommand\fR option.
|
.TP
|
.TP
|
\fIpathName \fBxview\fR \fIentryPath\fR
|
\fIpathName \fBxview\fR \fIentryPath\fR
|
'
|
'
|
Adjusts the view in the window so that the list entry identified by
|
Adjusts the view in the window so that the list entry identified by
|
\fIentryPath\fR is aligned to the left edge of the window.
|
\fIentryPath\fR is aligned to the left edge of the window.
|
.TP
|
.TP
|
\fIpathName \fBxview moveto\fI fraction\fR
|
\fIpathName \fBxview moveto\fI fraction\fR
|
'
|
'
|
Adjusts the view in the window so that \fIfraction\fR of the total
|
Adjusts the view in the window so that \fIfraction\fR of the total
|
width of the HList is off-screen to the left. \fIfraction\fR must be
|
width of the HList is off-screen to the left. \fIfraction\fR must be
|
a fraction between 0 and 1.
|
a fraction between 0 and 1.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fBxview scroll \fInumber what\fR
|
\fIpathName \fBxview scroll \fInumber what\fR
|
'
|
'
|
This command shifts the view in the window left or right according to
|
This command shifts the view in the window left or right according to
|
\fInumber\fR and \fIwhat\fR. \fINumber\fR must be an integer.
|
\fInumber\fR and \fIwhat\fR. \fINumber\fR must be an integer.
|
\fIWhat\fR must be either \fBunits\fR or \fBpages\fR or an
|
\fIWhat\fR must be either \fBunits\fR or \fBpages\fR or an
|
abbreviation of one of these. If \fIwhat\fR is \fBunits\fR, the view
|
abbreviation of one of these. If \fIwhat\fR is \fBunits\fR, the view
|
adjusts left or right by \fInumber\fR character units (the width of
|
adjusts left or right by \fInumber\fR character units (the width of
|
the \fB0\fR character) on the display; if it is \fBpages\fR then the
|
the \fB0\fR character) on the display; if it is \fBpages\fR then the
|
view adjusts by \fInumber\fR screenfuls. If \fInumber\fR is negative
|
view adjusts by \fInumber\fR screenfuls. If \fInumber\fR is negative
|
then characters farther to the left become visible; if it is positive
|
then characters farther to the left become visible; if it is positive
|
then characters farther to the right become visible.
|
then characters farther to the right become visible.
|
'
|
'
|
.RE
|
.RE
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fByview \fI?args\fR?
|
\fIpathName \fByview \fI?args\fR?
|
'
|
'
|
This command is used to query and change the vertical position of the
|
This command is used to query and change the vertical position of the
|
entries in the widget's window. It can take any of the following forms:
|
entries in the widget's window. It can take any of the following forms:
|
'
|
'
|
.RS
|
.RS
|
.TP
|
.TP
|
\fIpathName \fByview\fR
|
\fIpathName \fByview\fR
|
'
|
'
|
Returns a list containing two elements, both of which are real
|
Returns a list containing two elements, both of which are real
|
fractions between 0 and 1. The first element gives the position of
|
fractions between 0 and 1. The first element gives the position of
|
the list element at the top of the window, relative to the HList as a
|
the list element at the top of the window, relative to the HList as a
|
whole (0.5 means it is halfway through the HList, for example). The
|
whole (0.5 means it is halfway through the HList, for example). The
|
second element gives the position of the list entry just after the
|
second element gives the position of the list entry just after the
|
last one in the window, relative to the HList as a whole. These are
|
last one in the window, relative to the HList as a whole. These are
|
the same values passed to scrollbars via the \fB\-yscrollcommand\fR
|
the same values passed to scrollbars via the \fB\-yscrollcommand\fR
|
option.
|
option.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fByview\fR \fIentryPath\fR
|
\fIpathName \fByview\fR \fIentryPath\fR
|
'
|
'
|
Adjusts the view in the window so that the list entry given by
|
Adjusts the view in the window so that the list entry given by
|
\fIentryPath\fR is displayed at the top of the window.
|
\fIentryPath\fR is displayed at the top of the window.
|
'
|
'
|
.TP
|
.TP
|
\fIpathName \fByview moveto\fI fraction\fR
|
\fIpathName \fByview moveto\fI fraction\fR
|
'
|
'
|
Adjusts the view in the window so that the list entry given by
|
Adjusts the view in the window so that the list entry given by
|
\fIfraction\fR appears at the top of the window. \fIFraction\fR is a
|
\fIfraction\fR appears at the top of the window. \fIFraction\fR is a
|
fraction between 0 and 1; 0 indicates the first entry in the
|
fraction between 0 and 1; 0 indicates the first entry in the
|
HList, 0.33 indicates the entry one-third the way through the
|
HList, 0.33 indicates the entry one-third the way through the
|
HList, and so on.
|
HList, and so on.
|
.TP
|
.TP
|
\fIpathName \fByview scroll \fInumber what\fR
|
\fIpathName \fByview scroll \fInumber what\fR
|
'
|
'
|
This command adjust the view in the window up or down according to
|
This command adjust the view in the window up or down according to
|
\fInumber\fR and \fIwhat\fR. \fINumber\fR must be an integer.
|
\fInumber\fR and \fIwhat\fR. \fINumber\fR must be an integer.
|
\fIWhat\fR must be either \fBunits\fR or \fBpages\fR. If \fIwhat\fR
|
\fIWhat\fR must be either \fBunits\fR or \fBpages\fR. If \fIwhat\fR
|
is \fBunits\fR, the view adjusts up or down by \fInumber\fR lines; if
|
is \fBunits\fR, the view adjusts up or down by \fInumber\fR lines; if
|
it is \fBpages\fR then the view adjusts by \fInumber\fR screenfuls.
|
it is \fBpages\fR then the view adjusts by \fInumber\fR screenfuls.
|
If \fInumber\fR is negative then earlier entries become visible; if
|
If \fInumber\fR is negative then earlier entries become visible; if
|
it is positive then later entries become visible.
|
it is positive then later entries become visible.
|
.RE
|
.RE
|
'
|
'
|
'----------------------------------------------------------------------
|
'----------------------------------------------------------------------
|
.SH BINDINGS
|
.SH BINDINGS
|
.PP
|
.PP
|
.IP [1]
|
.IP [1]
|
If the \fB\-selectmode\fR is "browse", when the user drags the mouse
|
If the \fB\-selectmode\fR is "browse", when the user drags the mouse
|
pointer over the list entries, the entry under the pointer will be
|
pointer over the list entries, the entry under the pointer will be
|
highlighted and the \fB\-browsecmd\fR procedure will be called with
|
highlighted and the \fB\-browsecmd\fR procedure will be called with
|
one parameter, the entryPath of the highlighted entry. Only one entry
|
one parameter, the entryPath of the highlighted entry. Only one entry
|
can be highlighted at a time. The \fB\-command\fR procedure will be
|
can be highlighted at a time. The \fB\-command\fR procedure will be
|
called when the user double-clicks on a list entry.
|
called when the user double-clicks on a list entry.
|
'
|
'
|
.IP [2]
|
.IP [2]
|
If the \fB\-selectmode\fR is "single", the entries will only be
|
If the \fB\-selectmode\fR is "single", the entries will only be
|
highlighted by mouse events. When a new list entry
|
highlighted by mouse events. When a new list entry
|
is highlighted, the \fB\-browsecmd\fR procedure will be called with
|
is highlighted, the \fB\-browsecmd\fR procedure will be called with
|
one parameter indicating the highlighted list entry. The
|
one parameter indicating the highlighted list entry. The
|
\fB\-command\fR procedure will be called when the user double-clicks
|
\fB\-command\fR procedure will be called when the user double-clicks
|
on a list entry.
|
on a list entry.
|
'
|
'
|
'
|
'
|
.IP [3]
|
.IP [3]
|
If the \fB\-selectmode\fR is "multiple", when the user drags the mouse
|
If the \fB\-selectmode\fR is "multiple", when the user drags the mouse
|
pointer over the list entries, all the entries under the pointer will
|
pointer over the list entries, all the entries under the pointer will
|
be highlighted. However, only a contiguous region of list entries can
|
be highlighted. However, only a contiguous region of list entries can
|
be selected. When the highlighted area is changed, the
|
be selected. When the highlighted area is changed, the
|
\fB\-browsecmd\fR procedure will be called with an undefined
|
\fB\-browsecmd\fR procedure will be called with an undefined
|
parameter. It is the responsibility of the \fB\-browsecmd\fR procedure
|
parameter. It is the responsibility of the \fB\-browsecmd\fR procedure
|
to find out the exact highlighted selection in the HList. The
|
to find out the exact highlighted selection in the HList. The
|
\fB\-command\fR procedure will be called when the user double-clicks
|
\fB\-command\fR procedure will be called when the user double-clicks
|
on a list entry.
|
on a list entry.
|
'
|
'
|
.IP [4]
|
.IP [4]
|
'
|
'
|
If the \fB\-selectmode\fR is "extended", when the user drags the mouse
|
If the \fB\-selectmode\fR is "extended", when the user drags the mouse
|
pointer over the list entries, all the entries under the pointer will
|
pointer over the list entries, all the entries under the pointer will
|
be highlighted. The user can also make disjointed selections using
|
be highlighted. The user can also make disjointed selections using
|
. When the highlighted area is changed, the
|
. When the highlighted area is changed, the
|
\fB\-browsecmd\fR procedure will be called with an undefined
|
\fB\-browsecmd\fR procedure will be called with an undefined
|
parameter. It is the responsibility of the \fB\-browsecmd\fR procedure
|
parameter. It is the responsibility of the \fB\-browsecmd\fR procedure
|
to find out the exact highlighted selection in the HList. The
|
to find out the exact highlighted selection in the HList. The
|
\fB\-command\fR procedure will be called when the user double-clicks
|
\fB\-command\fR procedure will be called when the user double-clicks
|
on a list entry.
|
on a list entry.
|
'
|
'
|
.IP [5]
|
.IP [5]
|
\fBArrow key bindings:\fR arrow key moves the anchor point to the
|
\fBArrow key bindings:\fR arrow key moves the anchor point to the
|
item right on top of the current anchor item. arrow key moves
|
item right on top of the current anchor item. arrow key moves
|
the anchor point to the item right below the current anchor item.
|
the anchor point to the item right below the current anchor item.
|
arrow key moves the anchor to the parent item of the current
|
arrow key moves the anchor to the parent item of the current
|
anchor item. moves the anchor to the first child of the
|
anchor item. moves the anchor to the first child of the
|
current anchor item. If the current anchor item does not have any
|
current anchor item. If the current anchor item does not have any
|
children, moves the anchor to the item right below the current anchor
|
children, moves the anchor to the item right below the current anchor
|
item.
|
item.
|
'----------------------------------------------------------------------
|
'----------------------------------------------------------------------
|
.SH EXAMPLE
|
.SH EXAMPLE
|
.PP
|
.PP
|
This example demonstrates how to use an HList to store a file
|
This example demonstrates how to use an HList to store a file
|
directory structure and respond to the user's browse events:
|
directory structure and respond to the user's browse events:
|
.PP
|
.PP
|
\fC
|
\fC
|
.nf
|
.nf
|
tixHList .h -separator "/" \-browsecmd browse \-selectmode single \\
|
tixHList .h -separator "/" \-browsecmd browse \-selectmode single \\
|
-itemtype text
|
-itemtype text
|
.h add / \-text /
|
.h add / \-text /
|
.h add /home \-text /home
|
.h add /home \-text /home
|
.h add /home/ioi \-text /home/ioi
|
.h add /home/ioi \-text /home/ioi
|
.h add /home/foo \-text /home/foo
|
.h add /home/foo \-text /home/foo
|
.h add /usr \-text /usr
|
.h add /usr \-text /usr
|
.h add /usr/lib \-text /usr/lib
|
.h add /usr/lib \-text /usr/lib
|
pack .h
|
pack .h
|
|
|
proc browse {file} {
|
proc browse {file} {
|
puts "$file browsed"
|
puts "$file browsed"
|
}
|
}
|
.fi
|
.fi
|
\fR
|
\fR
|
'
|
'
|
'
|
'
|
.SH BUGS
|
.SH BUGS
|
'
|
'
|
The fact that the display item at column 0 is implicitly associated
|
The fact that the display item at column 0 is implicitly associated
|
with the whole entry is probably a design bug. This was done for
|
with the whole entry is probably a design bug. This was done for
|
backward compatibility purposes. The result is that there is a large
|
backward compatibility purposes. The result is that there is a large
|
overlap between the \fBitem\fR command and the \fBadd\fR,
|
overlap between the \fBitem\fR command and the \fBadd\fR,
|
\fBaddchild\fR, \fBentrycget\fR and \fBentryconfigure\fR
|
\fBaddchild\fR, \fBentrycget\fR and \fBentryconfigure\fR
|
commands. Whenever multiple columns exist, the programmer should use
|
commands. Whenever multiple columns exist, the programmer should use
|
ONLY the \fBitem\fR command to create and configure the display items
|
ONLY the \fBitem\fR command to create and configure the display items
|
in each column; the \fBadd\fR, \fBaddchild\fR, \fBentrycget\fR and
|
in each column; the \fBadd\fR, \fBaddchild\fR, \fBentrycget\fR and
|
\fBentryconfigure\fR should be used ONLY to create and configure
|
\fBentryconfigure\fR should be used ONLY to create and configure
|
entries.
|
entries.
|
'
|
'
|
'----------------------------------------------------------------------
|
'----------------------------------------------------------------------
|
.SH KEYWORDS
|
.SH KEYWORDS
|
Tix(n), Hierarchical Listbox
|
Tix(n), Hierarchical Listbox
|
|
|