| java.lang.Object
 org.eclipse.swt.graphics.Device
All known Subclasses: org.eclipse.swt.printing.Printer, org.eclipse.swt.widgets.Display,
| Device | | abstract public class Device implements Drawable(Code) | | 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.
|
| Constructor Summary | |
| public | Device()
Constructs a new instance of this class.
You must dispose the device when it is no longer required. | | public | Device(DeviceData data)
Constructs a new instance of this class.
You must dispose the device when it is no longer required. |
| Method Summary | |
| int | axialShadingProc(int ref, int in, int out)
| | protected void | checkDevice()
Throws an SWTException if the receiver can not
be accessed by the caller. | | protected void | create(DeviceData data)
Creates the device in the operating system. | | void | createPatternCallbacks()
| | protected void | destroy()
Destroys the device in the operating system and releases
the device's handle. | | public void | dispose()
Disposes of the operating system resources associated with
the receiver. | | void | dispose_Object(Object object)
| | int | drawPatternProc(int ref, int context)
| | public Rectangle | getBounds()
Returns a rectangle describing the receiver's size and location. | | public Rectangle | getClientArea()
Returns a rectangle which describes the area of the
receiver which is capable of displaying data. | | public Point | getDPI()
Returns a point whose x coordinate is the horizontal
dots per inch of the display, and whose y coordinate
is the vertical dots per inch of the display. | | public int | getDepth()
Returns the bit depth of the screen, which is the number of
bits it takes to represent the number of unique colors that
the screen is currently capable of displaying. | | static synchronized Device | getDevice()
| | public DeviceData | getDeviceData()
Returns a DeviceData based on the receiver. | | public FontData[] | getFontList(String faceName, boolean scalable)
Returns FontData objects which describe
the fonts that match the given arguments. | | public Color | getSystemColor(int id)
Returns the matching standard color for the given
constant, which should be one of the color constants
specified in class SWT. | | public Font | getSystemFont()
Returns a reasonable font for applications to use.
On some platforms, this will match the "default font"
or "system font" if such can be found. | | public boolean | getWarnings()
Returns true if the underlying window system prints out
warning messages on the console, and setWarnings
had previously been called with true. | | protected void | init()
Initializes any internal resources needed by the
device. | | abstract public void | internal_dispose_GC(int handle, GCData data)
Invokes platform specific functionality to dispose a GC handle.
IMPORTANT: This method is not part of the public
API for Device. | | abstract public int | internal_new_GC(GCData data)
Invokes platform specific functionality to allocate a new GC handle.
IMPORTANT: This method is not part of the public
API for Device. | | public boolean | isDisposed()
Returns true if the device has been disposed,
and false otherwise. | | public boolean | loadFont(String path)
Loads the font specified by a file. | | void | new_Object(Object object)
| | protected void | release()
Releases any internal resources back to the operating
system and clears all fields except the device handle.
When a device is destroyed, resources that were acquired
on behalf of the programmer need to be returned to the
operating system. | | int | releaseProc(int info, int data, int size)
| | public void | setWarnings(boolean warnings)
If the underlying window system supports printing warning messages
to the console, setting warnings to false prevents these
messages from being printed. |
| COLOR_BLACKCOLOR_DARK_REDCOLOR_DARK_GREENCOLOR_DARK_YELLOWCOLOR_DARK_BLUE | | Color COLOR_BLACKCOLOR_DARK_REDCOLOR_DARK_GREENCOLOR_DARK_YELLOWCOLOR_DARK_BLUE(Code) | | |
| COLOR_DARK_MAGENTACOLOR_DARK_CYANCOLOR_GRAYCOLOR_DARK_GRAYCOLOR_RED | | Color COLOR_DARK_MAGENTACOLOR_DARK_CYANCOLOR_GRAYCOLOR_DARK_GRAYCOLOR_RED(Code) | | |
| COLOR_GREENCOLOR_YELLOWCOLOR_BLUECOLOR_MAGENTACOLOR_CYANCOLOR_WHITE | | Color COLOR_GREENCOLOR_YELLOWCOLOR_BLUECOLOR_MAGENTACOLOR_CYANCOLOR_WHITE(Code) | | |
| DEBUG | | public static boolean DEBUG(Code) | | |
| colorspace | | int colorspace(Code) | | |
| disposedwarnings | | boolean disposedwarnings(Code) | | |
| drawPatternCallbackaxialShadingCallbackreleaseCallback | | Callback drawPatternCallbackaxialShadingCallbackreleaseCallback(Code) | | |
| drawPatternProcaxialShadingProcreleaseProc | | int drawPatternProcaxialShadingProcreleaseProc(Code) | | |
| tracking | | boolean tracking(Code) | | |
| Device | | public Device()(Code) | | Constructs a new instance of this class.
You must dispose the device when it is no longer required.
See Also: Device.create
See Also: Device.init
since:
3.1 |
| Device | | public Device(DeviceData data)(Code) | | Constructs a new instance of this class.
You must dispose the device when it is no longer required.
Parameters:
data - the DeviceData which describes the receiver
See Also: Device.create
See Also: Device.init
See Also: DeviceData |
| axialShadingProc | | int axialShadingProc(int ref, int in, int out)(Code) | | |
| checkDevice | | protected void checkDevice()(Code) | | Throws an 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.
exception:
SWTException - - ERROR_WIDGET_DISPOSED - if the receiver has been disposed
|
| create | | protected void create(DeviceData data)(Code) | | Creates the device in the operating system. If the device
does not have a handle, this method may do nothing depending
on the device.
This method is called before init.
Subclasses are supposed to reimplement this method and not
call the super implementation.
Parameters:
data - the DeviceData which describes the receiver
See Also: Device.init |
| createPatternCallbacks | | void createPatternCallbacks()(Code) | | |
| destroy | | protected void destroy()(Code) | | Destroys the device in the operating system and releases
the device's handle. If the device does not have a handle,
this method may do nothing depending on the device.
This method is called after release.
Subclasses are supposed to reimplement this method and not
call the super implementation.
See Also: Device.dispose
See Also: Device.release |
| dispose | | public void dispose()(Code) | | Disposes of the operating system resources associated with
the receiver. After this method has been invoked, the receiver
will answer true when sent the message
isDisposed().
See Also: Device.release
See Also: Device.destroy
See Also: Device.checkDevice |
| drawPatternProc | | int drawPatternProc(int ref, int context)(Code) | | |
| getBounds | | public Rectangle getBounds()(Code) | | Returns a rectangle describing the receiver's size and location.
the bounding rectangle
exception:
SWTException - - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
|
| getClientArea | | public Rectangle getClientArea()(Code) | | Returns a rectangle which describes the area of the
receiver which is capable of displaying data.
the client area
exception:
SWTException - - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
See Also: Device.getBounds |
| getDPI | | public Point getDPI()(Code) | | Returns a point whose x coordinate is the horizontal
dots per inch of the display, and whose y coordinate
is the vertical dots per inch of the display.
the horizontal and vertical DPI
exception:
SWTException - - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
|
| getDepth | | public int getDepth()(Code) | | Returns the bit depth of the screen, which is the number of
bits it takes to represent the number of unique colors that
the screen is currently capable of displaying. This number
will typically be one of 1, 8, 15, 16, 24 or 32.
the depth of the screen
exception:
SWTException - - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
|
| getDeviceData | | public DeviceData getDeviceData()(Code) | | Returns a DeviceData based on the receiver.
Modifications made to this DeviceData will not
affect the receiver.
a DeviceData containing the device's data and attributes
exception:
SWTException - - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
See Also: DeviceData |
| getFontList | | public FontData[] getFontList(String faceName, boolean scalable)(Code) | | Returns FontData objects which describe
the fonts that match the given arguments. If the
faceName is null, all fonts will be returned.
Parameters:
faceName - the name of the font to look for, or null
Parameters:
scalable - if true only scalable fonts are returned, otherwise only non-scalable fonts are returned. the matching font data
exception:
SWTException - - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
|
| getSystemColor | | public Color getSystemColor(int id)(Code) | | Returns the matching standard color for the given
constant, which should be one of the color constants
specified in class 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 freed because it was allocated by the system,
not the application.
Parameters:
id - the color constant the matching color
exception:
SWTException - - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
See Also: SWT |
| getSystemFont | | public Font getSystemFont()(Code) | | Returns a reasonable font for applications to use.
On some platforms, this will match the "default font"
or "system font" if such can be found. This font
should not be freed because it was allocated by the
system, not the application.
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.
a font
exception:
SWTException - - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
|
| getWarnings | | public boolean getWarnings()(Code) | | Returns 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 otherwise
exception:
SWTException - - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
|
| init | | protected void init()(Code) | | Initializes any internal resources needed by the
device.
This method is called after create.
If subclasses reimplement this method, they must
call the super implementation.
See Also: Device.create |
| internal_dispose_GC | | abstract public void internal_dispose_GC(int handle, GCData data)(Code) | | Invokes platform specific functionality to dispose a GC handle.
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.
Parameters:
hDC - the platform specific GC handle
Parameters:
data - the platform specific GC data |
| internal_new_GC | | abstract public int internal_new_GC(GCData data)(Code) | | Invokes platform specific functionality to allocate a new GC handle.
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.
Parameters:
data - the platform specific GC data the platform specific GC handle |
| isDisposed | | public boolean isDisposed()(Code) | | Returns 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 otherwise |
| loadFont | | public boolean loadFont(String path)(Code) | | Loads the font specified by a file. The font will be
present in the list of fonts available to the application.
Parameters:
path - the font file path whether the font was successfully loaded
exception:
SWTException - - ERROR_NULL_ARGUMENT - if path is null
- ERROR_DEVICE_DISPOSED - if the receiver has been disposed
See Also: Font
since:
3.3 |
| release | | protected void release()(Code) | | Releases any internal resources back to the operating
system and clears all fields except the device handle.
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.
This method is called before destroy.
If subclasses reimplement this method, they must
call the super implementation.
See Also: Device.dispose
See Also: Device.destroy |
| releaseProc | | int releaseProc(int info, int data, int size)(Code) | | |
| setWarnings | | public void setWarnings(boolean warnings)(Code) | | If the underlying window system supports printing warning messages
to the console, setting warnings to false prevents these
messages from being printed. If the argument is true then
message printing is not blocked.
Parameters:
warnings - trueif warnings should be printed, and false otherwise
exception:
SWTException - - ERROR_DEVICE_DISPOSED - if the receiver has been disposed
|
|
|