java.lang.Object | +--org.eclipse.swt.graphics.Device
Unsafe: This class is the abstract superclass of all device objects, such as the Display device and the Printer device. Devices can have a graphics context (GC) created for them, and they can be drawn on by sending messages to the associated GC.
Device(DeviceData data)
protected void
checkDevice()
SWTException if the receiver can not
be accessed by the caller.
protected void
destroy()
Rectangle
getClientArea()
int
getDepth()
Point
getDPI()
FontData[]
getFontList(String faceName,
boolean scalable)
FontData objects which describe
the fonts that match the given arguments.
Color
getSystemColor(int id)
SWT.
boolean
getWarnings()
true if the underlying window system prints out
warning messages on the console, and setWarnings
had previously been called with true.
abstract void
internal_dispose_GC(int hDC,
GCData data)
abstract int
internal_new_GC(GCData data)
protected void
release()
void
setWarnings(boolean warnings)
true prevents these
messages from being printed.
public static boolean DEBUG
boolean debug
boolean tracking
Error[] errors
Object[] objects
public int hPalette
int[] colorRefCount
int systemFont
int nFonts
org.eclipse.swt.internal.win32.LOGFONT[] logFonts
boolean disposed
protected static Device CurrentDevice
protected static Runnable DeviceFinder
public Device(DeviceData data)
You must dispose the device when it is no longer required.
data - the DeviceData which describes the receivercreate(org.eclipse.swt.graphics.DeviceData),
init(),
DeviceDatastatic Device getDevice()
protected void checkDevice()
SWTException if the receiver can not
be accessed by the caller. This may include both checks on
the state of the receiver and more generally on the entire
execution context. This method should be called by
device implementors to enforce the standard SWT invariants.
Currently, it is an error to invoke any method (other than
isDisposed() and dispose()) on a
device that has had its dispose() method called.
In future releases of SWT, there may be more or fewer error checks and exceptions may be thrown for different reasons.
protected void create(DeviceData data)
This method is called before init.
Subclasses are supposed to reimplement this method and not
call the super implementation.
data - the DeviceData which describes the receiverinit()int computePixels(int height)
int computePoints(org.eclipse.swt.internal.win32.LOGFONT logFont)
protected void destroy()
This method is called after release.
Subclasses are supposed to reimplement this method and not
call the super implementation.
public void dispose()
true when sent the message
isDisposed().
release(),
destroy(),
checkDevice()void dispose_Object(Object object)
int EnumFontFamProc(int lpelfe, int lpntme, int FontType, int lParam)
public Rectangle getBounds()
public DeviceData getDeviceData()
DeviceData based on the receiver.
Modifications made to this DeviceData will not
affect the receiver.
DeviceData containing the device's data and attributesDeviceDatapublic Rectangle getClientArea()
getBounds()public int getDepth()
public Point getDPI()
public FontData[] getFontList(String faceName, boolean scalable)
FontData objects which describe
the fonts that match the given arguments. If the
faceName is null, all fonts will be returned.
faceName - the name of the font to look for, or nullscalable - true if scalable fonts should be returned.
public Color getSystemColor(int id)
SWT. Any value other
than one of the SWT color constants which is passed
in will result in the color black. This color should
not be free'd because it was allocated by the system,
not the application.
id - the color constant
SWTpublic Font getSystemFont()
Typically, applications which want the default look should simply not set the font on the widgets they create. Widgets are always created with the correct default font for the class of user-interface component they represent.
public boolean getWarnings()
true if the underlying window system prints out
warning messages on the console, and setWarnings
had previously been called with true.
trueif warnings are being handled, and false otherwiseprotected void init()
This method is called after create.
If subclasses reimplement this method, they must
call the super implementation.
public abstract int internal_new_GC(GCData data)
IMPORTANT: This method is not part of the public
API for Device. 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.
internal_new_GC in interface Drawabledata - the platform specific GC data
public abstract void internal_dispose_GC(int hDC, GCData data)
IMPORTANT: This method is not part of the public
API for Device. 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.
internal_dispose_GC in interface Drawabledata - the platform specific GC datahDC - the platform specific GC handlepublic boolean isDisposed()
true if the device has been disposed,
and false otherwise.
This method gets the dispose state for the device. When a device has been disposed, it is an error to invoke any other method using the device.
true when the device is disposed and false otherwisevoid new_Object(Object object)
protected void release()
When a device is destroyed, resources that were acquired
on behalf of the programmer need to be returned to the
operating system. For example, if the device allocated a
font to be used as the system font, this font would be
freed in release. Also,to assist the garbage
collector and minimize the amount of memory that is not
reclaimed when the programmer keeps a reference to a
disposed device, all fields except the handle are zero'd.
The handle is needed by destroy.
destroy.
If subclasses reimplement this method, they must
call the super implementation.
public void setWarnings(boolean warnings)
true prevents these
messages from being printed. If the argument is false
message printing is not blocked.
warnings - trueif warnings should be handled, and false otherwise