Eclipse Plug-in Developer Guide (Galileo) - DeviceResourceDescriptor (Eclipse Platform API Specification)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

Eclipse Platform
Release 3.5

PREV CLASS NEXT CLASS

NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.eclipse.jface.resource
Class DeviceResourceDescriptor


java.lang.Object
  
org.eclipse.jface.resource.DeviceResourceDescriptor

Direct Known Subclasses:: ColorDescriptor, FontDescriptor, ImageDescriptor

public abstract class DeviceResourceDescriptor
extends Object
extends Object

Instances of this class can allocate and dispose SWT resources. Each instance describes a particular resource (such as a Color, Font, or Image) and can create and destroy that resource on demand. DeviceResourceDescriptors are managed by a ResourceRegistry.

Since:: 3.1
See Also:: ResourceManager

Constructor Summary

DeviceResourceDescriptor ()


Method Summary

abstract Object createResource ( Device device)
          Creates the resource described by this descriptor

abstract void destroyResource ( Object previouslyCreatedObject)
          Undoes everything that was done by a previous call to create(...), given the object that was returned by create(...).

Methods inherited from class java.lang. Object

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

Constructor Detail

DeviceResourceDescriptor

public DeviceResourceDescriptor()

Method Detail

createResource

public abstract 
Object createResource(
Device device)

Creates the resource described by this descriptor

Parameters:: device - the Device on which to allocate the resource
Returns:: the newly allocated resource (not null)
Throws:: DeviceResourceException - if unable to allocate the resource
Since:: 3.1

destroyResource

public abstract void destroyResource(
Object previouslyCreatedObject)

Undoes everything that was done by a previous call to create(...), given the object that was returned by create(...).

Parameters:: previouslyCreatedObject - an object that was returned by an equal descriptor in a previous call to createResource(...).
Since:: 3.1