UIHelpTool.st
author ca
Wed, 20 Aug 1997 18:06:03 +0200
changeset 288 675327dd4d7d
parent 286 23712b1d3f3d
child 292 af69e3e025a9
permissions -rw-r--r--
change drop mechanism: if selected widget is not a container, drop the element at the current pointer position.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
156
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
     1
"
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
     2
 COPYRIGHT (c) 1995 by eXept Software AG
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
     3
              All Rights Reserved
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
     4
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
     5
 This software is furnished under a license and may be used
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
     6
 only in accordance with the terms of that license and with the
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
     7
 inclusion of the above copyright notice.   This software may not
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
     8
 be provided or otherwise made available to, or used by, any
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
     9
 other person.  No title to or ownership of the software is
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    10
 hereby transferred.
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    11
"
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    12
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    13
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    14
148
785417b6955d intitial checkin
ca
parents:
diff changeset
    15
ApplicationModel subclass:#UIHelpTool
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    16
	instanceVariableNames:'specClass dictionary listSelection maxCharsPerLine modifiedHolder'
148
785417b6955d intitial checkin
ca
parents:
diff changeset
    17
	classVariableNames:''
785417b6955d intitial checkin
ca
parents:
diff changeset
    18
	poolDictionaries:''
785417b6955d intitial checkin
ca
parents:
diff changeset
    19
	category:'Interface-UIPainter'
785417b6955d intitial checkin
ca
parents:
diff changeset
    20
!
785417b6955d intitial checkin
ca
parents:
diff changeset
    21
785417b6955d intitial checkin
ca
parents:
diff changeset
    22
!UIHelpTool class methodsFor:'documentation'!
785417b6955d intitial checkin
ca
parents:
diff changeset
    23
156
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    24
copyright
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    25
"
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    26
 COPYRIGHT (c) 1995 by eXept Software AG
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    27
              All Rights Reserved
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    28
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    29
 This software is furnished under a license and may be used
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    30
 only in accordance with the terms of that license and with the
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    31
 inclusion of the above copyright notice.   This software may not
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    32
 be provided or otherwise made available to, or used by, any
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    33
 other person.  No title to or ownership of the software is
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    34
 hereby transferred.
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    35
"
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    36
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    37
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    38
!
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    39
148
785417b6955d intitial checkin
ca
parents:
diff changeset
    40
documentation
785417b6955d intitial checkin
ca
parents:
diff changeset
    41
"
785417b6955d intitial checkin
ca
parents:
diff changeset
    42
    used by the UIPainter to add help text to any component which will be shown
785417b6955d intitial checkin
ca
parents:
diff changeset
    43
    during runing an application with enabled activeHelp mode.
156
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    44
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    45
    [author:]
b332d7117c40 added copyrights
Claus Gittinger <cg@exept.de>
parents: 151
diff changeset
    46
        Claus Atzkern
148
785417b6955d intitial checkin
ca
parents:
diff changeset
    47
"
785417b6955d intitial checkin
ca
parents:
diff changeset
    48
! !
785417b6955d intitial checkin
ca
parents:
diff changeset
    49
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    50
!UIHelpTool class methodsFor:'instance creation'!
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    51
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    52
openOnClass:aClass
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    53
    "
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    54
     UIHelpTool openOnClass:UIPainter
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    55
    "
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    56
    |helpTool|
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    57
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    58
    helpTool := UIHelpTool new.
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    59
    helpTool openInterface:#standAloneSpec.
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    60
    helpTool helpSpecFrom:UIPainter
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    61
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    62
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    63
! !
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    64
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    65
!UIHelpTool class methodsFor:'constants'!
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    66
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    67
label
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    68
    ^ 'Help'
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    69
! !
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    70
151
ca
parents: 148
diff changeset
    71
!UIHelpTool class methodsFor:'help specs'!
ca
parents: 148
diff changeset
    72
ca
parents: 148
diff changeset
    73
helpSpec
ca
parents: 148
diff changeset
    74
    "return a dictionary filled with helpKey -> helptext associations.
