FlyByHelp.st
author Claus Gittinger <cg@exept.de>
Fri, 19 Jul 2019 21:50:09 +0200
changeset 4311 06a46e58fe14
parent 4308 e62f74b5bb34
child 4313 d390ecfb7670
permissions -rw-r--r--
#REFACTORING by cg class: Menu comment/format in: #literalArrayEncoding changed: #fromLiteralArrayEncoding:
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1802
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
     1
"
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
     2
 COPYRIGHT (c) 2001 by eXept Software AG
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
     3
              All Rights Reserved
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
     4
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
     5
 This software is furnished under a license and may be used
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
     6
 only in accordance with the terms of that license and with the
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
     7
 inclusion of the above copyright notice.   This software may not
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
     8
 be provided or otherwise made available to, or used by, any
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
     9
 other person.  No title to or ownership of the software is
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
    10
 hereby transferred.
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
    11
"
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    12
"{ Package: 'stx:libview2' }"
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    13
3656
de582c82fa70 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 3418
diff changeset
    14
"{ NameSpace: Smalltalk }"
de582c82fa70 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 3418
diff changeset
    15
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    16
ActiveHelp subclass:#FlyByHelp
4119
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
    17
	instanceVariableNames:'currentFrame currentView currentHelpView showProcess closeProcess'
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
    18
	classVariableNames:'MaxNumberOfLines MaxNumberOfColumns'
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
    19
	poolDictionaries:''
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
    20
	category:'Interface-Help'
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    21
!
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    22
4231
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
    23
Query subclass:#HelpKeyInsteadOfHelpTextQuery
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
    24
	instanceVariableNames:''
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
    25
	classVariableNames:''
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
    26
	poolDictionaries:''
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
    27
	privateIn:FlyByHelp
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
    28
!
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
    29
1802
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
    30
!FlyByHelp class methodsFor:'documentation'!
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
    31
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
    32
copyright
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
    33
"
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
    34
 COPYRIGHT (c) 2001 by eXept Software AG
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
    35
              All Rights Reserved
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
    36
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
    37
 This software is furnished under a license and may be used
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
    38
 only in accordance with the terms of that license and with the
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
    39
 inclusion of the above copyright notice.   This software may not
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
    40
 be provided or otherwise made available to, or used by, any
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
    41
 other person.  No title to or ownership of the software is
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
    42
 hereby transferred.
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
    43
"
1893
f369ffca3d9f *** empty log message ***
ca
parents: 1892
diff changeset
    44
!
f369ffca3d9f *** empty log message ***
ca
parents: 1892
diff changeset
    45
4055
92c2d38634c1 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4048
diff changeset
    46
documentation
92c2d38634c1 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4048
diff changeset
    47
"
92c2d38634c1 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4048
diff changeset
    48
    an instance of me is used to provide tooltips 
92c2d38634c1 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4048
diff changeset
    49
    (sigh: smalltalk was ahead of its time in the early 90's:
92c2d38634c1 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4048
diff changeset
    50
     initially called 'activeHelp', then renamed to 'flyByHelp' 
92c2d38634c1 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4048
diff changeset
    51
     and now commonly known as tooltip).
92c2d38634c1 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4048
diff changeset
    52
92c2d38634c1 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4048
diff changeset
    53
    I will watch the mouse movements via an event hook, and determine
92c2d38634c1 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4048
diff changeset
    54
    where the mouse pointer is. Then ask the underlying view about its
92c2d38634c1 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4048
diff changeset
    55
    helpText and display it in a little floating popup view.
92c2d38634c1 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4048
diff changeset
    56
92c2d38634c1 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4048
diff changeset
    57
    The hool is installed via:
92c2d38634c1 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4048
diff changeset
    58
     FlyByHelp start
92c2d38634c1 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4048
diff changeset
    59
    and possibly deactivated/uninstalled via:
92c2d38634c1 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4048
diff changeset
    60
     FlyByHelp stop
92c2d38634c1 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4048
diff changeset
    61
92c2d38634c1 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4048
diff changeset
    62
    There can be only one FlyByHelp at any time - the start/stop methods
92c2d38634c1 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4048
diff changeset
    63
    assure that.
92c2d38634c1 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4048
diff changeset
    64
"
92c2d38634c1 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4048
diff changeset
    65
!
92c2d38634c1 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4048
diff changeset
    66
1893
f369ffca3d9f *** empty log message ***
ca
parents: 1892
diff changeset
    67
examples
f369ffca3d9f *** empty log message ***
ca
parents: 1892
diff changeset
    68
"
3220
1181c3afbb10 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3216
diff changeset
    69
    UserPreferences current toolTipShapeStyle:nil
1181c3afbb10 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3216
diff changeset
    70
    UserPreferences current toolTipShapeStyle:#cartoon
1181c3afbb10 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3216
diff changeset
    71
1893
f369ffca3d9f *** empty log message ***
ca
parents: 1892
diff changeset
    72
     FlyByHelp isActive
f369ffca3d9f *** empty log message ***
ca
parents: 1892
diff changeset
    73
f369ffca3d9f *** empty log message ***
ca
parents: 1892
diff changeset
    74
     FlyByHelp stop
f369ffca3d9f *** empty log message ***
ca
parents: 1892
diff changeset
    75
     FlyByHelp start
f369ffca3d9f *** empty log message ***
ca
parents: 1892
diff changeset
    76
"
1802
ef3539bf86b7 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1768
diff changeset
    77
! !
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    78
2692
5fe75b7fb83a access to current flyBy
Claus Gittinger <cg@exept.de>
parents: 2684
diff changeset
    79
!FlyByHelp class methodsFor:'accessing'!
5fe75b7fb83a access to current flyBy
Claus Gittinger <cg@exept.de>
parents: 2684
diff changeset
    80
5fe75b7fb83a access to current flyBy
Claus Gittinger <cg@exept.de>
parents: 2684
diff changeset
    81
currentlyShownView
2846
e90ba00f9df1 changed: #currentlyShownView
Claus Gittinger <cg@exept.de>
parents: 2826
diff changeset
    82
    TheOneAndOnlyHelpListener isNil ifTrue:[^ nil].
2692
5fe75b7fb83a access to current flyBy
Claus Gittinger <cg@exept.de>
parents: 2684
diff changeset
    83
    ^ TheOneAndOnlyHelpListener currentlyShownView
2846
e90ba00f9df1 changed: #currentlyShownView
Claus Gittinger <cg@exept.de>
parents: 2826
diff changeset
    84
e90ba00f9df1 changed: #currentlyShownView
Claus Gittinger <cg@exept.de>
parents: 2826
diff changeset
    85
    "Modified: / 09-06-2010 / 16:35:48 / cg"
3255
358f5696bc0d class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3251
diff changeset
    86
!
358f5696bc0d class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3251
diff changeset
    87
4231
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
    88
helpKeyInsteadOfHelpTextQuery
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
    89
    ^ HelpKeyInsteadOfHelpTextQuery
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
    90
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
    91
    "Created: / 22-02-2019 / 09:38:18 / Claus Gittinger"
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
    92
!
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
    93
3255
358f5696bc0d class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3251
diff changeset
    94
maxNumberOfColumns
358f5696bc0d class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3251
diff changeset
    95
    ^ MaxNumberOfColumns ? 200
358f5696bc0d class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3251
diff changeset
    96
!
358f5696bc0d class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3251
diff changeset
    97
358f5696bc0d class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3251
diff changeset
    98
maxNumberOfLines
358f5696bc0d class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3251
diff changeset
    99
    ^ MaxNumberOfLines ? 40
2692
5fe75b7fb83a access to current flyBy
Claus Gittinger <cg@exept.de>
parents: 2684
diff changeset
   100
! !
5fe75b7fb83a access to current flyBy
Claus Gittinger <cg@exept.de>
parents: 2684
diff changeset
   101
2684
de2d170a80ef *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 2680
diff changeset
   102
!FlyByHelp methodsFor:'defaults'!
de2d170a80ef *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 2680
diff changeset
   103
de2d170a80ef *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 2680
diff changeset
   104
flyByHelpTimeoutMillis
de2d170a80ef *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 2680
diff changeset
   105
    "abort flyby help text generation, if no text can be generated within that
de2d170a80ef *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 2680
diff changeset
   106
     time delta. This is used to abort long-lasting parsing/scanning/analysis in
de2d170a80ef *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 2680
diff changeset
   107
     large methods when the mouse is moved over some syntactic constructs, and
de2d170a80ef *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 2680
diff changeset
   108
     it takes too long to parse...
de2d170a80ef *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 2680
diff changeset
   109
     The returned time is given in ms"
de2d170a80ef *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 2680
diff changeset
   110
de2d170a80ef *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 2680
diff changeset
   111
    ^ 300
