itk(n) [osx man page]
itk(n) [incr Tk] itk(n) __________________________________________________________________________________________________________________________________________________ NAME
itk - framework for building mega-widgets in Tcl/Tk _________________________________________________________________ DESCRIPTION
Mega-widgets are high-level widgets that are constructed using Tk widgets as component parts, usually without any C code. A fileselection- box, for example, may have a few listboxes, some entry widgets and some control buttons. These individual widgets are put together in a way that makes them act like one big widget. A fileselectionbox mega-widget can be created with a command like: fileselectionbox .fsb -background blue -foreground white Once it has been created, it can be reconfigured with a command like: .fsb configure -background green -foreground black and all of its internal components will change color. Each mega-widget has a set of methods that can be used to manipulate it. For exam- ple, the current selection can be queried from a fileselectionbox like this: set fileName [.fsb get] In effect, a mega-widget looks and acts exactly like a Tk widget, but is considerably easier to implement. [incr Tk] is a framework for building mega-widgets. It uses [incr Tcl] to support the object paradigm, and adds base classes which provide default widget behaviors. All [incr Tk] widgets are derived from the Archetype base class. This class manages internal component widgets, and provides methods like "configure" and "cget" to access configuration options. The Widget base class inherits everything from Archetype, and adds a Tk frame which acts as a container for the mega-widget. It is used to build mega-widgets that sit inside of other frames and toplevels. Derived classes create other internal components and pack them into the "hull" frame created by the Widget base class. The Toplevel base class inherits everything from Archetype, but adds a Tk toplevel which acts as a container for the mega-widget. It is used to build mega-widgets, such as dialog boxes, that have their own toplevel window. Derived classes create other internal components and pack them into the "hull" toplevel created by the Toplevel base class. [incr Widgets] LIBRARY [incr Widgets] is a mega-widget library built using [incr Tk]. It can be used right out of the box, and contains more than 30 different widget classes, including: - fileselectiondialog - tabnotebook - panedwindow - combobox - optionmenu - scrolledlistbox - scrolledframe - messagedialog - and many others... The catalog demo in the "iwidgets/demos" directory shows all of the available widgets in action. Each widget class has its own man page describing the features available. KEYWORDS
class, object, object-oriented, mega-widget itk 3.0 itk(n)
Check Out this Related Man Page
Toplevel(n) [incr Tk] Toplevel(n) __________________________________________________________________________________________________________________________________________________ NAME
Toplevel - base class for mega-widgets in a top-level window INHERITANCE
itk::Archetype <- itk::Toplevel STANDARD OPTIONS
background cursor See the "options" manual entry for details on the standard options. WIDGET-SPECIFIC OPTIONS Name: title Class: Title Command-Line Switch: -title Sets the title that the window manager displays in the title bar above the window. The default title is the null string. _________________________________________________________________ DESCRIPTION
The Toplevel class inherits everything from the Archetype class, and adds a Tk toplevel called the "hull" component to represent the body of the mega-widget. The window class name for the hull is set to the most-specific class name for the mega-widget. The protected variable itk_interior contains the window path name for the "hull" component. Derived classes specialize this widget by packing other widget compo- nents into the hull. Since the hull for the Toplevel class is implemented with a Tk toplevel, mega-widgets in the Toplevel class have their own toplevel window. This class is used to create dialog boxes and other pop-up windows. COMPONENTS
Name: hull Class: Toplevel The "hull" component acts as the body for the entire mega-widget. Other components are packed into the hull to further specialize the widget. EXAMPLE
The following example implements a MessageInfo mega-widget. It creates a pop-up message that the user can dismiss by pushing the "Dismiss" button. option add *MessageInfo.title "Notice" widgetDefault itcl::class MessageInfo { inherit itk::Toplevel constructor {args} { itk_component add dismiss { button $itk_interior.dismiss -text "Dismiss" -command "destroy $itk_component(hull)" } pack $itk_component(dismiss) -side bottom -pady 4 itk_component add separator { frame $itk_interior.sep -height 2 -borderwidth 1 -relief sunken } pack $itk_component(separator) -side bottom -fill x -padx 4 itk_component add icon { label $itk_interior.icon -bitmap info } pack $itk_component(icon) -side left -padx 8 -pady 8 itk_component add infoFrame { frame $itk_interior.info } pack $itk_component(infoFrame) -side left -expand yes -fill both -padx 4 -pady 4 itk_component add message { label $itk_interior.mesg -width 20 } { usual rename -text -message message Text } pack $itk_component(message) -expand yes -fill both eval itk_initialize $args after idle [code $this centerOnScreen] } protected method centerOnScreen {} { update idletasks set wd [winfo reqwidth $itk_component(hull)] set ht [winfo reqheight $itk_component(hull)] set x [expr ([winfo screenwidth $itk_component(hull)]-$wd)/2] set y [expr ([winfo screenheight $itk_component(hull)]-$ht)/2] wm geometry $itk_component(hull) +$x+$y } } itk::usual MessageInfo { keep -background -cursor -foreground -font keep -activebackground -activeforeground -disabledforeground keep -highlightcolor -highlightthickness } # # EXAMPLE: Create a notice window: # MessageInfo .m -message "File not found: /usr/local/bin/foo" KEYWORDS
itk, Archetype, Widget, mega-widget itk 3.0 Toplevel(n)