{"id":6022,"date":"2022-12-20T18:57:51","date_gmt":"2022-12-20T21:57:51","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/ttknotebook-mann\/"},"modified":"2022-12-20T18:57:51","modified_gmt":"2022-12-20T21:57:51","slug":"ttknotebook-mann","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/ttknotebook-mann\/","title":{"rendered":"ttk::notebook (mann)"},"content":{"rendered":"

ttk::notebook<\/h1>\n

NAME<\/a>
SYNOPSIS<\/a>
DESCRIPTION<\/a>
STANDARD OPTIONS<\/a>
WIDGET-SPECIFIC OPTIONS<\/a>
TAB OPTIONS<\/a>
TAB IDENTIFIERS<\/a>
WIDGET COMMAND<\/a>
KEYBOARD TRAVERSAL<\/a>
VIRTUAL EVENTS<\/a>
EXAMPLE<\/a>
STYLING OPTIONS<\/a>
SEE ALSO<\/a>
KEYWORDS<\/a> <\/p>\n

\n

______________________________________________________________________________<\/p>\n

NAME <\/a> <\/h2>\n

ttk::notebook \u2212 Multi-paned container widget<\/p>\n

SYNOPSIS <\/a> <\/h2>\n

ttk::notebook<\/b> pathname<\/i> ?options…<\/i>?
pathname<\/i> add<\/b> window<\/i> ?options…<\/i>?
pathname<\/i> insert<\/b> index window<\/i> ?options…<\/i>? ______________________________________________________________________________<\/p>\n

DESCRIPTION <\/a> <\/h2>\n

A ttk::notebook<\/b> widget manages a collection of windows and displays a single one at a time. Each slave window is associated with a tab<\/i>, which the user may select to change the currently-displayed window.<\/p>\n

STANDARD OPTIONS <\/a> <\/h2>\n\n\n
<\/td>\n\n

\u2212class<\/b><\/p>\n<\/td>\n

\n

\u2212cursor<\/b><\/p>\n<\/td>\n

\n

\u2212takefocus<\/b><\/p>\n<\/td>\n<\/tr>\n<\/table>\n

\u2212style<\/b><\/p>\n

See the ttk_widget<\/b> manual entry for details on the standard options.<\/p>\n

WIDGET-SPECIFIC OPTIONS <\/a> <\/h2>\n

Command-Line Name:\u2212height<\/b><\/p>\n\n\n\n
<\/td>\n\n

Database Name:<\/p>\n<\/td>\n

\n

height<\/b><\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

Database Class:<\/p>\n<\/td>\n

\n

Height<\/b><\/p>\n<\/td>\n<\/tr>\n<\/table>\n

If present and greater than zero, specifies the desired height of the pane area (not including internal padding or tabs). Otherwise, the maximum height of all panes is used.<\/p>\n

Command-Line Name:\u2212padding<\/b><\/p>\n\n\n\n
<\/td>\n\n

Database Name:<\/p>\n<\/td>\n

\n

padding<\/b><\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

Database Class:<\/p>\n<\/td>\n

\n

Padding<\/b><\/p>\n<\/td>\n<\/tr>\n<\/table>\n

Specifies the amount of extra space to add around the outside of the notebook. The padding is a list of up to four length specifications left top right bottom<\/i>. If fewer than four elements are specified, bottom<\/i> defaults to top<\/i>, right<\/i> defaults to left<\/i>, and top<\/i> defaults to left<\/i>. In other words, a list of three numbers specify the left, vertical, and right padding; a list of two numbers specify the horizontal and the vertical padding; a single number specifies the same padding all the way around the widget.<\/p>\n

Command-Line Name:\u2212width<\/b><\/p>\n\n\n\n
<\/td>\n\n

Database Name:<\/p>\n<\/td>\n

\n

width<\/b><\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

Database Class:<\/p>\n<\/td>\n

\n

Width<\/b><\/p>\n<\/td>\n<\/tr>\n<\/table>\n

If present and greater than zero, specifies the desired width of the pane area (not including internal padding). Otherwise, the maximum width of all panes is used.<\/p>\n

TAB OPTIONS <\/a> <\/h2>\n

The following options may be specified for individual notebook panes:<\/p>\n

Command-Line Name:\u2212state<\/b><\/p>\n\n\n\n
<\/td>\n\n

Database Name:<\/p>\n<\/td>\n

\n

state<\/b><\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

Database Class:<\/p>\n<\/td>\n

\n

State<\/b><\/p>\n<\/td>\n<\/tr>\n<\/table>\n

Either normal<\/b>, disabled<\/b> or hidden<\/b>. If disabled<\/b>, then the tab is not selectable. If hidden<\/b>, then the tab is not shown.<\/p>\n

Command-Line Name:\u2212sticky<\/b><\/p>\n\n\n\n
<\/td>\n\n

Database Name:<\/p>\n<\/td>\n

\n

sticky<\/b><\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

Database Class:<\/p>\n<\/td>\n

\n

Sticky<\/b><\/p>\n<\/td>\n<\/tr>\n<\/table>\n

Specifies how the slave window is positioned within the pane area. Value is a string containing zero or more of the characters n, s, e,<\/b> or w<\/b>. Each letter refers to a side (north, south, east, or west) that the slave window will \u201cstick\u201d to, as per the grid<\/b> geometry manager.<\/p>\n

Command-Line Name:\u2212padding<\/b><\/p>\n\n\n\n
<\/td>\n\n

Database Name:<\/p>\n<\/td>\n

\n

padding<\/b><\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

Database Class:<\/p>\n<\/td>\n

\n

Padding<\/b><\/p>\n<\/td>\n<\/tr>\n<\/table>\n

Specifies the amount of extra space to add between the notebook and this pane. Syntax is the same as for the widget \u2212padding<\/b> option.<\/p>\n

Command-Line Name:\u2212text<\/b><\/p>\n\n\n\n
<\/td>\n\n

Database Name:<\/p>\n<\/td>\n

\n

text<\/b><\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

Database Class:<\/p>\n<\/td>\n

\n

Text<\/b><\/p>\n<\/td>\n<\/tr>\n<\/table>\n

Specifies a string to be displayed in the tab.<\/p>\n

Command-Line Name:\u2212image<\/b><\/p>\n\n\n\n
<\/td>\n\n

Database Name:<\/p>\n<\/td>\n

\n

image<\/b><\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

Database Class:<\/p>\n<\/td>\n

\n

Image<\/b><\/p>\n<\/td>\n<\/tr>\n<\/table>\n

Specifies an image to display in the tab. See ttk_widget(n)<\/i> for details.<\/p>\n

Command-Line Name:\u2212compound<\/b><\/p>\n\n\n\n
<\/td>\n\n

Database Name:<\/p>\n<\/td>\n

\n

compound<\/b><\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

Database Class:<\/p>\n<\/td>\n

\n

Compound<\/b><\/p>\n<\/td>\n<\/tr>\n<\/table>\n

Specifies how to display the image relative to the text, in the case both \u2212text<\/b> and \u2212image<\/b> are present. See label(n)<\/i> for legal values.<\/p>\n

Command-Line Name:\u2212underline<\/b><\/p>\n\n\n\n
<\/td>\n\n

Database Name:<\/p>\n<\/td>\n

\n

underline<\/b><\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

Database Class:<\/p>\n<\/td>\n

\n

Underline<\/b><\/p>\n<\/td>\n<\/tr>\n<\/table>\n

Specifies the integer index (0-based) of a character to underline in the text string. The underlined character is used for mnemonic activation if ttk::notebook::enableTraversal<\/b> is called.<\/p>\n

TAB IDENTIFIERS <\/a> <\/h2>\n

The tabid<\/i> argument to the following commands may take any of the following forms:<\/p>\n\n\n\n\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

An integer between zero and the number of tabs;<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

The name of a slave window;<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

A positional specification of the form \u201c@x<\/i>,y<\/i>\u201d, which identifies the tab<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

The literal string \u201ccurrent<\/b>\u201d, which identifies the currently-selected tab; or:<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

The literal string \u201cend<\/b>\u201d, which returns the number of tabs (only valid for \u201cpathname<\/i> index<\/b>\u201d).<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

WIDGET COMMAND <\/a> <\/h2>\n

pathname<\/i> add<\/b> window<\/i> ?options…<\/i>?<\/p>\n

Adds a new tab to the notebook. See TAB OPTIONS<\/b> for the list of available options<\/i>. If window<\/i> is currently managed by the notebook but hidden, it is restored to its previous position.<\/p>\n

pathname<\/i> configure<\/b> ?options<\/i>?<\/p>\n

See ttk::widget(n)<\/i>.<\/p>\n

pathname<\/i> cget<\/b> option<\/i><\/p>\n

See ttk::widget(n)<\/i>.<\/p>\n

pathname<\/i> forget<\/b> tabid<\/i><\/p>\n

Removes the tab specified by tabid<\/i>, unmaps and unmanages the associated window.<\/p>\n

pathname<\/i> hide<\/b> tabid<\/i><\/p>\n

Hides the tab specified by tabid<\/i>. The tab will not be displayed, but the associated window remains managed by the notebook and its configuration remembered. Hidden tabs may be restored with the add<\/b> command.<\/p>\n

pathname<\/i> identify<\/b> component x y<\/i><\/p>\n

Returns the name of the element under the point given by x<\/i> and y<\/i>, or the empty string if no component is present at that location. The following subcommands are supported:
pathname<\/i> identify element<\/b> x y<\/i><\/p>\n

Returns the name of the element at the specified location.<\/p>\n

pathname<\/i> identify tab<\/b> x y<\/i><\/p>\n

Returns the index of the tab at the specified location.<\/p>\n

pathname<\/i> index<\/b> tabid<\/i><\/p>\n

Returns the numeric index of the tab specified by tabid<\/i>, or the total number of tabs if tabid<\/i> is the string \u201cend<\/b>\u201d.<\/p>\n

pathname<\/i> insert<\/b> pos subwindow options…<\/i><\/p>\n

Inserts a pane at the specified position. pos<\/i> is either the string end<\/b>, an integer index, or the name of a managed subwindow. If subwindow<\/i> is already managed by the notebook, moves it to the specified position. See TAB OPTIONS<\/b> for the list of available options.<\/p>\n

pathname<\/i> instate<\/b> statespec<\/i> ?script…<\/i>?<\/p>\n

See ttk::widget(n)<\/i>.<\/p>\n

pathname<\/i> select<\/b> ?tabid<\/i>?<\/p>\n

Selects the specified tab. The associated slave window will be displayed, and the previously-selected window (if different) is unmapped. If tabid<\/i> is omitted, returns the widget name of the currently selected pane.<\/p>\n

pathname<\/i> state<\/b> ?statespec<\/i>?<\/p>\n

See ttk::widget(n)<\/i>.<\/p>\n

pathname<\/i> tab<\/b> tabid<\/i> ?\u2212option<\/i> ?value …<\/i><\/p>\n

Query or modify the options of the specific tab. If no \u2212option<\/i> is specified, returns a dictionary of the tab option values. If one \u2212option<\/i> is specified, returns the value of that option<\/i>. Otherwise, sets the \u2212option<\/i>s to the corresponding value<\/i>s. See TAB OPTIONS<\/b> for the available options.<\/p>\n

pathname<\/i> tabs<\/b><\/p>\n

Returns the list of windows managed by the notebook, in the index order of their associated tabs.<\/p>\n

KEYBOARD TRAVERSAL <\/a> <\/h2>\n

To enable keyboard traversal for a toplevel window containing a notebook widget $nb<\/i>, call:<\/p>\n

ttk::notebook::enableTraversal $nb<\/p>\n

This will extend the bindings for the toplevel window containing the notebook as follows:<\/p>\n\n\n\n\n
<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

Control-Tab<\/b> selects the tab following the currently selected one.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

Control-Shift-Tab<\/b> selects the tab preceding the currently selected one.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

\u2022<\/p>\n<\/td>\n

<\/td>\n\n

Alt-<\/b>K<\/i>, where K<\/i> is the mnemonic (underlined) character of any tab, will select that tab.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

Multiple notebooks in a single toplevel may be enabled for traversal, including nested notebooks. However, notebook traversal only works properly if all panes are direct children of the notebook.<\/p>\n

VIRTUAL EVENTS <\/a> <\/h2>\n

The notebook widget generates a <><\/b> virtual event after a new tab is selected.<\/p>\n

EXAMPLE <\/a> <\/h2>\n

pack [ttk::notebook<\/b> .nb]
.nb add [frame .nb.f1] \u2212text “First tab”
.nb add [frame .nb.f2] \u2212text “Second tab”
.nb select .nb.f2
ttk::notebook::enableTraversal .nb<\/p>\n

STYLING OPTIONS <\/a> <\/h2>\n

The class name for a ttk::notebook<\/b> is TNotebook<\/b>. The tab has a class name of TNotebook.Tab<\/b><\/p>\n

Dynamic states: active<\/b>, disabled<\/b>, selected<\/b>.<\/p>\n

TNotebook<\/b> styling options configurable with ttk::style<\/b> are:<\/p>\n

\u2212background<\/b> color<\/i>
\u2212bordercolor<\/b> color<\/i>
\u2212darkcolor<\/b> color<\/i>
\u2212foreground<\/b> color<\/i>
\u2212lightcolor<\/b> color<\/i>
\u2212padding<\/b> padding<\/i>
\u2212tabmargins<\/b> padding<\/i>
\u2212tabposition<\/b> side<\/i><\/p>\n

TNotebook.Tab<\/b> styling options configurable with ttk::style<\/b> are:<\/p>\n

\u2212background<\/b> color<\/i>
\u2212bordercolor<\/b> color<\/i>
\u2212compound<\/b> compound<\/i>
\u2212expand<\/b> padding<\/i><\/p>\n

Defines how much the tab grows in size. Usually used with the selected<\/b> dynamic state. \u2212tabmargins<\/b> should be set appropriately so that there is room for the tab growth.<\/p>\n

\u2212font<\/b> font<\/i>
\u2212foreground<\/b> color<\/i>
\u2212padding<\/b> padding<\/i><\/p>\n

Some options are only available for specific themes.<\/p>\n

See the ttk::style<\/b> manual page for information on how to configure ttk styles.<\/p>\n

SEE ALSO <\/a> <\/h2>\n

ttk::widget(n), grid(n)<\/p>\n

KEYWORDS <\/a> <\/h2>\n

pane, tab<\/p>\n

\n","protected":false},"excerpt":{"rendered":"

ttk::notebook \u2212 Multi-paned container widget <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3783,1],"tags":[2635,2699],"class_list":["post-6022","post","type-post","status-publish","format-standard","hentry","category-n-comandos-tcl-tk","category-sin-categoria","tag-mann","tag-ttk_notebook"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/6022","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=6022"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/6022\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=6022"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=6022"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=6022"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}