Tcl::pTk::Tile(3)

NAME
Tcl::pTk::Tile - Tile/ttk Widget Support for Tcl::pTk

SYNOPSIS
        # Get a list of defined Tile Themes
        my @themes = $widget->ttkThemes;

        # Set a Tile Theme
        $widget->ttkSetTheme($themeName);

        # Create a Tile/ttk widget
        my $check->ttkCheckbutton(-text => 'Enabled', -variable => \$enabled);

        # Check some of the ttk style settings
        my $font = $widget->ttkStyleLookup($style, -font);

DESCRIPTION
Tcl::pTk::Tile provides some helper methods and mappings for Tile/ttk support in the Tcl::pTk package. Tile/ttk are the new themed widget set that is present in Tcl/Tk 8.5 and above, and available for Tcl/Tk 8.4 in the Tile package.

This package is auto-loaded and the tile widgets declared if Tk 8.5 is being used by Tcl::pTk, or if the Tile package for Tk 8.4 is installed.

  Style method mapping
The Tcl/Tk ttk::style command has be mapped to ttkStyle widget methods in Tcl::pTk. The following table defines this mapping:

 Tcl Usage                                  Equivalent Tcl::pTk Usage
 ------------------------------------------ --------------------------------------------------------
 ttk::style configure $style -option $value $widget->ttkStyleConfigure($style, -option, $value)
 ttk::style map $style -option ...          $widget->ttkStyleMap( $style, -option, ...)
 ttk::style lookup $style -font             $widget->ttkStyleLookup( $style, -font)
 ttk::style layout $style ...               $widget->ttkStyleLayout( $style, ...)
 ttk::style element create $elementname ..  $widget->ttkStyleElementCreate($elementname, $type, ..)
 ttk::style element names                   $widget->ttkStyleElementNames()
 ttk::style element options $element        $widget->ttkStyleElementOptions($element)
 ttk::style theme create ...                $widget->ttkThemeCreate( ... )
 ttk::style theme settings ...              $widget->ttkThemeSettings(...)
 ttk::style theme names                     $widget->ttkThemeNames
 ttk::style theme use $themename            $widget->ttkThemeUse($themename)

METHODS

  ttkSetTheme
Set a Tile Theme

Usage:

        $widget->ttkSetTheme($name);

  ttkThemes
Get a list of Tile/ttk theme names

Usage:

        my @themes $widget->ttkThemes;

  _declareTileWidgets
Internal sub to declare the tile widgets. This is called when a mainwindow is created, if we are using Tcl/Tk 8.5 or higher, or the Tile package for Tcl/Tk 8.4 is present.

Usage:

        _declareTileWidgets($interp);

        where $interp is the Tcl interp object

  _setupMapping
Internal method called at startup to provide mapping to the Tile methods. See the docs above on how mapping is done.

Usage:

        Tcl::pTk::Tile->_setupMapping($package, @mappingSpecs);