DeviceHandle.st
author Claus Gittinger <cg@exept.de>
Mon, 12 Jul 2004 16:05:14 +0200
changeset 4200 ef9f995f1d20
parent 3878 28052cae1ad3
child 4434 cbbb56b8d851
permissions -rw-r--r--
slot to remember parentHandle
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
164
claus
parents: 151
diff changeset
     1
"
claus
parents: 151
diff changeset
     2
 COPYRIGHT (c) 1995 by Claus Gittinger
175
claus
parents: 164
diff changeset
     3
	      All Rights Reserved
164
claus
parents: 151
diff changeset
     4
claus
parents: 151
diff changeset
     5
 This software is furnished under a license and may be used
claus
parents: 151
diff changeset
     6
 only in accordance with the terms of that license and with the
claus
parents: 151
diff changeset
     7
 inclusion of the above copyright notice.   This software may not
claus
parents: 151
diff changeset
     8
 be provided or otherwise made available to, or used by, any
claus
parents: 151
diff changeset
     9
 other person.  No title to or ownership of the software is
claus
parents: 151
diff changeset
    10
 hereby transferred.
claus
parents: 151
diff changeset
    11
"
claus
parents: 151
diff changeset
    12
3611
8b4384c9e660 Use #finalize instead of #disposed
Stefan Vogel <sv@exept.de>
parents: 2913
diff changeset
    13
"{ Package: 'stx:libview' }"
8b4384c9e660 Use #finalize instead of #disposed
Stefan Vogel <sv@exept.de>
parents: 2913
diff changeset
    14
151
claus
parents:
diff changeset
    15
Object subclass:#DeviceHandle
4200
ef9f995f1d20 slot to remember parentHandle
Claus Gittinger <cg@exept.de>
parents: 3878
diff changeset
    16
	instanceVariableNames:'device parentId drawableId gcId'
601
2c4c1e797909 commentary
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    17
	classVariableNames:''
2c4c1e797909 commentary
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    18
	poolDictionaries:''
2c4c1e797909 commentary
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    19
	category:'Graphics-Support'
151
claus
parents:
diff changeset
    20
!
claus
parents:
diff changeset
    21
164
claus
parents: 151
diff changeset
    22
!DeviceHandle class methodsFor:'documentation'!
claus
parents: 151
diff changeset
    23
claus
parents: 151
diff changeset
    24
copyright
claus
parents: 151
diff changeset
    25
"
claus
parents: 151
diff changeset
    26
 COPYRIGHT (c) 1995 by Claus Gittinger
175
claus
parents: 164
diff changeset
    27
	      All Rights Reserved
164
claus
parents: 151
diff changeset
    28
claus
parents: 151
diff changeset
    29
 This software is furnished under a license and may be used
claus
parents: 151
diff changeset
    30
 only in accordance with the terms of that license and with the
claus
parents: 151
diff changeset
    31
 inclusion of the above copyright notice.   This software may not
claus
parents: 151
diff changeset
    32
 be provided or otherwise made available to, or used by, any
claus
parents: 151
diff changeset
    33
 other person.  No title to or ownership of the software is
claus
parents: 151
diff changeset
    34
 hereby transferred.
claus
parents: 151
diff changeset
    35
"
claus
parents: 151
diff changeset
    36
!
claus
parents: 151
diff changeset
    37
175
claus
parents: 164
diff changeset
    38
documentation
claus
parents: 164
diff changeset
    39
"
claus
parents: 164
diff changeset
    40
    This is an abstract class for device handles which are responsible
claus
parents: 164
diff changeset
    41
    for finalization i.e. to destroy underlying system resources, when the GC
claus
parents: 164
diff changeset
    42
    frees an object which has created some system object.
claus
parents: 164
diff changeset
    43
    Currently, these are forms and views (streams, cursors, colors and
claus
parents: 164
diff changeset
    44
    fonts could also make use of this class - however, for historical reasons,
claus
parents: 164
diff changeset
    45
    they continue to use their own private finalization machanisms. This may
claus
parents: 164
diff changeset
    46
    change in future versions).
601
2c4c1e797909 commentary
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    47
2c4c1e797909 commentary
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    48
    [see also:]
2c4c1e797909 commentary
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    49
        DeviceDrawable
611
e0442439a3c6 documentation
Claus Gittinger <cg@exept.de>
parents: 601
diff changeset
    50
e0442439a3c6 documentation
Claus Gittinger <cg@exept.de>
parents: 601
diff changeset
    51
    [author:]
e0442439a3c6 documentation
Claus Gittinger <cg@exept.de>
parents: 601
diff changeset
    52
        Claus Gittinger
e0442439a3c6 documentation
Claus Gittinger <cg@exept.de>
parents: 601
diff changeset
    53
175
claus
parents: 164
diff changeset
    54
"
164
claus
parents: 151
diff changeset
    55
! !
claus
parents: 151
diff changeset
    56
151
claus
parents:
diff changeset
    57
!DeviceHandle methodsFor:'accessing'!
claus
parents:
diff changeset
    58
1471
ba228f3678d9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 611
diff changeset
    59
