org.eclipse.swt.graphics

Class Resource

java.lang.Object

org.eclipse.swt.graphics.Resource

Direct Known Subclasses:

Color, Cursor, Font, GC, Image, Path, Pattern, Region, TextLayout, Transform

public abstract class Resource
extends java.lang.Object

This class is the abstract superclass of all graphics resource objects. Resources created by the application must be disposed.

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:

dispose(), isDisposed(), Sample code and further information

Structure Diagram

Field Summary

Fields

Modifier and Type	Field and Description
(package private) Device	device the device where this resource was created

Constructor Summary

Constructors

Constructor and Description
Resource()
Resource(Device device)

Method Summary

Methods

Modifier and Type	Method and Description
(package private) void	destroy()
void	dispose() Disposes of the operating system resources associated with this resource.
Device	getDevice() Returns the Device where this resource was created.
(package private) void	init()
abstract boolean	isDisposed() Returns true if the resource has been disposed, and false otherwise.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

device

Device device

the device where this resource was created

Constructor Detail

Resource

public Resource()

Resource

Resource(Device device)

Method Detail

destroy

void destroy()

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

public Device getDevice()

Returns the Device where this resource was created.

Returns:

Device the device of the receiver

Since:

3.2

init

void init()

isDisposed

public abstract boolean isDisposed()

Returns true if the resource has been disposed, and false 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 and false otherwise