172
10e8e0510baa helpSpec no longer under UIPainter
ca
parents: 156
diff changeset
    75
     These are used by the activeHelp tool.
10e8e0510baa helpSpec no longer under UIPainter
ca
parents: 156
diff changeset
    76
    "
10e8e0510baa helpSpec no longer under UIPainter
ca
parents: 156
diff changeset
    77
  ^ super helpSpec addPairsFrom:#(
151
ca
parents: 148
diff changeset
    78
172
10e8e0510baa helpSpec no longer under UIPainter
ca
parents: 156
diff changeset
    79
#activeHelpAccessKey
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    80
'This ID is used to access an active help text for the selected component'
172
10e8e0510baa helpSpec no longer under UIPainter
ca
parents: 156
diff changeset
    81
10e8e0510baa helpSpec no longer under UIPainter
ca
parents: 156
diff changeset
    82
)
10e8e0510baa helpSpec no longer under UIPainter
ca
parents: 156
diff changeset
    83
151
ca
parents: 148
diff changeset
    84
! !
ca
parents: 148
diff changeset
    85
148
785417b6955d intitial checkin
ca
parents:
diff changeset
    86
!UIHelpTool class methodsFor:'interface specs'!
785417b6955d intitial checkin
ca
parents:
diff changeset
    87
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    88
menuPanelStandAlone
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    89
    "this window spec was automatically generated by the ST/X MenuEditor"
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    90
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    91
    "do not manually edit this - the builder may not be able to
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    92
     handle the specification if its corrupted."
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    93
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    94
    "
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    95
     MenuEditor new openOnClass:UIHelpTool andSelector:#menuPanelStandAlone
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    96
     (Menu new fromLiteralArrayEncoding:(UIHelpTool menuPanelStandAlone)) startUp
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    97
    "
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    98
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
    99
    <resource: #menu>
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   100
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   101
    ^
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   102
     
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   103
       #(#Menu
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   104
          
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   105
           #(
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   106
             #(#MenuItem
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   107
                #'label:' 'file'
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   108
                #'submenu:' 
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   109
                 #(#Menu
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   110
                    
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   111
                     #(
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   112
                       #(#MenuItem
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   113
                          #'label:' 'reload'
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   114
                          #'value:' #doReload
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   115
                      )
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   116
                       #(#MenuItem
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   117
                          #'label:' '-'
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   118
                      )
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   119
                       #(#MenuItem
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   120
                          #'label:' 'close'
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   121
                          #'value:' #closeRequest
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   122
                      )
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   123
                    ) nil
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   124
                    nil
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   125
                )
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   126
            )
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   127
             #(#MenuItem
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   128
                #'label:' 'code'
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   129
                #'submenu:' 
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   130
                 #(#Menu
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   131
                    
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   132
                     #(
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   133
                       #(#MenuItem
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   134
                          #'label:' 'class'
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   135
                          #'value:' #doFromClass
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   136
                      )
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   137
                       #(#MenuItem
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   138
                          #'label:' '-'
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   139
                      )
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   140
                       #(#MenuItem
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   141
                          #'label:' 'install help spec.'
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   142
                          #'value:' #doInstallHelpSpec
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   143
                      )
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   144
                    ) nil
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   145
                    nil
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   146
                )
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   147
            )
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   148
          ) nil
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   149
          nil
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   150
      )
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   151
!
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   152
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   153
standAloneSpec
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   154
    "this window spec was automatically generated by the ST/X UIPainter"
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   155
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   156
    "do not manually edit this - the painter/builder may not be able to
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   157
     handle the specification if its corrupted."
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   158
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   159
    "
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   160
     UIPainter new openOnClass:UIHelpTool andSelector:#standAloneSpec
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   161
     UIHelpTool new openInterface:#standAloneSpec
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   162
    "
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   163
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   164
    <resource: #canvas>
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   165
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   166
    ^
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   167
     
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   168
       #(#FullSpec
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   169
          #'window:' 
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   170
           #(#WindowSpec
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   171
              #'name:' 'HelpTool'
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   172
              #'layout:' #(#LayoutFrame 199 0 167 0 794 0 664 0)
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   173
              #'label:' 'HelpTool'
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   174
              #'min:' #(#Point 10 10)
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   175
              #'max:' #(#Point 1160 870)
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   176
              #'bounds:' #(#Rectangle 199 167 795 665)
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   177
          )
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   178
          #'component:' 
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   179
           #(#SpecCollection
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   180
              #'collection:' 
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   181
               #(
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   182
                 #(#MenuPanelSpec
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   183
                    #'name:' 'menuPanelStandAlone'
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   184
                    #'layout:' #(#LayoutFrame 0 0.0 0 0.0 0 1.0 25 0)
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   185
                    #'menu:' #menuPanelStandAlone
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   186
                )
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   187
                 #(#VariableHorizontalPanelSpec
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   188
                    #'name:' 'variableHorizontalPanel1'
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   189
                    #'layout:' #(#LayoutFrame 0 0.0 25 0.0 0 1.0 0 1.0)
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   190
                    #'component:' 
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   191
                     #(#SpecCollection
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   192
                        #'collection:' 
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   193
                         #(
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   194
                           #(#TextEditorSpec
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   195
                              #'name:' 'textView'
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   196
                              #'hasHorizontalScrollBar:' true
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   197
                              #'hasVerticalScrollBar:' true
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   198
                              #'miniScrollerHorizontal:' true
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   199
                              #'miniScrollerVertical:' true
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   200
                          )
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   201
                           #(#SequenceViewSpec
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   202
                              #'name:' 'selectionList'
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   203
                              #'model:' #selectionListModel
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   204
                              #'hasHorizontalScrollBar:' true
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   205
                              #'hasVerticalScrollBar:' true
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   206
                              #'miniScrollerHorizontal:' true
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   207
                              #'miniScrollerVertical:' true
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   208
                          )
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   209
                        )
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   210
                    )
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   211
                )
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   212
              )
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   213
          )
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   214
      )
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   215
!
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   216
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   217
windowSpec
785417b6955d intitial checkin
ca
parents:
diff changeset
   218
    "this window spec was automatically generated by the ST/X UIPainter"
