Class Resource
- Direct Known Subclasses:
Color
,Cursor
,Font
,GC
,Image
,Path
,Pattern
,Region
,TextLayout
,Transform
IMPORTANT: This class is intended to be subclassed only within the SWT implementation. However, it has not been marked final to allow those outside of the SWT development team to implement patched versions of the class in order to get around specific limitations in advance of when those limitations can be addressed by the team. Any class built using subclassing to access the internals of this class will likely fail to compile or run between releases and may be strongly platform specific. Subclassing should not be attempted without an intimate and detailed understanding of the workings of the hierarchy. No support is provided for user-written classes which are implemented as subclasses of this class.
- Since:
- 3.1
- See Also:
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
dispose()
Disposes of the operating system resources associated with this resource.Returns theDevice
where this resource was created.abstract boolean
Returnstrue
if the resource has been disposed, andfalse
otherwise.static void
setNonDisposeHandler
(Consumer<Error> reporter) Enables detection of Resource objects for whichdispose()
wasn't called, which means a leak of native memory and/or OS resources.
-
Constructor Details
-
Resource
public Resource()
-
-
Method Details
-
dispose
public void dispose()Disposes of the operating system resources associated with this resource. Applications must dispose of all resources which they allocate. This method does nothing if the resource is already disposed. -
getDevice
Returns theDevice
where this resource was created.- Returns:
Device
the device of the receiver- Since:
- 3.2
-
isDisposed
public abstract boolean isDisposed()Returnstrue
if the resource has been disposed, andfalse
otherwise.This method gets the dispose state for the resource. When a resource has been disposed, it is an error to invoke any other method (except
dispose()
) using the resource.- Returns:
true
when the resource is disposed andfalse
otherwise
-
setNonDisposeHandler
Enables detection of Resource objects for whichdispose()
wasn't called, which means a leak of native memory and/or OS resources. WARNING: the reporter will be called from a different thread. Do not block it and do not throw any exceptions. It's best to queue the errors for some other worker to process.- Parameters:
reporter
- object used to report detected errors. Use null to disable tracking. Setting a new reporter has an immediate effect.- Since:
- 3.116
-