java.awt
Class Cursor

java.lang.Object
  |
  +--java.awt.Cursor

All Implemented Interfaces:

Serializable

public class Cursor

extends Object

implements Serializable

Safe:

See Also:

Serialized Form

Field Summary

static int	CROSSHAIR_CURSOR Enabled: The crosshair cursor type.
private static String	CursorDotPrefix
(package private) static String[][]	cursorProperties
static int	CUSTOM_CURSOR Enabled: The type associated with all custom cursors.
static int	DEFAULT_CURSOR Enabled: The default cursor type (gets set if no cursor is defined).
private static String	DotFileSuffix
private static String	DotHotspotSuffix
private static String	DotNameSuffix
static int	E_RESIZE_CURSOR Enabled: The east-resize cursor type.
static int	HAND_CURSOR Enabled: The hand cursor type.
static int	MOVE_CURSOR Enabled: The move cursor type.
static int	N_RESIZE_CURSOR Enabled: The north-resize cursor type.
protected String	name The user-visible name of the cursor.
static int	NE_RESIZE_CURSOR Enabled: The north-east-resize cursor type.
static int	NW_RESIZE_CURSOR Enabled: The north-west-resize cursor type.
private long	pData Hook into native data.
protected static Cursor[]	predefined
static int	S_RESIZE_CURSOR Enabled: The south-resize cursor type.
static int	SE_RESIZE_CURSOR Enabled: The south-east-resize cursor type.
private static long	serialVersionUID
static int	SW_RESIZE_CURSOR Enabled: The south-west-resize cursor type.
private static String	systemCustomCursorDirPrefix
private static Properties	systemCustomCursorProperties
private static String	systemCustomCursorPropertiesFile
private static Hashtable	systemCustomCursors
static int	TEXT_CURSOR Enabled: The text cursor type.
(package private) int	type The chosen cursor type initially set to the DEFAULT_CURSOR.
static int	W_RESIZE_CURSOR Enabled: The west-resize cursor type.
static int	WAIT_CURSOR Enabled: The wait cursor type.

Constructor Summary

	Cursor(int type) Enabled: Creates a new cursor object with the specified type.
protected	Cursor(String name) Creates a new custom cursor object with the specified name.

Method Summary

protected void	finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
private void	finalizeImpl()
static Cursor	getDefaultCursor() Enabled: Return the system default cursor.
String	getName() Enabled: Returns the name of this cursor.
static Cursor	getPredefinedCursor(int type) Enabled: Returns a cursor object with the specified predefined type.
static Cursor	getSystemCustomCursor(String name) Enabled: @return the system specific custom Cursor named Cursor names are, for example: "Invalid.16x16"
int	getType() Enabled: Returns the type for this cursor.
private static String	initCursorDir()
private static void	initIDs() Initialize JNI field and method IDs for fields that may be accessed from C.
private static void	loadSystemCustomCursorProperties()
String	toString() Suppressed: Returns a string representation of this cursor.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_CURSOR

public static final int DEFAULT_CURSOR

Enabled: The default cursor type (gets set if no cursor is defined).

CROSSHAIR_CURSOR

public static final int CROSSHAIR_CURSOR

Enabled: The crosshair cursor type.

TEXT_CURSOR

public static final int TEXT_CURSOR

Enabled: The text cursor type.

WAIT_CURSOR

public static final int WAIT_CURSOR

Enabled: The wait cursor type.

SW_RESIZE_CURSOR

public static final int SW_RESIZE_CURSOR

Enabled: The south-west-resize cursor type.

SE_RESIZE_CURSOR

public static final int SE_RESIZE_CURSOR

Enabled: The south-east-resize cursor type.

NW_RESIZE_CURSOR

public static final int NW_RESIZE_CURSOR

Enabled: The north-west-resize cursor type.

NE_RESIZE_CURSOR

public static final int NE_RESIZE_CURSOR

Enabled: The north-east-resize cursor type.

N_RESIZE_CURSOR

public static final int N_RESIZE_CURSOR

Enabled: The north-resize cursor type.

S_RESIZE_CURSOR

public static final int S_RESIZE_CURSOR

Enabled: The south-resize cursor type.

W_RESIZE_CURSOR

public static final int W_RESIZE_CURSOR

Enabled: The west-resize cursor type.

E_RESIZE_CURSOR

public static final int E_RESIZE_CURSOR

Enabled: The east-resize cursor type.

HAND_CURSOR

public static final int HAND_CURSOR

Enabled: The hand cursor type.

MOVE_CURSOR