785417b6955d intitial checkin
ca
parents:
diff changeset
   219
785417b6955d intitial checkin
ca
parents:
diff changeset
   220
    "do not manually edit this - the painter/builder may not be able to
785417b6955d intitial checkin
ca
parents:
diff changeset
   221
     handle the specification if its corrupted."
785417b6955d intitial checkin
ca
parents:
diff changeset
   222
785417b6955d intitial checkin
ca
parents:
diff changeset
   223
    "
151
ca
parents: 148
diff changeset
   224
     UIPainter new openOnClass:UIHelpTool andSelector:#windowSpec
ca
parents: 148
diff changeset
   225
     UIHelpTool new openInterface:#windowSpec
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   226
    "
151
ca
parents: 148
diff changeset
   227
    "UIHelpTool open"
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   228
785417b6955d intitial checkin
ca
parents:
diff changeset
   229
    <resource: #canvas>
785417b6955d intitial checkin
ca
parents:
diff changeset
   230
785417b6955d intitial checkin
ca
parents:
diff changeset
   231
    ^
785417b6955d intitial checkin
ca
parents:
diff changeset
   232
     
785417b6955d intitial checkin
ca
parents:
diff changeset
   233
       #(#FullSpec
785417b6955d intitial checkin
ca
parents:
diff changeset
   234
          #'window:' 
785417b6955d intitial checkin
ca
parents:
diff changeset
   235
           #(#WindowSpec
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   236
              #'name:' 'HelpTool'
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   237
              #'layout:' #(#LayoutFrame 199 0 167 0 484 0 437 0)
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   238
              #'label:' 'unnamed canvas'
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   239
              #'min:' #(#Point 10 10)
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   240
              #'max:' #(#Point 1160 870)
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   241
              #'bounds:' #(#Rectangle 199 167 485 438)
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   242
          )
785417b6955d intitial checkin
ca
parents:
diff changeset
   243
          #'component:' 
785417b6955d intitial checkin
ca
parents:
diff changeset
   244
           #(#SpecCollection
