tabset - create and manipulate tabs as as set

SYNOPSIS

tabset pathName ?options?

INHERITANCE

itk::Widget <- tabset

STANDARD OPTIONS

background
foreground
width
font
selectForeground
selectBackground
disabledForeground
cursor
height

See the "options" manual entry for details on the standard options.

WIDGET-SPECIFIC OPTIONS

Name:                   angle
Class:                  Angle
Command-Line Switch:	-angle

Name:                   backdrop
Class:                  Backdrop
Command-Line Switch:	-backdrop

Name:                   bevelAmount
Class:                  BevelAmount
Command-Line Switch:	-bevelamount

Name:                   command
Class:                  Command
Command-Line Switch:	-command
Specifes the prefix of a Tcl command to invoke to change the view in the 
widget associated with the tabset. When a user selects a tab, a Tcl command 
is invoked. The actual command consists of this option followed by a space 
and a number. The number is the numerical index of the tab that has been 
selected.

Name: equalTabs Class: EqualTabs Command-Line Switch: -equaltabs

Name:                   gap
Class:                  Gap
Command-Line Switch:	-gap

Name:                   margin
Class:                  Margin
Command-Line Switch:	-margin

Name:                   padX
Class:                  PadX
Command-Line Switch:	-padx

Name:                   padY
Class:                  PadY
Command-Line Switch:	-pady

Name:                   raiseSelect
Class:                  RaiseSelect
Command-Line Switch:	-raiseselect

Name:                   start
Class:                  Start
Command-Line Switch:	-start

Name:                   state
Class:                  State
Command-Line Switch:	-state

Name:                   tabBorders
Class:                  TabBorders
Command-Line Switch:	-tabborders

Name:                   tabPos
Class:                  TabPos
Command-Line Switch:	-tabpos

DESCRIPTION

The tabset command creates a new window (given by the pathName argument) and makes it into a tabset widget. Additional options, described above may be specified on the command line or in the option database to configure aspects of the tabset such as its colors, font, and text. The tabset command returns its pathName argument. At the time this command is invoked, there must not exist a window named pathName, but pathName's parent must exist.

A tabset is a widget that contains a set of Tab buttons. It displays these tabs in a row or column depending on it tabpos. When a tab is clicked on, it becomes the only tab in the tab set that is selected. All other tabs are deselected. The Tcl command prefix associated with this tab (through the command tab configure option) is invoked with the tab index number appended to its argument list. This allows the tabset to control another widget such as a Notebook.

TABS

Tabs are drawn to appear attached to another widget. The tabset draws an edge boundary along one of its edges. This edge is known as the attachment edge. This edge location is dependent on the value of tabPos. For example, if tabPos is s, the attachment edge wil be on the top side of the tabset (in order to attach to the bottom or south side of its attached widget). The selected tab is draw with a 3d relief to appear above the other tabs. This selected tab "opens" toward attachment edge.

Tabs can be controlled in their location along the edges, the angle that tab sides are drawn with, gap between tabs, starting margin of tabs, internal padding around labels in a tab, the font, and its text or bitmap.

WIDGET-SPECIFIC METHODS

The tabset command creates a new Tcl command whose name is pathName. This command may be used to invoke various operations on the widget. It has the following general form:

pathName option ?arg arg ...?
option and the args determine the exact behavior of the command.

Many of the widget commands for a tabset take as one argument an indicator of which tab of the tabset to operate on. These indicators are called indexes and may be specified in any of the following forms:

number
Specifies the tab numerically, where 0 corresponds to the first tab in the tab set, 1 to the second, and so on.
select
Specifies the currently selected tab's index. If no tab is currently selected, the value -1 is returned.
end
Specifes the last tab in the tabset's index. If the tabset is empty this will return -1.
pattern
If the index doesn't satisfy any of the above forms, then this form is used. Pattern is pattern-matched against the label of each tab in the tabset, in order from the first to the last tab, until a matching entry is found. The rules of Tcl_StringMatch are used.

'............................................................................. The following commands are possible for tabset widgets:


    a
    how
    item
    list
    from
    callback.
    item
    selection
    .l
    .l

      proc
      to
      #
      pixel
      list..
      y
      whichItem
      .ts

    a
    items
    #
    1
    selectTab
    -selectmode
    .l
    .l
    .l
    pack
    <ButtonPress-1>
    }
    Create
    its
    selectItem
    labels
    (one
    .ts
    add
    add
    select
    -fill


proc
to
#
given
the
proc
}
clear
selection
see
#
that
select
given
coordinate
proc
}
[.l
select

    listbox
    (one
    and
    press
    procedure.
    single
    insert
    insert
    selection
    .l
    {

a
-command
#
to
and
-command
-label
-label
0
x
#
that
select
from
an
tabset
selectItem
{
[.l
set
$item
Define
knows
a
a
from
selectTab
{
nearest
$whichItem
#
with
and
bind
to
listbox
-exportselection
end
end
set
bind
selectTab

    tabset,
    to
    Add
    the
    two).
    selectItem
    1
    2
    pack
    -expand
Define
knows
an
a
index
-command
{
.l
curselection]
$item
}
a
how
tab
y
the
{
set
$y]
}
Create
two
two)
button
the
.l
false
one
two
0
.l
%y
#
set
call
two
tabset
tabset
.ts
.ts
.ts
.ts
no

AUTHOR

Bill W. Scott

KEYWORDS

tab tabset notebook tabnotebook