de2d170a80ef *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 2680
diff changeset
   112
! !
de2d170a80ef *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 2680
diff changeset
   113
4233
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   114
!FlyByHelp methodsFor:'developer menu'!
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   115
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   116
openDeveloperMenuFor:aView at:aPoint
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   117
    "with CTRL+SHIFT, this menu appears"
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   118
    
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   119
    |app helpText helpKey|
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   120
    
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   121
    app := aView topView application.
4308
e62f74b5bb34 #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 4307
diff changeset
   122
    app isNil ifTrue:[ Transcript showCR:'no app for view: %1' with:aView. ^ self ].
e62f74b5bb34 #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 4307
diff changeset
   123
    
4233
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   124
    app enqueueDelayedAction:[
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   125
        |editor m canDefineTranslationForLabel canDefineTranslationForHelpText|
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   126
4290
41b4ee0f8937 #FEATURE by exept
Claus Gittinger <cg@exept.de>
parents: 4281
diff changeset
   127
        canDefineTranslationForHelpText := lastHelpText notEmptyOrNil.
41b4ee0f8937 #FEATURE by exept
Claus Gittinger <cg@exept.de>
parents: 4281
diff changeset
   128
        canDefineTranslationForHelpText := canDefineTranslationForHelpText or:[ (helpText := aView helpTextAt:aPoint) notEmptyOrNil].
41b4ee0f8937 #FEATURE by exept
Claus Gittinger <cg@exept.de>
parents: 4281
diff changeset
   129
        canDefineTranslationForHelpText := canDefineTranslationForHelpText or:[ (helpText := aView helpText) notEmptyOrNil].
41b4ee0f8937 #FEATURE by exept
Claus Gittinger <cg@exept.de>
parents: 4281
diff changeset
   130
        canDefineTranslationForHelpText := canDefineTranslationForHelpText or:[ (helpKey := aView helpKey) notNil].
41b4ee0f8937 #FEATURE by exept
Claus Gittinger <cg@exept.de>
parents: 4281
diff changeset
   131
        canDefineTranslationForHelpText := canDefineTranslationForHelpText or:[ (helpText := app helpTextFor:aView) notEmptyOrNil ].
41b4ee0f8937 #FEATURE by exept
Claus Gittinger <cg@exept.de>
parents: 4281
diff changeset
   132
4233
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   133
        m := Menu new.
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   134
        m addItem:(MenuItem 
4308
e62f74b5bb34 #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 4307
diff changeset
   135
            label:(('>> ',(aView fullName ? 'unnamed'),' <<') withColor:Color grey)).
e62f74b5bb34 #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 4307
diff changeset
   136
        m addSeparator.    
e62f74b5bb34 #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 4307
diff changeset
   137
            
e62f74b5bb34 #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 4307
diff changeset
   138
        m addItem:(MenuItem 
4290
41b4ee0f8937 #FEATURE by exept
Claus Gittinger <cg@exept.de>
parents: 4281
diff changeset
   139
            label: 'Copy Helptext'
41b4ee0f8937 #FEATURE by exept
Claus Gittinger <cg@exept.de>
parents: 4281
diff changeset
   140
            itemValue:[
41b4ee0f8937 #FEATURE by exept
Claus Gittinger <cg@exept.de>
parents: 4281
diff changeset
   141
                |package key |
41b4ee0f8937 #FEATURE by exept
Claus Gittinger <cg@exept.de>
parents: 4281
diff changeset
   142
41b4ee0f8937 #FEATURE by exept
Claus Gittinger <cg@exept.de>
parents: 4281
diff changeset
   143
                key := (lastHelpText ? helpText ? helpKey) asString string.
41b4ee0f8937 #FEATURE by exept
Claus Gittinger <cg@exept.de>
parents: 4281
diff changeset
   144
                aView topView setClipboardText:key.
41b4ee0f8937 #FEATURE by exept
Claus Gittinger <cg@exept.de>
parents: 4281
diff changeset
   145
            ]
41b4ee0f8937 #FEATURE by exept
Claus Gittinger <cg@exept.de>
parents: 4281
diff changeset
   146
            enabled:canDefineTranslationForHelpText).
41b4ee0f8937 #FEATURE by exept
Claus Gittinger <cg@exept.de>
parents: 4281
diff changeset
   147
        m addSeparator.
41b4ee0f8937 #FEATURE by exept
Claus Gittinger <cg@exept.de>
parents: 4281
diff changeset
   148
41b4ee0f8937 #FEATURE by exept
Claus Gittinger <cg@exept.de>
parents: 4281
diff changeset
   149
        m addItem:(MenuItem 
4233
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   150
            label: 'Edit Resources'
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   151
            itemValue:[ 
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   152
                app enqueueDelayedAction:[
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   153
                    app withWaitCursorDo:[
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   154
                        editor := Tools::InternationalLanguageTranslationEditor
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   155
                                        openOnPackage:((aView topView application ? aView) class package).
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   156
                        editor selectOrAddKey:(lastHelpText storeString withoutCRs).
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   157
                        Transcript showCR:'help text is: %1' with:lastHelpText storeString withoutCRs.
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   158
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   159
                    ].    
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   160
                ].    
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   161
            ]).
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   162
        m addItem:(MenuItem 
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   163
            label: 'Browse Resources'
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   164
            itemValue:[ 
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   165
                app enqueueDelayedAction:[
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   166
                    app withWaitCursorDo:[
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   167
                        FileBrowser default 
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   168
                            openOn:(app class projectDefinitionClass 
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   169
                                        packageDirectory / 'resources').
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   170
                    ].    
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   171
                ].    
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   172
            ]).
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   173
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   174
        canDefineTranslationForLabel := 
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   175
            [
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   176
                (aView isKindOf:Label) or:[aView respondsTo:#label]
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   177
            ].    
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   178
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   179
        m addItem:(MenuItem 
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   180
            label: 'Define Translation for Label...'
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   181
            itemValue:[
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   182
                |package key |
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   183
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   184
                key := aView label asString string.
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   185
                package := app class package.
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   186
                ResourcePack defineResourceFor:key package:package.
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   187
            ]
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   188
            enabled:canDefineTranslationForLabel).
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   189
        m addItem:(MenuItem 
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   190
            label: 'Define Translation for Helptext...'
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   191
            itemValue:[
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   192
                |package key |
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   193
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   194
                key := (lastHelpText ? helpText ? helpKey) asString string.
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   195
                package := app class package.
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   196
                ResourcePack defineResourceFor:key package:package.
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   197
            ]
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   198
            enabled:canDefineTranslationForHelpText).
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   199
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   200
        m addSeparator. 
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   201
        m addItem:(MenuItem 
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   202
            label: 'Browse Application'
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   203
            itemValue:[ SystemBrowser default openInClass:aView application class]).
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   204
            
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   205
        m addItem:(MenuItem 
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   206
            label: 'UI Painter'
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   207
            itemValue:[ UIPainter openOnClass:aView application class andSelector:#windowSpec]).
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   208
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   209
        aView application ~~ app ifTrue:[    
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   210
            m addSeparator. 
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   211
            m addItem:(MenuItem 
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   212
                label: 'Browse Top Application'
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   213
                itemValue:[ SystemBrowser default openInClass:app class]).
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   214
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   215
            m addItem:(MenuItem 
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   216
                label: 'UI Painter on Top Application'
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   217
                itemValue:[ UIPainter openOnClass:app class andSelector:#windowSpec]).
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   218
        ].
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   219
        
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   220
        m showAtPointer.
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   221
    ].
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   222
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   223
    "Created: / 22-02-2019 / 09:32:35 / Claus Gittinger"
4308
e62f74b5bb34 #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 4307
diff changeset
   224
    "Modified: / 19-07-2019 / 11:51:52 / Claus Gittinger"
4233
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   225
! !
7bc96946d912 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4231
diff changeset
   226
2392
02244f5708b7 reafctored
Claus Gittinger <cg@exept.de>
parents: 2002
diff changeset
   227
!FlyByHelp methodsFor:'event handling'!
1540
f6948fc36460 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 1536
diff changeset
   228
2474
ef24105ee7a2 code cleanup (arg-names)
Claus Gittinger <cg@exept.de>
parents: 2392
diff changeset
   229
buttonMotion:buttonAndModifierState x:x y:y view:aView
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   230
    "/ DebuggingEvents := true
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   231
    "/ DebuggingEvents := false
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   232
    DebuggingEvents == true ifTrue:[
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   233
        ('%1: ==== ButtonMotion view:%2' 
4281
1629dc18017e #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4252
diff changeset
   234
                bindWith:self className 
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   235
                with:aView) infoPrintCR.
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   236
    ].
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   237
2519
af89806c67e4 comment
Claus Gittinger <cg@exept.de>
parents: 2518
diff changeset
   238
    aView == currentHelpView ifTrue:[
af89806c67e4 comment
Claus Gittinger <cg@exept.de>
parents: 2518
diff changeset
   239
        "/ the help-bubble itself
af89806c67e4 comment
Claus Gittinger <cg@exept.de>
parents: 2518
diff changeset
   240
        ^ false
af89806c67e4 comment
Claus Gittinger <cg@exept.de>
parents: 2518
diff changeset
   241
    ].
af89806c67e4 comment
Claus Gittinger <cg@exept.de>
parents: 2518
diff changeset
   242
4055
92c2d38634c1 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4048
diff changeset
   243
    "/ don't start tooltip, if this view is not active.
92c2d38634c1 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4048
diff changeset
   244
    "/ The following line does not work, because motion events are reported for the current focus-view,
3321
e749388a10b8 class: FlyByHelp
Stefan Vogel <sv@exept.de>
parents: 3293
diff changeset
   245
    "/ which is always active. Must check after we have determined the view under the pointer
3675
c7ba11759026 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 3656
diff changeset
   246
    "/      aView topView isActive ifFalse:[^ false].
2477
b009e0b51999 suppress tooltip for inactive (lower) windows
Claus Gittinger <cg@exept.de>
parents: 2474
diff changeset
   247
2474
ef24105ee7a2 code cleanup (arg-names)
Claus Gittinger <cg@exept.de>
parents: 2392
diff changeset
   248
    ^ super buttonMotion:buttonAndModifierState x:x y:y view:aView
4281
1629dc18017e #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4252
diff changeset
   249
1629dc18017e #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4252
diff changeset
   250
    "Modified: / 28-06-2019 / 08:43:54 / Claus Gittinger"
1540
f6948fc36460 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 1536
diff changeset
   251
!
f6948fc36460 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 1536
diff changeset
   252
2611
f578b9c43a6f handle escape key to close flyByHelp
Claus Gittinger <cg@exept.de>
parents: 2521
diff changeset
   253
buttonPress:button x:x y:y view:aView
3198
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   254
    |prevView|
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   255
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   256
    "/ DebuggingEvents := true
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   257
    "/ DebuggingEvents := false
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   258
    DebuggingEvents == true ifTrue:[
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   259
        ('%1: ButtonPress view:%2' 
4281
1629dc18017e #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4252
diff changeset
   260
                bindWith:self className 
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   261
                with:aView) infoPrintCR.
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   262
    ].
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   263
3198
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   264
    "/ hideHelp nils the currentView
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   265
    "/ we restore it, so the tooltip is not shown again for this view
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   266
    "/ until the mouse really leaves the view
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   267
    "/ let's call this the "do-not-show-in-this-view mode"
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   268
    prevView := currentView.
2978
4358a9302b95 changed: #buttonPress:x:y:view:
Claus Gittinger <cg@exept.de>
parents: 2925
diff changeset
   269
    self hideHelp.
3198
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   270
    currentView := prevView.
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   271
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   272
    ^ false
2978
4358a9302b95 changed: #buttonPress:x:y:view:
Claus Gittinger <cg@exept.de>
parents: 2925
diff changeset
   273
4358a9302b95 changed: #buttonPress:x:y:view:
Claus Gittinger <cg@exept.de>
parents: 2925
diff changeset
   274
    "Modified: / 23-12-2011 / 20:37:28 / cg"
4281
1629dc18017e #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4252
diff changeset
   275
    "Modified: / 28-06-2019 / 08:43:57 / Claus Gittinger"
2611
f578b9c43a6f handle escape key to close flyByHelp
Claus Gittinger <cg@exept.de>
parents: 2521
diff changeset
   276
!
f578b9c43a6f handle escape key to close flyByHelp
Claus Gittinger <cg@exept.de>
parents: 2521
diff changeset
   277
f578b9c43a6f handle escape key to close flyByHelp
Claus Gittinger <cg@exept.de>
parents: 2521
diff changeset
   278
keyPress:key x:x y:y view:aView
4308
e62f74b5bb34 #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 4307
diff changeset
   279
    "care for the special keys:
e62f74b5bb34 #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 4307
diff changeset
   280
        Ctrl (while help is shown)
e62f74b5bb34 #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 4307
diff changeset
   281
        L-Shift+R-Shift+Ctrl (while nothing is shown)
e62f74b5bb34 #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 4307
diff changeset
   282
    "
e62f74b5bb34 #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 4307
diff changeset
   283
    
4226
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   284
    <resource: #keyboard (#Escape #Control #Shift)>
3216
f9312a1f2e9d class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3198
diff changeset
   285
4228
699d09d62316 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4227
diff changeset
   286
    |prevView text|
3198
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   287
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   288
    "/ DebuggingEvents := true
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   289
    "/ DebuggingEvents := false
4307
1b0e3ba1d905 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4290
diff changeset
   290
    "/ Debugging := true.
1b0e3ba1d905 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4290
diff changeset
   291
    "/ Debugging := false.
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   292
    DebuggingEvents == true ifTrue:[
4307
1b0e3ba1d905 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4290
diff changeset
   293
        '-----' infoPrintCR.
1b0e3ba1d905 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4290
diff changeset
   294
        ('%1: KeyPress view:%2 (currentHelpView=%3)' 
4281
1629dc18017e #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4252
diff changeset
   295
                bindWith:self className 
4307
1b0e3ba1d905 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4290
diff changeset
   296
                with:aView
1b0e3ba1d905 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4290
diff changeset
   297
                with:currentHelpView) infoPrintCR.
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   298
    ].
2885
a70144d85a81 changed: #keyPress:x:y:view:
Claus Gittinger <cg@exept.de>
parents: 2884
diff changeset
   299
    currentHelpView notNil ifTrue:[
4290
41b4ee0f8937 #FEATURE by exept
Claus Gittinger <cg@exept.de>
parents: 4281
diff changeset
   300
        key == $§ ifTrue:[
2979
306456bdfb61 comment in: #keyPress:x:y:view:
Claus Gittinger <cg@exept.de>
parents: 2978
diff changeset
   301
            "/ generate a line suitable for the resources file (a null translation)
3216
f9312a1f2e9d class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3198
diff changeset
   302
            "/ into the clipboard; makes it easy to add missing translations to a .rs file,
4082
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   303
            "/ by pressing paragraph whenever you see an untranslated helptext
4228
699d09d62316 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4227
diff changeset
   304
            text := (lastHelpText storeString withoutCRs, '    ' , lastHelpText storeString withoutCRs).
699d09d62316 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4227
diff changeset
   305
            aView setClipboardText:text.
2612
Claus Gittinger <cg@exept.de>
parents: 2611
diff changeset
   306
            self hideHelp.
4230
240c17007808 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4228
diff changeset
   307
            ^ false
2612
Claus Gittinger <cg@exept.de>
parents: 2611
diff changeset
   308
        ].
2979
306456bdfb61 comment in: #keyPress:x:y:view:
Claus Gittinger <cg@exept.de>
parents: 2978
diff changeset
   309
        key == #Escape ifTrue:[
3198
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   310
            prevView := currentView.
2979
306456bdfb61 comment in: #keyPress:x:y:view:
Claus Gittinger <cg@exept.de>
parents: 2978
diff changeset
   311
            self hideHelp.
3198
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   312
            currentView := prevView.
4230
240c17007808 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4228
diff changeset
   313
            ^ false
2885
a70144d85a81 changed: #keyPress:x:y:view:
Claus Gittinger <cg@exept.de>
parents: 2884
diff changeset
   314
        ].
4228
699d09d62316 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4227
diff changeset
   315
        (#(#'Shift' #'Shift_L' #'Shift_R') includes:key) ifTrue:[
699d09d62316 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4227
diff changeset
   316
            aView device ctrlDown ifTrue:[
4230
240c17007808 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4228
diff changeset
   317
                self hideHelp.
4231
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   318
                self openDeveloperMenuFor:aView at:x@y
4230
240c17007808 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4228
diff changeset
   319
            ].
240c17007808 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4228
diff changeset
   320
            ^ false
4228
699d09d62316 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4227
diff changeset
   321
        ].
699d09d62316 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4227
diff changeset
   322
        
699d09d62316 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4227
diff changeset
   323
        (#(#'Control' #'Control_L' #'Control_R') includes:key) ifTrue:[
4226
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   324
            "/ reopen showing the key
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   325
            self initiateHelpFor:aView at:(x@y) now:true.
4230
240c17007808 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4228
diff changeset
   326
            ^ false
4226
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   327
        ].
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   328
        
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   329
        (#('Shift' #'Shift_L' #'Shift_R' #'Control' #'Control_L' #'Control_R') includes:key) ifTrue:[
3216
f9312a1f2e9d class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3198
diff changeset
   330
            "/ do not close on those...
f9312a1f2e9d class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3198
diff changeset
   331
            ^ false
f9312a1f2e9d class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3198
diff changeset
   332
        ].
4307
1b0e3ba1d905 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4290
diff changeset
   333
    ] ifFalse:[
1b0e3ba1d905 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4290
diff changeset
   334
        "/ both shifts AND then ctrl...
1b0e3ba1d905 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4290
diff changeset
   335
        (#(#'Control' #'Control_L' #'Control_R') includes:key) ifTrue:[
1b0e3ba1d905 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4290
diff changeset
   336
            aView device leftShiftDown ifTrue:[
1b0e3ba1d905 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4290
diff changeset
   337
                aView device rightShiftDown ifTrue:[
1b0e3ba1d905 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4290
diff changeset
   338
                    self hideHelp.
1b0e3ba1d905 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4290
diff changeset
   339
                    self openDeveloperMenuFor:aView at:x@y
1b0e3ba1d905 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4290
diff changeset
   340
                ].
1b0e3ba1d905 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4290
diff changeset
   341
            ].
1b0e3ba1d905 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4290
diff changeset
   342
            ^ false
1b0e3ba1d905 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4290
diff changeset
   343
        ].
4226
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   344
    ].    
3198
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   345
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   346
    "/ hideHelp nils the currentView
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   347
    "/ we restore it, so the tooltip is not shown again for this view
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   348
    "/ until the mouse really leaves the view
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   349
    "/ let's call this the "do-not-show-in-this-view mode"
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   350
    prevView := currentView.
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   351
    self hideHelpIgnoringErrors.
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   352
    currentView := prevView.
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   353
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   354
    ^ false
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   355
    "/ ^ super keyPress:key x:x y:y view:aView
2884
7d37f5a0719e changed: #keyPress:x:y:view:
Claus Gittinger <cg@exept.de>
parents: 2878
diff changeset
   356
2979
306456bdfb61 comment in: #keyPress:x:y:view:
Claus Gittinger <cg@exept.de>
parents: 2978
diff changeset
   357
    "Modified (format): / 25-12-2011 / 10:25:23 / cg"
4082
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   358
    "Modified (format): / 16-04-2018 / 16:53:15 / stefan"
4308
e62f74b5bb34 #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 4307
diff changeset
   359
    "Modified (comment): / 19-07-2019 / 11:43:52 / Claus Gittinger"
4226
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   360
!
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   361
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   362
keyRelease:key x:x y:y view:aView
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   363
    <resource: #keyboard (#Control)>
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   364
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   365
    "/ DebuggingEvents := true
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   366
    "/ DebuggingEvents := false
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   367
    DebuggingEvents == true ifTrue:[
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   368
        ('%1: KeyRelease view:%2' 
4281
1629dc18017e #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4252
diff changeset
   369
                bindWith:self className 
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   370
                with:aView) infoPrintCR.
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   371
    ].
4226
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   372
    currentHelpView notNil ifTrue:[
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   373
        (#(#'Control' #'Control_L' #'Control_R') includes:key) ifTrue:[
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   374
            "/ reopen showing the text
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   375
            self initiateHelpFor:aView at:(x@y) now:true.
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   376
            ^ true
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   377
        ].
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   378
        (#('Shift' #'Shift_L' #'Shift_R' #'Control' #'Control_L' #'Control_R') includes:key) ifTrue:[
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   379
            "/ do not close on those...
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   380
            ^ false
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   381
        ].
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   382
    ].
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   383
    ^ super keyRelease:key x:x y:y view:aView
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   384
d1dcdcb20574 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4220
diff changeset
   385
    "Created: / 20-02-2019 / 11:26:19 / Claus Gittinger"
4281
1629dc18017e #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4252
diff changeset
   386
    "Modified: / 28-06-2019 / 08:44:06 / Claus Gittinger"
2611
f578b9c43a6f handle escape key to close flyByHelp
Claus Gittinger <cg@exept.de>
parents: 2521
diff changeset
   387
!
f578b9c43a6f handle escape key to close flyByHelp
Claus Gittinger <cg@exept.de>
parents: 2521
diff changeset
   388
2521
7e51aa294156 care for mousewheel while showing help
Claus Gittinger <cg@exept.de>
parents: 2519
diff changeset
   389
mouseWheelMotion:state x:x y:y amount:amount deltaTime:dTime view:aView
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   390
    "/ DebuggingEvents := true
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   391
    "/ DebuggingEvents := false
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   392
    DebuggingEvents == true ifTrue:[
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   393
        ('%1: MouseWheel view:%2' 
4281
1629dc18017e #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4252
diff changeset
   394
                bindWith:self className 
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   395
                with:aView) infoPrintCR.
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   396
    ].
2521
7e51aa294156 care for mousewheel while showing help
Claus Gittinger <cg@exept.de>
parents: 2519
diff changeset
   397
    currentHelpView notNil ifTrue:[
7e51aa294156 care for mousewheel while showing help
Claus Gittinger <cg@exept.de>
parents: 2519
diff changeset
   398
        self handleMouseIn:aView x:x y:y.
7e51aa294156 care for mousewheel while showing help
Claus Gittinger <cg@exept.de>
parents: 2519
diff changeset
   399
    ].
7e51aa294156 care for mousewheel while showing help
Claus Gittinger <cg@exept.de>
parents: 2519
diff changeset
   400
    ^ false
4281
1629dc18017e #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4252
diff changeset
   401
1629dc18017e #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4252
diff changeset
   402
    "Modified: / 28-06-2019 / 08:44:10 / Claus Gittinger"
2521
7e51aa294156 care for mousewheel while showing help
Claus Gittinger <cg@exept.de>
parents: 2519
diff changeset
   403
!
7e51aa294156 care for mousewheel while showing help
Claus Gittinger <cg@exept.de>
parents: 2519
diff changeset
   404
1540
f6948fc36460 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 1536
diff changeset
   405
pointerLeave:state view:aView
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   406
    "/ DebuggingEvents := true
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   407
    "/ DebuggingEvents := false
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   408
    DebuggingEvents == true ifTrue:[
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   409
        ('%1: **** PointerLeave view:%2' 
4281
1629dc18017e #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4252
diff changeset
   410
                bindWith:self className 
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   411
                with:aView) infoPrintCR.
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   412
    ].
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   413
2611
f578b9c43a6f handle escape key to close flyByHelp
Claus Gittinger <cg@exept.de>
parents: 2521
diff changeset
   414
    aView == currentHelpView ifTrue:[^ true].
3198
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   415
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   416
    "/ clear the do-not-show-in-this-view mode (see keyPress)
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   417
"/     (currentHelpView isNil and:[currentView notNil]) ifTrue:[currentView := nil].
a43053b56eb3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3114
diff changeset
   418
2611
f578b9c43a6f handle escape key to close flyByHelp
Claus Gittinger <cg@exept.de>
parents: 2521
diff changeset
   419
    ^ super pointerLeave:state view:aView
4281
1629dc18017e #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4252
diff changeset
   420
1629dc18017e #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4252
diff changeset
   421
    "Modified: / 28-06-2019 / 08:44:13 / Claus Gittinger"
1540
f6948fc36460 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 1536
diff changeset
   422
! !
f6948fc36460 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 1536
diff changeset
   423
2392
02244f5708b7 reafctored
Claus Gittinger <cg@exept.de>
parents: 2002
diff changeset
   424
!FlyByHelp methodsFor:'help texts'!
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   425
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   426
helpTextFromModel:aModel view:aView at:aPointOrNil 
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   427
    "helper: ask aModel for its helpText."
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   428
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   429
    |text|
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   430
4048
eceffed47e1c #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4040
diff changeset
   431
    (aPointOrNil notNil and:[aModel respondsTo:#helpTextFor:at:]) ifTrue:[
eceffed47e1c #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4040
diff changeset
   432
        text := aModel helpTextFor:aView at:aPointOrNil.
4121
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   433
        text notNil ifTrue:[
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   434
            "/ Transcript showCR:aModel.
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   435
            "/ Transcript showCR:'via model-text'; showCR:text.
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   436
            ^ text
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   437
        ].
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   438
    ].
4048
eceffed47e1c #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4040
diff changeset
   439
    (aModel respondsTo:#helpTextFor:) ifTrue:[
eceffed47e1c #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4040
diff changeset
   440
        text := aModel helpTextFor:aView.
4121
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   441
        text notNil ifTrue:[
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   442
            "/ Transcript showCR:aModel.
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   443
            "/ Transcript showCR:'via model-text'; showCR:text.
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   444
            ^ text
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   445
        ].
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   446
    ].
2754
4c3b40eba71b changed:
Claus Gittinger <cg@exept.de>
parents: 2692
diff changeset
   447
    ^ nil
4040
1d540ba7a1d1 #REFACTORING by stefan
Stefan Vogel <sv@exept.de>
parents: 3959
diff changeset
   448
1d540ba7a1d1 #REFACTORING by stefan
Stefan Vogel <sv@exept.de>
parents: 3959
diff changeset
   449
    "Modified: / 09-01-2018 / 17:35:26 / stefan"
4121
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   450
    "Modified: / 11-06-2018 / 09:53:40 / Claus Gittinger"
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   451
!
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   452
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   453
helpTextFromView:aView at:aPointOrNil 
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   454
    "helper: ask aView for its helpText."
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   455
2754
4c3b40eba71b changed:
Claus Gittinger <cg@exept.de>
parents: 2692
diff changeset
   456
    |text key app|
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   457
4121
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   458
    "/ is there any view which does not understand helpTextAt: ???
4048
eceffed47e1c #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4040
diff changeset
   459
    (aPointOrNil notNil and:[aView respondsTo:#helpTextAt:]) ifTrue:[
eceffed47e1c #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4040
diff changeset
   460
        text := aView helpTextAt:aPointOrNil.
4121
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   461
        text notNil ifTrue:[
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   462
            "/ Transcript showCR:'via helpTextAt:'; showCR:text.
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   463
            ^ text
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   464
        ].
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   465
    ].
4121
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   466
    "/ is there any view which does not understand helpText ???
4048
eceffed47e1c #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4040
diff changeset
   467
    (aView respondsTo:#helpText) ifTrue:[
eceffed47e1c #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4040
diff changeset
   468
        text := aView helpText.
4121
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   469
        text notNil ifTrue:[
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   470
            "/ Transcript showCR:'via helpText'; showCR:text.
4220
3cd77e608abb #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4175
diff changeset
   471
            ^ text value
4121
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   472
        ].
2754
4c3b40eba71b changed:
Claus Gittinger <cg@exept.de>
parents: 2692
diff changeset
   473
    ].
3804
23207b26bfee #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 3803
diff changeset
   474
    "/ to be enabled in next release...
23207b26bfee #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 3803
diff changeset
   475
"/    (aView superView notNil
4048
eceffed47e1c #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4040
diff changeset
   476
"/    and:[aView superView respondsTo:#helpTextFor:]) ifTrue:[
eceffed47e1c #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4040
diff changeset
   477
"/        text := aView superView helpTextFor:aView.
3804
23207b26bfee #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 3803
diff changeset
   478
"/        text notNil ifTrue:[^ text].
23207b26bfee #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 3803
diff changeset
   479
"/    ].
4121
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   480
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   481
    "/ is there any view which does not understand helpKey ???
2754
4c3b40eba71b changed:
Claus Gittinger <cg@exept.de>
parents: 2692
diff changeset
   482
    (aView respondsTo:#helpKey) ifTrue:[
4c3b40eba71b changed:
Claus Gittinger <cg@exept.de>
parents: 2692
diff changeset
   483
        key := aView helpKey.
4c3b40eba71b changed:
Claus Gittinger <cg@exept.de>
parents: 2692
diff changeset
   484
        key notNil ifTrue:[
4c3b40eba71b changed:
Claus Gittinger <cg@exept.de>
parents: 2692
diff changeset
   485
            app := aView application.
4c3b40eba71b changed:
Claus Gittinger <cg@exept.de>
parents: 2692
diff changeset
   486
            app isNil ifTrue:[
4175
b78ca1f5c2ee #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4129
diff changeset
   487
                |topView topViewsHelpSpec|
b78ca1f5c2ee #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4129
diff changeset
   488
                
3763
72a6db06eee5 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 3681
diff changeset
   489
                "/ special case for oldStyle Dialog subclasses.
4175
b78ca1f5c2ee #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4129
diff changeset
   490
                topView := aView topView.
b78ca1f5c2ee #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4129
diff changeset
   491
                (topViewsHelpSpec := topView helpSpec) notNil ifTrue:[
b78ca1f5c2ee #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4129
diff changeset
   492
                    text := topViewsHelpSpec at:key ifAbsent:nil.
3763
72a6db06eee5 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 3681
diff changeset
   493
                    text notNil ifTrue:[
4121
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   494
                        "/ Transcript showCR:'via topViewspec+helpKey'; showCR:text.
4175
b78ca1f5c2ee #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4129
diff changeset
   495
                        ^ topView resources stringWithCRs:text.
3763
72a6db06eee5 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 3681
diff changeset
   496
                    ].    
72a6db06eee5 #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 3681
diff changeset
   497
                ].    
2754
4c3b40eba71b changed:
Claus Gittinger <cg@exept.de>
parents: 2692
diff changeset
   498
                app := Error handle:[:ex | nil] do:[ aView windowGroup mainGroup application ].
4c3b40eba71b changed:
Claus Gittinger <cg@exept.de>
parents: 2692
diff changeset
   499
            ].
4c3b40eba71b changed:
Claus Gittinger <cg@exept.de>
parents: 2692
diff changeset
   500
            app notNil ifTrue:[
4121
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   501
                text := app helpTextForKey:key.
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   502
                true "text notNil" ifTrue:[
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   503
                    "/ Transcript showCR:'via helpKey+helpTextForKey:'; showCR:text.
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   504
                    ^ text
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   505
                ].
2754
4c3b40eba71b changed:
Claus Gittinger <cg@exept.de>
parents: 2692
diff changeset
   506
            ].
4121
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   507
            text := aView resources string:key.
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   508
            true "(text notNil and:[text ~= key])" ifTrue:[
c9c15ae83c1c #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4119
diff changeset
   509
                "/ Transcript showCR:'via helpKey'; showCR:text.
4110
1a4cf666aafe #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4082
diff changeset
   510
                ^ text
1a4cf666aafe #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4082
diff changeset
   511
            ]    
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   512
        ].
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   513
    ].
2754
4c3b40eba71b changed:
Claus Gittinger <cg@exept.de>
parents: 2692
diff changeset
   514
    ^ nil.
4040
1d540ba7a1d1 #REFACTORING by stefan
Stefan Vogel <sv@exept.de>
parents: 3959
diff changeset
   515
1d540ba7a1d1 #REFACTORING by stefan
Stefan Vogel <sv@exept.de>
parents: 3959
diff changeset
   516
    "Modified: / 09-01-2018 / 17:38:42 / stefan"
4111
f42780e51cc1 #REFACTORING by sr
sr
parents: 4110
diff changeset
   517
    "Modified (format): / 07-06-2018 / 09:51:41 / sr"
4220
3cd77e608abb #FEATURE by cg
Claus Gittinger <cg@exept.de>
parents: 4175
diff changeset
   518
    "Modified: / 07-02-2019 / 19:18:39 / Claus Gittinger"
2392
02244f5708b7 reafctored
Claus Gittinger <cg@exept.de>
parents: 2002
diff changeset
   519
! !
02244f5708b7 reafctored
Claus Gittinger <cg@exept.de>
parents: 2002
diff changeset
   520
4119
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   521
!FlyByHelp methodsFor:'queries'!
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   522
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   523
currentlyShownView
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   524
    ^ currentHelpView
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   525
!
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   526
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   527
toolTipFollowsMouse
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   528
    "if true, the tooltip-window moves with the pointer
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   529
     so that it stays away from (does not cover) the mouse pointer"
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   530
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   531
    ^ false
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   532
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   533
    "Modified: / 06-06-2018 / 17:37:19 / Claus Gittinger"
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   534
! !
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   535
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   536
!FlyByHelp methodsFor:'show & hide help'!
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   537
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   538
activeHelpViewForApplication:applicationOrNil text:helpText onDevice:aDevice
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   539
    applicationOrNil notNil ifTrue:[
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   540
        ^ applicationOrNil activeHelpViewFor:helpText onDevice:aDevice
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   541
    ].
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   542
    ^ ActiveHelpView for:helpText onDevice:aDevice.
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   543
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   544
    "
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   545
     (ActiveHelpView for:'Hello' onDevice:Display) open
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   546
    "
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   547
!
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   548
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   549
hideHelp
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   550
    "hide the help text"
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   551
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   552
    |p|
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   553
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   554
    "/ lastHelpText := nil.
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   555
    self stopHelpDisplayProcess.
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   556
    lastHelpText := nil.
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   557
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   558
    currentHelpView notNil ifTrue:[
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   559
        [
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   560
            currentHelpView notNil ifTrue:[
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   561
                currentHelpView destroy.
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   562
                currentHelpView := nil.
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   563
                currentView := nil.
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   564
            ]
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   565
        ] valueUninterruptably
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   566
    ].
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   567
    currentFrame := nil.
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   568
    (p := closeProcess) notNil ifTrue:[
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   569
        closeProcess := nil.
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   570
        p terminate.
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   571
    ]
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   572
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   573
    "Modified: / 28-06-1997 / 14:03:50 / cg"
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   574
    "Modified: / 16-04-2018 / 16:51:01 / stefan"
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   575
!
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   576
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   577
hideIfPointerLeft:aView
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   578
    "hide help, if the pointer is not in aView"
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   579
4119
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   580
    |helpFrame whereOnScreen|
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   581
4119
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   582
    (helpFrame := currentFrame) notNil ifTrue:[
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   583
        whereOnScreen := aView graphicsDevice pointerPosition.
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   584
4119
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   585
        ((helpFrame insetBy:1@1) containsPoint:whereOnScreen) ifFalse:[
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   586
            self hideHelp.
4119
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   587
        ] ifTrue:[
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   588
            pointerPositionAtShowTime notNil ifTrue:[
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   589
                (whereOnScreen dist:pointerPositionAtShowTime) > 10 ifTrue:[
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   590
                    self hideHelp.
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   591
                ].    
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   592
            ].    
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   593
        ].            
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   594
    ].
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   595
4082
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   596
    "Modified: / 28-05-1996 / 20:18:28 / cg"
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   597
    "Modified: / 16-04-2018 / 16:59:48 / stefan"
4119
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   598
    "Modified: / 08-06-2018 / 10:30:04 / Claus Gittinger"
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   599
!
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   600
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   601
initiateHelpFor:aView at:aPointOrNil now:showItNow
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   602
    "ask aView for helpText, passing x/y coordinates;
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   603
     start a timeout process to display this helpText after some delay;
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   604
     Normally used internally, but can also be used by widgets to force 
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   605
     re-negotiation of the displayed helpText 
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   606
     (for example in a menu, when the selection changes)"
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   607
4110
1a4cf666aafe #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4082
diff changeset
   608
    |text delayTime|
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   609
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   610
    Debugging ifTrue:[
4281
1629dc18017e #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4252
diff changeset
   611
        ('%1: initiateHelpFor:at:now: %2' bindWith:self className with:aView) infoPrintCR.
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   612
    ].
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   613
    (self interestedIn:aView) ifFalse:[
4237
4c0ddd2ce72e #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4233
diff changeset
   614
        Debugging ifTrue:[
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   615
            ('%1: not interested' bindWith:self class name) infoPrintCR
4237
4c0ddd2ce72e #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4233
diff changeset
   616
        ].    
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   617
        ^ self
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   618
    ].
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   619
2680
Claus Gittinger <cg@exept.de>
parents: 2679
diff changeset
   620
    "/ do not allow for more than 200 ms to be spent in the
2679
552847065fb3 car not to hog the cpu by flyByHelp processing
Claus Gittinger <cg@exept.de>
parents: 2651
diff changeset
   621
    "/ helpText gatherer (the codeView parses the code for the variable under the cursor)
552847065fb3 car not to hog the cpu by flyByHelp processing
Claus Gittinger <cg@exept.de>
parents: 2651
diff changeset
   622
    [
2826
74bd82edee5a changed: #initiateHelpFor:at:now:
Claus Gittinger <cg@exept.de>
parents: 2799
diff changeset
   623
        Error handle:[:ex |
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   624
            ('%1: [warning]: error while asking for helpText: %2' bindWith:self class name with:ex description) errorPrintCR.
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   625
            '-------------------------' errorPrintCR.
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   626
            ex suspendedContext fullPrintAllOn:(Transcript ? Stderr).
2872
ea7e6fe01727 comment/format in: #initiateHelpFor:at:now:
Claus Gittinger <cg@exept.de>
parents: 2848
diff changeset
   627
            "/ self halt.
2826
74bd82edee5a changed: #initiateHelpFor:at:now:
Claus Gittinger <cg@exept.de>
parents: 2799
diff changeset
   628
        ] do:[
4231
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   629
            HelpKeyInsteadOfHelpTextQuery answer:(aView device ctrlDown) do:[
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   630
                text := self helpTextFor:aView at:aPointOrNil.
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   631
            ].
2826
74bd82edee5a changed: #initiateHelpFor:at:now:
Claus Gittinger <cg@exept.de>
parents: 2799
diff changeset
   632
        ].
3656
de582c82fa70 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 3418
diff changeset
   633
    ] valueWithWatchDog:[ 
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   634
        ('%1 [info]: flyBy text generation took too long' bindWith:self class name) infoPrintCR.
3656
de582c82fa70 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 3418
diff changeset
   635
        ^ self 
de582c82fa70 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 3418
diff changeset
   636
    ] afterMilliseconds:(self flyByHelpTimeoutMillis).
2679
552847065fb3 car not to hog the cpu by flyByHelp processing
Claus Gittinger <cg@exept.de>
parents: 2651
diff changeset
   637
4110
1a4cf666aafe #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4082
diff changeset
   638
    false ifTrue:[
1a4cf666aafe #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4082
diff changeset
   639
        (text notNil and:[text isEmpty]) ifTrue:[ 
1a4cf666aafe #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4082
diff changeset
   640
            Logger warning:('empty help from: ',aView class printString)
1a4cf666aafe #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4082
diff changeset
   641
        ] ifFalse:[
1a4cf666aafe #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4082
diff changeset
   642
            text isEmptyOrNil ifTrue:[ 
1a4cf666aafe #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4082
diff changeset
   643
                Logger warning:('no help from: ',aView class printString)
1a4cf666aafe #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4082
diff changeset
   644
            ].
1a4cf666aafe #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4082
diff changeset
   645
        ].
1a4cf666aafe #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4082
diff changeset
   646
    ].
1a4cf666aafe #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4082
diff changeset
   647
    
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   648
    (lastHelpText = text and:[lastHelpWidget == aView]) ifTrue:[
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   649
        "/ Debugging := true
4237
4c0ddd2ce72e #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4233
diff changeset
   650
        Debugging == true ifTrue:[
4c0ddd2ce72e #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4233
diff changeset
   651
            'same text: ' infoPrint. text infoPrintCR.
4c0ddd2ce72e #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4233
diff changeset
   652
        ].    
4082
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   653
        self toolTipFollowsMouse ifFalse:[
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   654
            Debugging == true ifTrue:[
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   655
                'tooltip does not follow mouse: ' infoPrint. text infoPrintCR.
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   656
            ].    
4082
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   657
            ^ self
2392
02244f5708b7 reafctored
Claus Gittinger <cg@exept.de>
parents: 2002
diff changeset
   658
        ]
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   659
    ].
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   660
4110
1a4cf666aafe #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4082
diff changeset
   661
    ((text size > 0) or:[text notNil and:[text isString not]]) ifTrue:[
2778
8b91cf06a145 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 2777
diff changeset
   662
        (showItNow not and:[(delayTime := self delayTime) > 0]) ifTrue:[
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   663
            self stopHelpDisplayProcess.
2392
02244f5708b7 reafctored
Claus Gittinger <cg@exept.de>
parents: 2002
diff changeset
   664
            showProcess := 
02244f5708b7 reafctored
Claus Gittinger <cg@exept.de>
parents: 2002
diff changeset
   665
                [
2680
Claus Gittinger <cg@exept.de>
parents: 2679
diff changeset
   666
                    Delay waitForSeconds:delayTime.
2774
7894ba397774 changed: #initiateHelpFor:at:now:
Claus Gittinger <cg@exept.de>
parents: 2754
diff changeset
   667
                    [
3766
4d3c0206456a #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 3763
diff changeset
   668
                        aView device notNil ifTrue:[    
4d3c0206456a #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 3763
diff changeset
   669
                            aView device anyButtonPressed ifFalse:[
4d3c0206456a #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 3763
diff changeset
   670
                                showProcess := nil.
4d3c0206456a #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 3763
diff changeset
   671
                                self showHelp:text for:aView
4d3c0206456a #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 3763
diff changeset
   672
                            ]
4d3c0206456a #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 3763
diff changeset
   673
                        ].
2774
7894ba397774 changed: #initiateHelpFor:at:now:
Claus Gittinger <cg@exept.de>
parents: 2754
diff changeset
   674
                    ] ensure:[
7894ba397774 changed: #initiateHelpFor:at:now:
Claus Gittinger <cg@exept.de>
parents: 2754
diff changeset
   675
                        showProcess := nil.
2680
Claus Gittinger <cg@exept.de>
parents: 2679
diff changeset
   676
                    ]
2392
02244f5708b7 reafctored
Claus Gittinger <cg@exept.de>
parents: 2002
diff changeset
   677
                ] forkAt:(Processor userSchedulingPriority + 1).
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   678
        ] ifFalse:[
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   679
            self showHelp:text for:aView
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   680
        ]
1542
f63515aab510 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 1540
diff changeset
   681
    ] ifFalse:[
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   682
        Debugging == true ifTrue:[
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   683
            'empty text: ' infoPrint. text infoPrintCR.
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   684
        ].    
1542
f63515aab510 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 1540
diff changeset
   685
        self hideHelp
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   686
    ].
2872
ea7e6fe01727 comment/format in: #initiateHelpFor:at:now:
Claus Gittinger <cg@exept.de>
parents: 2848
diff changeset
   687
2901
fed697afcef8 changed: #initiateHelpFor:at:now:
Claus Gittinger <cg@exept.de>
parents: 2900
diff changeset
   688
    "Modified: / 22-03-2011 / 19:10:28 / cg"
4082
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   689
    "Modified: / 16-04-2018 / 12:20:33 / stefan"
4281
1629dc18017e #OTHER by cg
Claus Gittinger <cg@exept.de>
parents: 4252
diff changeset
   690
    "Modified: / 28-06-2019 / 08:44:00 / Claus Gittinger"
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   691
!
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   692
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   693
showHelp:aHelpText for:view
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   694
    "show the help text for aView"
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   695
3786
c628a30083c3 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 3770
diff changeset
   696
    |wg applicationOrNil org p v device helpTextShown textLines
3334
d334c9dd9b76 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3321
diff changeset
   697
     helpViewWidth helpViewHeight usableWidth monitorBounds usableHeight
4119
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   698
     showTime cursorView pos pointerPosition|
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   699
2781
31725cdfbe43 leftover print
Claus Gittinger <cg@exept.de>
parents: 2780
diff changeset
   700
    "/ thisContext fullPrintAllOn:Transcript.
2651
7275384a60c7 care for nil windowGroup
Claus Gittinger <cg@exept.de>
parents: 2628
diff changeset
   701
    (wg := view windowGroup) notNil ifTrue:[
7275384a60c7 care for nil windowGroup
Claus Gittinger <cg@exept.de>
parents: 2628
diff changeset
   702
        wg isInModalLoop ifTrue:[
7275384a60c7 care for nil windowGroup
Claus Gittinger <cg@exept.de>
parents: 2628
diff changeset
   703
            wg isModal ifFalse:[
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   704
                Debugging ifTrue:[ 'FlyByHelp: not modal' infoPrintCR ].
2651
7275384a60c7 care for nil windowGroup
Claus Gittinger <cg@exept.de>
parents: 2628
diff changeset
   705
                ^ self
7275384a60c7 care for nil windowGroup
Claus Gittinger <cg@exept.de>
parents: 2628
diff changeset
   706
            ].
2628
03a41945fb37 do not show flyBy help for a view,
Claus Gittinger <cg@exept.de>
parents: 2612
diff changeset
   707
        ].
03a41945fb37 do not show flyBy help for a view,
Claus Gittinger <cg@exept.de>
parents: 2612
diff changeset
   708
    ].
03a41945fb37 do not show flyBy help for a view,
Claus Gittinger <cg@exept.de>
parents: 2612
diff changeset
   709
3786
c628a30083c3 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 3770
diff changeset
   710
    device := view graphicsDevice.
4119
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   711
    pointerPosition := device pointerPosition.
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   712
    
3418
a758dd978f99 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3394
diff changeset
   713
    "/ mouse still over that view?
4119
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   714
    cursorView := device viewFromPoint:pointerPosition.
3418
a758dd978f99 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3394
diff changeset
   715
    cursorView ~~ view ifTrue:[
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   716
        Debugging ifTrue:[ 'FlyByHelp: mouse no longer in view' infoPrintCR ].
3418
a758dd978f99 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3394
diff changeset
   717
        ^ self
a758dd978f99 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3394
diff changeset
   718
    ].
a758dd978f99 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3394
diff changeset
   719
4082
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   720
    (view == currentView and:[lastHelpText = aHelpText]) ifTrue:[
4252
ebdd626ee83b #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 4237
diff changeset
   721
        Debugging ifTrue:[ 'FlyByHelp: same text and widget' infoPrintCR ].
4082
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   722
        ^ self
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   723
    ].
4119
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   724
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   725
    pointerPositionAtShowTime := pointerPosition.
3228
187a4158a51a class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3220
diff changeset
   726
    lastHelpWidget := view.
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   727
    lastHelpText := aHelpText.
3251
afc7d588b25b handle key press and close help.
Claus Gittinger <cg@exept.de>
parents: 3248
diff changeset
   728
    helpTextShown := aHelpText.
4129
f6e152e7c328 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4121
diff changeset
   729
    
3257
382b74692cfc class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3255
diff changeset
   730
    "/ the text originator must already have generated CRs;
4114
4b0db85537e0 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4111
diff changeset
   731
    "/ no longer done here (otherwise, we could not generate tooltips with Windows filenames in it)
3681
c56b665d08a7 #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 3675
diff changeset
   732
    textLines := helpTextShown isStringCollection 
c56b665d08a7 #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 3675
diff changeset
   733
                    ifTrue:[helpTextShown]
3767
d88339439fb4 #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 3766
diff changeset
   734
                    ifFalse:[ 
d88339439fb4 #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 3766
diff changeset
   735
                        helpTextShown isString 
4129
f6e152e7c328 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4121
diff changeset
   736
                            ifTrue:[helpTextShown asCollectionOfLines asStringCollection]
3767
d88339439fb4 #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 3766
diff changeset
   737
                            ifFalse:[nil]].
d88339439fb4 #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 3766
diff changeset
   738
    textLines notNil ifTrue:[
d88339439fb4 #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 3766
diff changeset
   739
        textLines size > (self class maxNumberOfLines) ifTrue:[
d88339439fb4 #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 3766
diff changeset
   740
            textLines := (textLines copyTo:(self class maxNumberOfLines)) copyWith:'...'
d88339439fb4 #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 3766
diff changeset
   741
        ].
d88339439fb4 #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 3766
diff changeset
   742
        textLines := textLines collect:[:l | l contractAtEndTo:(self class maxNumberOfColumns)].
d88339439fb4 #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 3766
diff changeset
   743
        helpTextShown := textLines asString.
3251
afc7d588b25b handle key press and close help.
Claus Gittinger <cg@exept.de>
parents: 3248
diff changeset
   744
    ].
3767
d88339439fb4 #QUALITY by cg
Claus Gittinger <cg@exept.de>
parents: 3766
diff changeset
   745
    
2780
82e3e1061ae7 changed:
Claus Gittinger <cg@exept.de>
parents: 2778
diff changeset
   746
    (p := closeProcess) notNil ifTrue:[
82e3e1061ae7 changed:
Claus Gittinger <cg@exept.de>
parents: 2778
diff changeset
   747
        closeProcess := nil.
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   748
        p terminate.
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   749
    ].
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   750
    currentHelpView notNil ifTrue:[
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   751
        self hideHelp
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   752
    ].
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   753
3770
690e17824673 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 3769
diff changeset
   754
    "/ Transcript showCR:helpTextShown storeString.
3769
09e08477457d #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 3767
diff changeset
   755
    helpTextShown isEmptyOrNil ifTrue:[^ self].
09e08477457d #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 3767
diff changeset
   756
    
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   757
    org := view originRelativeTo:nil.
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   758
    currentFrame := org extent:view extent.
2848
43346e94b6ce changed: #showHelp:for:
Claus Gittinger <cg@exept.de>
parents: 2846
diff changeset
   759
    org := org + (view extent // 2).
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   760
3248
d72c8e4f7684 more control over the shape style
Claus Gittinger <cg@exept.de>
parents: 3247
diff changeset
   761
    wg notNil ifTrue:[ applicationOrNil := wg application ].
3786
c628a30083c3 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 3770
diff changeset
   762
    v := self activeHelpViewForApplication:applicationOrNil text:helpTextShown onDevice:device.
3251
afc7d588b25b handle key press and close help.
Claus Gittinger <cg@exept.de>
parents: 3248
diff changeset
   763
    v perform:#controllingHelpListener: with:self ifNotUnderstood:[].
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   764
2848
43346e94b6ce changed: #showHelp:for:
Claus Gittinger <cg@exept.de>
parents: 2846
diff changeset
   765
    helpViewWidth := v width.
43346e94b6ce changed: #showHelp:for:
Claus Gittinger <cg@exept.de>
parents: 2846
diff changeset
   766
    helpViewHeight := v height.
1677
dc49ab70b762 open helpView on the correcdt device
Claus Gittinger <cg@exept.de>
parents: 1657
diff changeset
   767
4082
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   768
    "https://expeccoalm.exept.de/D226383: keep the help window away from the pointer under any circumstances
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   769
     (especially when the window touches the bottom or the right edge of the screen).
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   770
     When the pointer is no longer in the current window, the help window is closed!!"
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   771
    pos := device pointerPosition.
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   772
    org := pos + (10@18).
3786
c628a30083c3 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 3770
diff changeset
   773
    monitorBounds := device monitorBoundsAt:org.
3114
fb742db4ee12 class: FlyByHelp
Stefan Vogel <sv@exept.de>
parents: 2979
diff changeset
   774
    usableWidth := monitorBounds width - 2.
3786
c628a30083c3 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 3770
diff changeset
   775
    usableHeight := device usableHeightAt:org.
3114
fb742db4ee12 class: FlyByHelp
Stefan Vogel <sv@exept.de>
parents: 2979
diff changeset
   776
fb742db4ee12 class: FlyByHelp
Stefan Vogel <sv@exept.de>
parents: 2979
diff changeset
   777
    helpViewWidth > usableWidth ifTrue:[v width:(helpViewWidth := usableWidth)].    
3247
768269b26ad3 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3243
diff changeset
   778
    helpViewHeight > usableHeight ifTrue:[v height:(helpViewHeight := usableHeight)].    
3114
fb742db4ee12 class: FlyByHelp
Stefan Vogel <sv@exept.de>
parents: 2979
diff changeset
   779
fb742db4ee12 class: FlyByHelp
Stefan Vogel <sv@exept.de>
parents: 2979
diff changeset
   780
    (org x + helpViewWidth) > (monitorBounds left + usableWidth) ifTrue:[
4082
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   781
        org x:(monitorBounds left + usableWidth - helpViewWidth).
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   782
    ].
3114
fb742db4ee12 class: FlyByHelp
Stefan Vogel <sv@exept.de>
parents: 2979
diff changeset
   783
    (org y + helpViewHeight) > (monitorBounds top + usableHeight) ifTrue:[
4082
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   784
        org y:(monitorBounds top + usableHeight - helpViewHeight).
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   785
    ].
4082
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   786
    ((org extent:v extent) containsPoint:pos) ifTrue:[
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   787
        "pointer would be in the help window (see comment above).
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   788
         Help window is at the lower right edge. Move it to the left of the pointer"
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   789
        org x:(pos x - helpViewWidth - 20).
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   790
    ].
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   791
    v origin:org.
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   792
    v realize.
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   793
    currentHelpView := v.
2392
02244f5708b7 reafctored
Claus Gittinger <cg@exept.de>
parents: 2002
diff changeset
   794
    currentView := view.
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   795
3334
d334c9dd9b76 class: FlyByHelp
Claus Gittinger <cg@exept.de>
parents: 3321
diff changeset
   796
    showTime := self showTime.
4082
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   797
    (showTime > 0) ifTrue:[
3959
63a594820146 #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 3804
diff changeset
   798
        p :=
63a594820146 #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 3804
diff changeset
   799
            [
1546
1af738601dae *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 1542
diff changeset
   800
                [
4082
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   801
                    Delay waitForSeconds:showTime.
2392
02244f5708b7 reafctored
Claus Gittinger <cg@exept.de>
parents: 2002
diff changeset
   802
                    [
2780
82e3e1061ae7 changed:
Claus Gittinger <cg@exept.de>
parents: 2778
diff changeset
   803
                        |v|
82e3e1061ae7 changed:
Claus Gittinger <cg@exept.de>
parents: 2778
diff changeset
   804
                        (v := currentHelpView) notNil ifTrue:[
2392
02244f5708b7 reafctored
Claus Gittinger <cg@exept.de>
parents: 2002
diff changeset
   805
                            currentHelpView := nil.
2780
82e3e1061ae7 changed:
Claus Gittinger <cg@exept.de>
parents: 2778
diff changeset
   806
                            v destroy.
2392
02244f5708b7 reafctored
Claus Gittinger <cg@exept.de>
parents: 2002
diff changeset
   807
                        ]
02244f5708b7 reafctored
Claus Gittinger <cg@exept.de>
parents: 2002
diff changeset
   808
                    ] valueUninterruptably
02244f5708b7 reafctored
Claus Gittinger <cg@exept.de>
parents: 2002
diff changeset
   809
                ] ifCurtailed:[
3959
63a594820146 #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 3804
diff changeset
   810
                    (p == closeProcess) ifTrue:[ closeProcess := nil ].
2392
02244f5708b7 reafctored
Claus Gittinger <cg@exept.de>
parents: 2002
diff changeset
   811
                ].
02244f5708b7 reafctored
Claus Gittinger <cg@exept.de>
parents: 2002
diff changeset
   812
            ] newProcess.
3959
63a594820146 #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 3804
diff changeset
   813
        p priority:(Processor userSchedulingPriority + 1).
63a594820146 #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 3804
diff changeset
   814
        closeProcess := p.
63a594820146 #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 3804
diff changeset
   815
        p resume.
2392
02244f5708b7 reafctored
Claus Gittinger <cg@exept.de>
parents: 2002
diff changeset
   816
    ].
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   817
1963
fb6663696d20 removed withCRs in showHelp:
Claus Gittinger <cg@exept.de>
parents: 1893
diff changeset
   818
    "Modified: / 31-08-1995 / 19:20:45 / claus"
3959
63a594820146 #BUGFIX by cg
Claus Gittinger <cg@exept.de>
parents: 3804
diff changeset
   819
    "Modified: / 06-06-2017 / 15:06:41 / cg"
4082
f2ffa50dcf0b #BUGFIX by stefan
Stefan Vogel <sv@exept.de>
parents: 4055
diff changeset
   820
    "Modified (format): / 16-04-2018 / 17:29:10 / stefan"
4119
eaee0352efdd #UI_ENHANCEMENT by cg
Claus Gittinger <cg@exept.de>
parents: 4114
diff changeset
   821
    "Modified: / 08-06-2018 / 10:28:32 / Claus Gittinger"
4129
f6e152e7c328 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 4121
diff changeset
   822
    "Modified (format): / 14-06-2018 / 08:29:43 / Claus Gittinger"
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   823
!
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   824
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   825
stopHelpDisplayProcess
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   826
    |p|
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   827
2680
Claus Gittinger <cg@exept.de>
parents: 2679
diff changeset
   828
    (p := showProcess) notNil ifTrue:[
Claus Gittinger <cg@exept.de>
parents: 2679
diff changeset
   829
        showProcess := nil.
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   830
        p terminate.
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   831
    ].
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   832
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   833
    "Created: 28.6.1997 / 14:03:17 / cg"
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   834
! !
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   835
4231
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   836
!FlyByHelp::HelpKeyInsteadOfHelpTextQuery class methodsFor:'documentation'!
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   837
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   838
documentation
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   839
"
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   840
    kludge to force application to return the helpKey instead of the
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   841
    help text. 
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   842
    Answering true will tell the ApplicationModel to return the key.
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   843
    (see AppModel >> helpTextForKey:)
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   844
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   845
    [author:]
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   846
        Claus Gittinger
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   847
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   848
    [instance variables:]
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   849
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   850
    [class variables:]
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   851
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   852
    [see also:]
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   853
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   854
"
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   855
! !
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   856
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   857
!FlyByHelp::HelpKeyInsteadOfHelpTextQuery methodsFor:'defaults'!
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   858
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   859
defaultResumeValue
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   860
    ^ false
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   861
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   862
    "Created: / 22-02-2019 / 09:48:28 / Claus Gittinger"
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   863
! !
5542e515b2d9 #REFACTORING by cg
Claus Gittinger <cg@exept.de>
parents: 4230
diff changeset
   864
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   865
!FlyByHelp class methodsFor:'documentation'!
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   866
2979
306456bdfb61 comment in: #keyPress:x:y:view:
Claus Gittinger <cg@exept.de>
parents: 2978
diff changeset
   867
version
3656
de582c82fa70 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 3418
diff changeset
   868
    ^ '$Header$'
2979
306456bdfb61 comment in: #keyPress:x:y:view:
Claus Gittinger <cg@exept.de>
parents: 2978
diff changeset
   869
!
306456bdfb61 comment in: #keyPress:x:y:view:
Claus Gittinger <cg@exept.de>
parents: 2978
diff changeset
   870
2754
4c3b40eba71b changed:
Claus Gittinger <cg@exept.de>
parents: 2692
diff changeset
   871
version_CVS
3656
de582c82fa70 #DOCUMENTATION by cg
Claus Gittinger <cg@exept.de>
parents: 3418
diff changeset
   872
    ^ '$Header$'
1536
fa0601a87d6e initial checkin
Claus Gittinger <cg@exept.de>
parents:
diff changeset
   873
! !
3114
fb742db4ee12 class: FlyByHelp
Stefan Vogel <sv@exept.de>
parents: 2979
diff changeset
   874