785417b6955d intitial checkin
ca
parents:
diff changeset
   245
              #'collection:' 
785417b6955d intitial checkin
ca
parents:
diff changeset
   246
               #(
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   247
                 #(#LabelSpec
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   248
                    #'name:' 'keyLabel'
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   249
                    #'layout:' #(#AlignmentOrigin 3 0.0 42 0.0 0 1)
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   250
                    #'label:' 'Key:'
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   251
                    #'adjust:' #left
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   252
                    #'resizeForLabel:' true
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   253
                )
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   254
                 #(#ComboBoxSpec
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   255
                    #'name:' 'comboBox'
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   256
                    #'layout:' #(#LayoutFrame 48 0 22 0 -3 1.0 44 0)
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   257
                    #'activeHelpKey:' #activeHelpAccessKey
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   258
                    #'tabable:' true
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   259
                    #'model:' #listModel
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   260
                    #'type:' #symbolOrNil
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   261
                    #'comboList:' #listChannel
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   262
                )
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   263
                 #(#TextEditorSpec
785417b6955d intitial checkin
ca
parents:
diff changeset
   264
                    #'name:' 'textView'
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   265
                    #'layout:' #(#LayoutFrame 3 0.0 45 0.0 -3 1.0 -3 1.0)
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   266
                    #'hasHorizontalScrollBar:' true
785417b6955d intitial checkin
ca
parents:
diff changeset
   267
                    #'hasVerticalScrollBar:' true
785417b6955d intitial checkin
ca
parents:
diff changeset
   268
                    #'miniScrollerHorizontal:' true
785417b6955d intitial checkin
ca
parents:
diff changeset
   269
                    #'miniScrollerVertical:' true
785417b6955d intitial checkin
ca
parents:
diff changeset
   270
                )
785417b6955d intitial checkin
ca
parents:
diff changeset
   271
              )
785417b6955d intitial checkin
ca
parents:
diff changeset
   272
          )
785417b6955d intitial checkin
ca
parents:
diff changeset
   273
      )
785417b6955d intitial checkin
ca
parents:
diff changeset
   274
! !
785417b6955d intitial checkin
ca
parents:
diff changeset
   275
196
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   276
!UIHelpTool class methodsFor:'misc'!
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   277
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   278
applicationClassAssociatedWith:aClass
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   279
    "get application class keeping the associated help text or nil
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   280
    "
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   281
    |cls|
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   282
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   283
    aClass notNil ifTrue:[
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   284
        aClass isBehavior ifFalse:[cls := Smalltalk at:aClass asSymbol]
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   285
                           ifTrue:[cls := aClass].
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   286
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   287
        (cls notNil and:[cls includesBehavior:UISpecification]) ifTrue:[
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   288
            ^ UISpecificationTool
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   289
        ]
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   290
    ].
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   291
  ^ cls
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   292
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   293
! !
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   294
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   295
!UIHelpTool methodsFor:'accessing'!
785417b6955d intitial checkin
ca
parents:
diff changeset
   296
151
ca
parents: 148
diff changeset
   297
dictionary
ca
parents: 148
diff changeset
   298
    "return the value of the instance variable 'dictionary' (automatically generated)"
ca
parents: 148
diff changeset
   299
ca
parents: 148
diff changeset
   300
    ^ dictionary!
ca
parents: 148
diff changeset
   301
ca
parents: 148
diff changeset
   302
dictionary:aDictionary
ca
parents: 148
diff changeset
   303
    "set the value of the instance variable 'dictionary' (automatically generated)"
ca
parents: 148
diff changeset
   304
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   305
    (dictionary := aDictionary) isNil ifTrue:[
204
8dcd7f22e4d1 checkin from browser
ca
parents: 196
diff changeset
   306
        dictionary := IdentityDictionary new.
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   307
    ].
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   308
    self updateList
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   309
!
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   310
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   311
helpKey
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   312
    listSelection size ~~ 0 ifTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   313
        ^ listSelection asSymbol
