Instances of this class manage operating system resources that
define how text looks when it is displayed. Fonts may be constructed
by providing a device and either name, size and style information
or a FontData object which encapsulates this data.
Application code must explicitly invoke the Font.dispose()
method to release the operating system resources managed by each instance
when those instances are no longer required.
| field | type | note |
|---|---|---|
| handle | NSFont | the handle to the OS font resource
(Warning: This field is platform dependent)
IMPORTANT: This field is not part of the SWT public API. It is marked public only so that it can be shared within the packages provided by SWT. It is not available on all platforms and should never be accessed from application code. |
| extraTraits | int | the traits not supported to the OS font resource
(Warning: This field is platform dependent)
IMPORTANT: This field is not part of the SWT public API. It is marked public only so that it can be shared within the packages provided by SWT. It is not available on all platforms and should never be accessed from application code. |
<init>(org.eclipse.swt.graphics.Device device, org.eclipse.swt.graphics.FontData fd)Constructs a new font given a device and font data which describes the desired font's appearance.
You must dispose the font when it is no longer required.
| name | type | description |
|---|---|---|
| device | org.eclipse.swt.graphics.Device | the device to create the font on |
| fd | org.eclipse.swt.graphics.FontData | the FontData that describes the desired font (must not be null) |
| IllegalArgumentException |
|
|
| SWTError |
|
|
<init>(org.eclipse.swt.graphics.Device device, org.eclipse.swt.graphics.FontData[] fds)Constructs a new font given a device and an array of font data which describes the desired font's appearance.
You must dispose the font when it is no longer required.
| name | type | description |
|---|---|---|
| device | org.eclipse.swt.graphics.Device | the device to create the font on |
| fds | org.eclipse.swt.graphics.FontData[] | the array of FontData that describes the desired font (must not be null) |
| IllegalArgumentException |
|
|
| SWTError |
|
|
<init>(org.eclipse.swt.graphics.Device device, String name, int height, int style)Constructs a new font given a device, a font name, the height of the desired font in points, and a font style.
You must dispose the font when it is no longer required.
| name | type | description |
|---|---|---|
| device | org.eclipse.swt.graphics.Device | the device to create the font on |
| name | String | the name of the font (must not be null) |
| height | int | the font height in points |
| style | int | a bit or combination of NORMAL, BOLD, ITALIC |
| IllegalArgumentException |
|
|
| SWTError |
|
|
cocoa_new(org.eclipse.swt.graphics.Device device, org.eclipse.swt.internal.cocoa.NSFont handle)Invokes platform specific functionality to allocate a new font.
IMPORTANT: This method is not part of the public
API for Font. It is marked public only so that it
can be shared within the packages provided by SWT. It is not
available on all platforms, and should never be called from
application code.
| name | type | description |
|---|---|---|
| device | org.eclipse.swt.graphics.Device | the device on which to allocate the color |
| handle | org.eclipse.swt.internal.cocoa.NSFont | the handle for the font |
isDisposed() · also: is_disposedReturns true if the font has been disposed,
and false otherwise.
This method gets the dispose state for the font.
When a font has been disposed, it is an error to
invoke any other method (except #dispose()) using the font.
Returns: true when the font is disposed and false otherwise
equals(Object object)Compares the argument to the receiver, and returns true if they represent the same object using a class specific comparison.
| name | type | description |
|---|---|---|
| object | Object | the object to compare with this object |
Returns: true if the object is the same as this object and false otherwise
Returns an array of FontDatas representing the receiver.
On Windows, only one FontData will be returned per font. On X however,
a Font object may be composed of multiple X
fonts. To support this case, we return an array of font data objects.
Returns: an array of font data objects describing the receiver
| SWTException |
|
|
hashCode()Returns an integer hash code for the receiver. Any two
objects that return true when passed to
equals must return the same value for this
method.
Returns: the receiver's hash
toString()Returns a string containing a concise, human-readable description of the receiver.
Returns: a string representation of the receiver
Returns the Device where this resource was
created.
Returns: Device the device of the receiver
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.