TIP #238: FIRE EVENT WHEN WIDGET CREATED ========================================== Version: $Revision: 1.7 $ Author: Gerald W. Lester State: Draft Type: Project Tcl-Version: 8.7 Vote: Pending Created: Tuesday, 25 January 2005 URL: https://tip.tcl-lang.org238.html Post-History: ------------------------------------------------------------------------- ABSTRACT ========== This TIP arranged for a new virtual event to be fired every time a widget is created. This allows class bindings to automatically discover new widget instances and act on their creation. RATIONALE =========== It would be useful if it was possible to set an event on class bindings to allow custom code to be run when a widget of a particular class is created. Note that the standard X11 event is not quite suitable, because that is delivered to the X11 parent of the widget, which is not Tk in the case of toplevel windows. PROPOSAL ========== It is proposed that the virtual event <> be sent to every widget upon the creation of its actual underlying window (i.e. as part of *Tk_MakeWindowExist*). Note that this is the earliest at which an event can actually be delivered to the widget; before that, doing *event generate* to the widget just creates an event that gets discarded. EXAMPLE --------- % bind Toplevel <> { puts stdout {New toplevel called {%W} was created!} } % toplevel .foo New toplevel called {.foo} was created! PROPOSED C API CHANGES ------------------------ No changes would be requried, this change is for the Tcl layer API. REFERENCE IMPLEMENTATION ========================== A reference implementation does /not/ yet exist. COPYRIGHT =========== This document has been placed in the public domain. ------------------------------------------------------------------------- TIP AutoGenerator - written by Donal K. Fellows