151
ca
parents: 148
diff changeset
   314
    ].
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   315
    ^ nil
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   316
!
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   317
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   318
helpKey:aKey
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   319
    |key|
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   320
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   321
    aKey size ~~ 0 ifTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   322
        key := aKey asString
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   323
    ].
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   324
    self listModel value:key
151
ca
parents: 148
diff changeset
   325
!
ca
parents: 148
diff changeset
   326
196
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   327
helpSpecFrom:aClass
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   328
    "read help text from an application associated with the class
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   329
    "
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   330
    |help|
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   331
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   332
    specClass := self class applicationClassAssociatedWith:aClass.
196
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   333
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   334
    (specClass respondsTo:#helpSpec) ifTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   335
        help := specClass helpSpec
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   336
    ] ifFalse:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   337
        specClass := nil
196
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   338
    ].
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   339
    self dictionary:help
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   340
!
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   341
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   342
modifiedHolder:aValueHolder
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   343
    "set the value holder set to true in case of modifying attributes
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   344
    "
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   345
    modifiedHolder notNil ifTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   346
        modifiedHolder removeDependent:self. 
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   347
    ].
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   348
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   349
    (modifiedHolder := aValueHolder) notNil ifTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   350
        modifiedHolder addDependent:self.
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   351
    ].
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   352
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   353
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   354
!
785417b6955d intitial checkin
ca
parents:
diff changeset
   355
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   356
updateList
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   357
    "update list from dictionary
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   358
    "
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   359
    self listChannel value:(dictionary keys asSortedCollection)
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   360
! !
785417b6955d intitial checkin
ca
parents:
diff changeset
   361
785417b6955d intitial checkin
ca
parents:
diff changeset
   362
!UIHelpTool methodsFor:'actions'!
785417b6955d intitial checkin
ca
parents:
diff changeset
   363
785417b6955d intitial checkin
ca
parents:
diff changeset
   364
accept
785417b6955d intitial checkin
ca
parents:
diff changeset
   365
    "accept the text
785417b6955d intitial checkin
ca
parents:
diff changeset
   366
    "
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   367
    |view key txt list|
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   368
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   369
    (listSelection size == 0 or:[(view := self editTextView) isNil]) ifFalse:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   370
        txt  := view contents asString.
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   371
        key  := listSelection asSymbol.
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   372
        list := self listChannel value.
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   373
785417b6955d intitial checkin
ca
parents:
diff changeset
   374
        (dictionary at:key ifAbsent:nil) isNil ifTrue:[
785417b6955d intitial checkin
ca
parents:
diff changeset
   375
            list add:key.
785417b6955d intitial checkin
ca
parents:
diff changeset
   376
        ].
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   377
        dictionary at:key put:txt
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   378
    ]
196
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   379
!
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   380
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   381
installHelpSpecInto:aClass
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   382
    "install help text
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   383
    "
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   384
    |cls src|
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   385
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   386
    cls := self class applicationClassAssociatedWith:aClass.
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   387
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   388
    cls isNil ifTrue:[
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   389
        ^ self information:'no application class defined'.
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   390
    ].
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   391
    dictionary isEmpty ifTrue:[
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   392
        ^ self information:'no help text defined'
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   393
    ].
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   394
    src  := '' writeStream.
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   395
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   396
    src nextPutAll:
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   397
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   398
'helpSpec
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   399
    "return a dictionary filled with helpKey -> helptext associations.
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   400
     These are used by the activeHelp tool.
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   401
    "
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   402
  ^ super helpSpec addPairsFrom:#(
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   403
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   404
'.
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   405
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   406
    dictionary keysAndValuesDo:[:key :txt|
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   407
        |t|
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   408
        src nextPutLine:key storeString.
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   409
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   410
        t := txt asString replaceAll:(Character cr) by:(Character space).
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   411
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   412
        (t endsWith:Character space) ifTrue:[
196
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   413
            t := t copyWithoutLast:1
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   414
        ].
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   415
        src nextPutLine:t storeString; cr.
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   416
    ].
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   417
    src nextPutLine:')'.
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   418
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   419
    Compiler compile:(src contents)
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   420
            forClass:cls class 
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   421
          inCategory:'help specs'
