|
Eclipse Platform Release 3.1 |
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.eclipse.jface.resource.DeviceResourceDescriptor
org.eclipse.jface.resource.FontDescriptor
Lightweight descriptor for a font. Creates the described font on demand. Subclasses can implement different ways of describing a font. These objects will be compared, so hashCode(...) and equals(...) must return something meaningful.
Constructor Summary | |
---|---|
FontDescriptor()
|
Method Summary | |
---|---|
abstract Font |
createFont(Device device)
Creates the Font described by this descriptor. |
static FontDescriptor |
createFrom(Font font)
Creates a FontDescriptor that describes an existing font. |
static FontDescriptor |
createFrom(FontData data)
Creates a new FontDescriptor given the associated FontData |
static FontDescriptor |
createFrom(FontData[] data)
Creates a new FontDescriptor given the an array of FontData that describes the font. |
static FontDescriptor |
createFrom(Font font,
Device originalDevice)
Creates a FontDescriptor that describes an existing font. |
static FontDescriptor |
createFrom(String name,
int height,
int style)
Creates a new FontDescriptor given an OS-specific font name, height, and style. |
Object |
createResource(Device device)
Creates the resource described by this descriptor |
abstract void |
destroyFont(Font previouslyCreatedFont)
Deallocates anything that was allocated by createFont, given a font that was allocated by an equal FontDescriptor. |
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 |
public FontDescriptor()
Method Detail |
public static FontDescriptor createFrom(Font font, Device originalDevice)
font
- a font to describeoriginalDevice
- must be the same Device that was passed into
the font's constructor when it was first created.
public static FontDescriptor createFrom(Font font)
createFrom(Font, Device)
, so the other version should be used whenever possible.
font
- font to create
public static FontDescriptor createFrom(FontData[] data)
data
- an array of FontData that describes the font (will be passed into
the Font's constructor)
public static FontDescriptor createFrom(FontData data)
data
- FontData describing the font to create
public static FontDescriptor createFrom(String name, int height, int style)
name
- os-specific font nameheight
- height (pixels)style
- a bitwise combination of NORMAL, BOLD, ITALIC
Font.Font(org.eclipse.swt.graphics.Device, java.lang.String, int, int)
public abstract Font createFont(Device device) throws DeviceResourceException
device
- device on which to allocate the font
DeviceResourceException
- if unable to allocate the Fontpublic abstract void destroyFont(Font previouslyCreatedFont)
previouslyCreatedFont
- previously allocated fontpublic final Object createResource(Device device) throws DeviceResourceException
DeviceResourceDescriptor
createResource
in class DeviceResourceDescriptor
device
- the Device on which to allocate the resource
DeviceResourceException
- if unable to allocate the resourcepublic final void destroyResource(Object previouslyCreatedObject)
DeviceResourceDescriptor
destroyResource
in class DeviceResourceDescriptor
previouslyCreatedObject
- an object that was returned by an equal
descriptor in a previous call to createResource(...).
|
Eclipse Platform Release 3.1 |
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Guidelines for using Eclipse APIs.
Copyright (c) IBM Corp. and others 2000, 2005. All rights reserved.