id
ba228f3678d9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 611
diff changeset
    60
    "return the id of the dravable"
ba228f3678d9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 611
diff changeset
    61
ba228f3678d9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 611
diff changeset
    62
    ^ drawableId
ba228f3678d9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 611
diff changeset
    63
ba228f3678d9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 611
diff changeset
    64
    "Modified: 20.3.1997 / 16:34:00 / cg"
ba228f3678d9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 611
diff changeset
    65
! !
ba228f3678d9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 611
diff changeset
    66
1518
aa610d7fd205 catch abstract method.
Claus Gittinger <cg@exept.de>
parents: 1471
diff changeset
    67
!DeviceHandle methodsFor:'finalization'!
aa610d7fd205 catch abstract method.
Claus Gittinger <cg@exept.de>
parents: 1471
diff changeset
    68
3611
8b4384c9e660 Use #finalize instead of #disposed
Stefan Vogel <sv@exept.de>
parents: 2913
diff changeset
    69
finalize
1518
aa610d7fd205 catch abstract method.
Claus Gittinger <cg@exept.de>
parents: 1471
diff changeset
    70
    "I am abstract"
aa610d7fd205 catch abstract method.
Claus Gittinger <cg@exept.de>
parents: 1471
diff changeset
    71
2913
c51ac85e9aa2 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 1518
diff changeset
    72
    self subclassResponsibility
1518
aa610d7fd205 catch abstract method.
Claus Gittinger <cg@exept.de>
parents: 1471
diff changeset
    73
aa610d7fd205 catch abstract method.
Claus Gittinger <cg@exept.de>
parents: 1471
diff changeset
    74
    "Created: 2.4.1997 / 19:23:14 / cg"
aa610d7fd205 catch abstract method.
Claus Gittinger <cg@exept.de>
parents: 1471
diff changeset
    75
! !
aa610d7fd205 catch abstract method.
Claus Gittinger <cg@exept.de>
parents: 1471
diff changeset
    76
3878
28052cae1ad3 method category rename
Claus Gittinger <cg@exept.de>
parents: 3611
diff changeset
    77
!DeviceHandle methodsFor:'private-accessing'!
1471
ba228f3678d9 checkin from browser
Claus Gittinger <cg@exept.de>
parents: 611
diff changeset
    78
151
claus
parents:
diff changeset
    79
setDevice:aDevice id:aDrawableId gcId:aGCId
601
2c4c1e797909 commentary
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    80
    "set the handles contents"
2c4c1e797909 commentary
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    81
2c4c1e797909 commentary
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    82
    device := aDevice.
2c4c1e797909 commentary
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    83
    drawableId := aDrawableId.
2c4c1e797909 commentary
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    84
    gcId := aGCId
2c4c1e797909 commentary
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    85
2c4c1e797909 commentary
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    86
    "Modified: 23.4.1996 / 22:10:26 / cg"
4200
ef9f995f1d20 slot to remember parentHandle
Claus Gittinger <cg@exept.de>
parents: 3878
diff changeset
    87
!
ef9f995f1d20 slot to remember parentHandle
Claus Gittinger <cg@exept.de>
parents: 3878
diff changeset
    88
ef9f995f1d20 slot to remember parentHandle
Claus Gittinger <cg@exept.de>
parents: 3878
diff changeset
    89
setDevice:aDevice id:aDrawableId gcId:aGCId parentId:parentsDrawableId
ef9f995f1d20 slot to remember parentHandle
Claus Gittinger <cg@exept.de>
parents: 3878
diff changeset
    90
    "set the handles contents"
ef9f995f1d20 slot to remember parentHandle
Claus Gittinger <cg@exept.de>
parents: 3878
diff changeset
    91
ef9f995f1d20 slot to remember parentHandle
Claus Gittinger <cg@exept.de>
parents: 3878
diff changeset
    92
    device := aDevice.
ef9f995f1d20 slot to remember parentHandle
Claus Gittinger <cg@exept.de>
parents: 3878
diff changeset
    93
    drawableId := aDrawableId.
ef9f995f1d20 slot to remember parentHandle
Claus Gittinger <cg@exept.de>
parents: 3878
diff changeset
    94
    parentId := parentsDrawableId.
ef9f995f1d20 slot to remember parentHandle
Claus Gittinger <cg@exept.de>
parents: 3878
diff changeset
    95
    gcId := aGCId
151
claus
parents:
diff changeset
    96
! !
601
2c4c1e797909 commentary
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    97
2c4c1e797909 commentary
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    98
!DeviceHandle class methodsFor:'documentation'!
2c4c1e797909 commentary
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
    99
2c4c1e797909 commentary
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
   100
version
4200
ef9f995f1d20 slot to remember parentHandle
Claus Gittinger <cg@exept.de>
parents: 3878
diff changeset
   101
    ^ '$Header: /cvs/stx/stx/libview/DeviceHandle.st,v 1.12 2004-07-12 14:05:14 cg Exp $'
601
2c4c1e797909 commentary
Claus Gittinger <cg@exept.de>
parents: 219
diff changeset
   102
! !