56f63eb42a34 generate help specs
ca
parents: 172
diff changeset
   422
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   423
! !
785417b6955d intitial checkin
ca
parents:
diff changeset
   424
785417b6955d intitial checkin
ca
parents:
diff changeset
   425
!UIHelpTool methodsFor:'aspects'!
785417b6955d intitial checkin
ca
parents:
diff changeset
   426
785417b6955d intitial checkin
ca
parents:
diff changeset
   427
listChannel
785417b6955d intitial checkin
ca
parents:
diff changeset
   428
    "automatically generated by UIPainter ..."
785417b6955d intitial checkin
ca
parents:
diff changeset
   429
785417b6955d intitial checkin
ca
parents:
diff changeset
   430
    |holder|
785417b6955d intitial checkin
ca
parents:
diff changeset
   431
785417b6955d intitial checkin
ca
parents:
diff changeset
   432
    (holder := builder bindingAt:#listChannel) isNil ifTrue:[
785417b6955d intitial checkin
ca
parents:
diff changeset
   433
        builder aspectAt:#listChannel put:(holder :=  ValueHolder new).
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   434
        holder value:(OrderedCollection new).
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   435
    ].
785417b6955d intitial checkin
ca
parents:
diff changeset
   436
    ^ holder
785417b6955d intitial checkin
ca
parents:
diff changeset
   437
!
785417b6955d intitial checkin
ca
parents:
diff changeset
   438
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   439
listModel
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   440
    "automatically generated by UIPainter ..."
785417b6955d intitial checkin
ca
parents:
diff changeset
   441
785417b6955d intitial checkin
ca
parents:
diff changeset
   442
    |holder|
785417b6955d intitial checkin
ca
parents:
diff changeset
   443
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   444
    (holder := builder bindingAt:#listModel) isNil ifTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   445
        holder := AspectAdaptor new subject:self; forAspect:#listSelection.
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   446
        builder aspectAt:#listModel put:holder.
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   447
    ].
785417b6955d intitial checkin
ca
parents:
diff changeset
   448
    ^ holder
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   449
!
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   450
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   451
selectionListModel
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   452
    "automatically generated by UIPainter ..."
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   453
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   454
    |holder|
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   455
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   456
    (holder := builder bindingAt:#selectionListModel) isNil ifTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   457
        builder aspectAt:#selectionListModel put:(holder :=  SelectionInList new).
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   458
        holder listHolder:(self listChannel).
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   459
        holder selectionIndexHolder:(self listModel).
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   460
    ].
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   461
    ^ holder
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   462
! !
785417b6955d intitial checkin
ca
parents:
diff changeset
   463
785417b6955d intitial checkin
ca
parents:
diff changeset
   464
!UIHelpTool methodsFor:'initialization'!
785417b6955d intitial checkin
ca
parents:
diff changeset
   465
785417b6955d intitial checkin
ca
parents:
diff changeset
   466
initialize
785417b6955d intitial checkin
ca
parents:
diff changeset
   467
    "setup instance attributes
785417b6955d intitial checkin
ca
parents:
diff changeset
   468
    "
785417b6955d intitial checkin
ca
parents:
diff changeset
   469
    super initialize.