public static final int MOVE_CURSOR

Enabled: The move cursor type.

predefined

protected static Cursor[] predefined

cursorProperties

static final String[][] cursorProperties

type

int type

The chosen cursor type initially set to the DEFAULT_CURSOR.

See Also:

getType()

CUSTOM_CURSOR

public static final int CUSTOM_CURSOR

Enabled: The type associated with all custom cursors.

systemCustomCursors

private static final Hashtable systemCustomCursors

systemCustomCursorDirPrefix

private static final String systemCustomCursorDirPrefix

systemCustomCursorPropertiesFile

private static final String systemCustomCursorPropertiesFile

systemCustomCursorProperties

private static Properties systemCustomCursorProperties

CursorDotPrefix

private static final String CursorDotPrefix

DotFileSuffix

private static final String DotFileSuffix

DotHotspotSuffix

private static final String DotHotspotSuffix

DotNameSuffix

private static final String DotNameSuffix

serialVersionUID

private static final long serialVersionUID

pData

private transient long pData

Hook into native data.

name

protected String name

The user-visible name of the cursor.

See Also:

getName()

Constructor Detail

Cursor

public Cursor(int type)

Enabled: Creates a new cursor object with the specified type.

Parameters:

type - the type of cursor

Throws:

IllegalArgumentException - if the specified cursor type is invalid

Cursor

protected Cursor(String name)

Creates a new custom cursor object with the specified name.

Note: this constructor should only be used by AWT implementations as part of their support for custom cursors. Applications should use Toolkit.createCustomCursor().

Parameters:

name - the user-visible name of the cursor.

See Also:

java.awt.Toolkit#createCustomCursor

Method Detail

initCursorDir

private static String initCursorDir()

initIDs

private static void initIDs()

Initialize JNI field and method IDs for fields that may be accessed from C.

getPredefinedCursor

public static Cursor getPredefinedCursor(int type)

Enabled: Returns a cursor object with the specified predefined type.

Parameters:

type - the type of predefined cursor

Throws:

IllegalArgumentException - if the specified cursor type is invalid

getSystemCustomCursor

public static Cursor getSystemCustomCursor(String name)
                                    throws AWTException,
                                           HeadlessException

Enabled: @return the system specific custom Cursor named Cursor names are, for example: "Invalid.16x16"

AWTException

HeadlessException

getDefaultCursor

public static Cursor getDefaultCursor()

Enabled: Return the system default cursor.

getType

public int getType()

Enabled: Returns the type for this cursor.

getName

public String getName()

Enabled: Returns the name of this cursor.

Returns:

a localized description of this cursor.

Since:

1.2

toString

public String toString()

Suppressed: Returns a string representation of this cursor.

Overrides:

toString in class Object

Returns:

a string representation of this cursor.

Since:

1.2

loadSystemCustomCursorProperties

private static void loadSystemCustomCursorProperties()
                                              throws AWTException

AWTException

finalize

protected void finalize()
                 throws Throwable

Description copied from class: Object

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. A subclass overrides the finalize method to dispose of system resources or to perform other cleanup.

The general contract of finalize is that it is invoked if and when the Java^TM virtual machine has determined that there is no longer any means by which this object can be accessed by any thread that has not yet died, except as a result of an action taken by the finalization of some other object or class which is ready to be finalized. The finalize method may take any action, including making this object available again to other threads; the usual purpose of finalize, however, is to perform cleanup actions before the object is irrevocably discarded. For example, the finalize method for an object that represents an input/output connection might perform explicit I/O transactions to break the connection before the object is permanently discarded.

The finalize method of class Object performs no special action; it simply returns normally. Subclasses of Object may override this definition.

The Java programming language does not guarantee which thread will invoke the finalize method for any given object. It is guaranteed, however, that the thread that invokes finalize will not be holding any user-visible synchronization locks when finalize is invoked. If an uncaught exception is thrown by the finalize method, the exception is ignored and finalization of that object terminates.

After the finalize method has been invoked for an object, no further action is taken until the Java virtual machine has again determined that there is no longer any means by which this object can be accessed by any thread that has not yet died, including possible actions by other objects or classes which are ready to be finalized, at which point the object may be discarded.

The finalize method is never invoked more than once by a Java virtual machine for any given object.

Any exception thrown by the finalize method causes the finalization of this object to be halted, but is otherwise ignored.

Overrides:

finalize in class Object

Throws:

Throwable - the Exception raised by this method

finalizeImpl

private void finalizeImpl()
                   throws Throwable

Throwable