summaryrefslogtreecommitdiffstats
path: root/tkhtml1/doc/notes1.txt
blob: 120f33fee6f8dcc99d582f5ae4fb5b5796623daa (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
The HTML widget uses lots of TCL callback routines.  But a TCL
callback can do nasty things.  For example, a TCL callback
could delete the HTML widget that invoked the callback.  Or
it could delete the TCL interpreter in which the HTML widget
is running.  So we have to call HtmlLock() before invoking
a TCL callback and check to make sure the widget was not
deleted before using any fields in the widget structure after
the callback runs.

The following routines can call TCL callbacks, either directly
or indirectly:

   HtmlTokenizerAppend()
     HtmlParseCmd()
       HtmlWidgetCommand()
   HtmlGetImage()
     HtmlAddStyle()
       HtmlParseCmd()...
     HtmlSizer()
       HtmlLayout()
         HtmlRedrawCallback()
   GetLinkColor()
     HtmlAddStyle()...
   HtmlCallResolver()
     HtmlGetImage()...
     HtmlResolveCmd()
       HtmlWidgetCommand()
   HtmlRedrawCallback()...
   HtmlGetFont()
     DrawSelectionBackground()
       HtmlBlockDraw()...
     HtmlBlockDraw()
       HtmlRedrawCallback()
     FindIndexInBlock()
       DecodeBaseIndex()
         HtmlGetIndex()
           HtmlIndexCmd()
             HtmlWidgetCommand()...
           HtmlSelectionSetCmd()
             HtmlWidgetCommand()...
           HtmlInsertCmd()
             HtmlWidgetCommand()...
     Paragraph()
       DoBreakMarkup()
         HtmlLayoutBlock()
           HtmlLayout()...
           HtmlTableLayout()
             DoBreakMarkup()...
   HtmlDeleteControls()
     HtmlClear()
       HtmlWidgetCommand()...
       HtmlDestroyWidget()