286
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   470
    dictionary := IdentityDictionary new.
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   471
! !
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   472
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   473
!UIHelpTool methodsFor:'private'!
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   474
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   475
editTextView
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   476
    "get the editTextView or nil.
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   477
    "
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   478
    |view|
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   479
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   480
    (view := builder componentAt:#textView) notNil ifTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   481
        view := view scrolledView.
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   482
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   483
        view acceptAction isNil ifTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   484
            view acceptAction:[:aList| self accept ].
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   485
        ].
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   486
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   487
        view left ~~ 0 ifTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   488
            (maxCharsPerLine := view extent x // view font width) < 10 ifTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   489
                maxCharsPerLine := nil
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   490
            ]
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   491
        ].
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   492
    ].
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   493
    ^ view
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   494
! !
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   495
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   496
!UIHelpTool methodsFor:'selection'!
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   497
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   498
listSelection
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   499
    "returns current selection
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   500
    "
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   501
    ^ listSelection
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   502
!
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   503
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   504
listSelection:aSelection
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   505
    "current selection changed
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   506
    "
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   507
    |txt col line view sel|
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   508
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   509
    aSelection isNumber ifTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   510
        aSelection ~~ 0 ifTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   511
            sel := self listChannel value at:aSelection
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   512
        ]
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   513
    ] ifFalse:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   514
        aSelection size ~~ 0 ifTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   515
            sel := aSelection withoutSeparators.
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   516
            sel size == 0 ifTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   517
                sel := nil
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   518
            ]
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   519
        ]
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   520
    ].
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   521
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   522
    listSelection = sel ifTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   523
        ^ self
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   524
    ].
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   525
    listSelection := sel.
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   526
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   527
    modifiedHolder notNil ifTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   528
        modifiedHolder value:true.
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   529
    ].
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   530
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   531
    (view := self editTextView) isNil ifTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   532
        ^ self
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   533
    ].
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   534
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   535
    listSelection notNil ifTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   536
        txt := dictionary at:(listSelection asSymbol) ifAbsent:nil.
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   537
    ].
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   538
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   539
    (txt isNil or:[maxCharsPerLine isNil]) ifTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   540
        col := txt.
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   541
    ] ifFalse:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   542
        col := OrderedCollection new.
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   543
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   544
        txt asString asCollectionOfWords do:[:aWord|
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   545
            line isNil ifTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   546
                line := aWord
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   547
            ] ifFalse:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   548
                (line size + aWord size) >= maxCharsPerLine ifTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   549
                    col add:line.
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   550
                    line := aWord
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   551
                ] ifFalse:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   552
                    line := line, ' ', aWord
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   553
                ]
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   554
            ].
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   555
        ].
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   556
        line notNil ifTrue:[col add:line].
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   557
    ].
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   558
    view contents:col.    
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   559
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   560
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   561
! !
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   562
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   563
!UIHelpTool methodsFor:'user interactions'!
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   564
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   565
doFromClass
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   566
    "setup new specification from a class accessed through to a dialog
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   567
    "
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   568
    |cls accepted|
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   569
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   570
    specClass notNil ifTrue:[cls := specClass name asValue]
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   571
                    ifFalse:[cls := '' asValue].
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   572
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   573
    [true] whileTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   574
        accepted :=
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   575
            (DialogBox new
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   576
                addTextLabel:'Classes name:';
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   577
                addInputFieldOn:cls; 
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   578
                addAbortButton; 
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   579
                addOkButton; 
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   580
                open
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   581
            ) accepted.
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   582
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   583
        accepted ifFalse:[^ self].
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   584
        cls := self class applicationClassAssociatedWith:cls value.
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   585
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   586
        cls notNil ifTrue:[
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   587
            ^ self helpSpecFrom:cls
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   588
        ].
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   589
        self warn:'no such class'.
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   590
    ]
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   591
!
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   592
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   593
doInstallHelpSpec
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   594
    "install help spec
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   595
    "
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   596
    self installHelpSpecInto:specClass
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   597
!
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   598
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   599
doReload
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   600
    "reload specification
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   601
    "
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   602
    |oldSel model|
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   603
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   604
    model  := self listModel.
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   605
    oldSel := model value.
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   606
    model value:nil.
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   607
    self helpSpecFrom:specClass.
23712b1d3f3d checkin from browser
ca
parents: 261
diff changeset
   608
    model value:oldSel.
148
785417b6955d intitial checkin
ca
parents:
diff changeset
   609
! !
785417b6955d intitial checkin
ca
parents:
diff changeset
   610
785417b6955d intitial checkin
ca
parents:
diff changeset
   611
!UIHelpTool class methodsFor:'documentation'!
785417b6955d intitial checkin
ca
parents:
diff changeset
   612
785417b6955d intitial checkin
ca
parents:
diff changeset
   613
version
785417b6955d intitial checkin
ca
parents:
diff changeset
   614
    ^ '$Header$'
785417b6955d intitial checkin
ca
parents:
diff changeset
   615
! !