mactoolbar

SYNPOSIS

       package require mactoolbar

       mactoolbar::createbutton identifier label tooltip imagepath cmd

       mactoolbar::create window

DESCRIPTION

       This  package  creates a Mac-native toolbar (based on the Cocoa NSTool-
       bar) for use in Tk windows.

       The mactoolbar::createbutton command creates a command button that will
       be displayed in the toolbar, and takes five arguments: a string identi-
       fier for the toolbutton, a label for the toolbutton, a string  for  the
       toolbutton's  tooltip, a path to an image that will be displayed in the
       button, and the Tcl command to execute.

       The mactoolbar::create command actually creates the toolbar, and  takes
       a single argument, the window that will display the toolbar.

LIMITATIONS

       The  mactoolbar  package offers a basic implementation of the NSToolbar
       library; it displays toolbar buttons, with labels and images, and  does
       not  display other Mac-native widgets such as the Cocoa searchfield. It
       does not allow customization, nor can it display Tk widgets.

       Also, it is important to set the "unifiedTitleAndToolbar" window  flag,
       immediately   after   creating   the   toolbar,  using  the  tk::unsup-
       ported::MacWindowStyle command; otherwise the internal geometry of Tk's
       widgets will be distorted. The window flag can be set like so:

       tk::unsupported::MacWindowStyle style .f document {unifiedTitleAndTool-
       bar standardDocument}

KEYWORDS

       sheet, Mac, Cocoa



                                                       mactoolbar(13 May 2013)