Class Cursor
java.lang.Object
java.awt.Cursor
- All Implemented Interfaces:
Serializable
A class to encapsulate the bitmap representation of the mouse cursor.
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final intThe crosshair cursor type.static final intThe type associated with all custom cursors.static final intThe default cursor type (gets set if no cursor is defined).static final intThe east-resize cursor type.static final intThe hand cursor type.static final intThe move cursor type.static final intThe north-resize cursor type.protectedStringThe user-visible name of the cursor.static final intThe north-east-resize cursor type.static final intThe north-west-resize cursor type.protected staticCursor[]Deprecated.As of JDK version 1.7, thegetPredefinedCursor(int)method should be used instead.static final intThe south-resize cursor type.static final intThe south-east-resize cursor type.static final intThe south-west-resize cursor type.static final intThe text cursor type.static final intThe west-resize cursor type.static final intThe wait cursor type.Constructor Summary
ConstructorsMethod Summary
Modifier and TypeMethodDescriptionstaticCursorReturn the system default cursor.getName()Returns the name of this cursor.staticCursorgetPredefinedCursor(int type) Returns a cursor object with the specified predefined type.staticCursorgetSystemCustomCursor(String name) Returns a system-specific custom cursor object matching the specified name.intgetType()Returns the type for this cursor.toString()Returns a string representation of this cursor.
Field Details
DEFAULT_CURSOR
public static final int DEFAULT_CURSORThe default cursor type (gets set if no cursor is defined).- See Also:
CROSSHAIR_CURSOR
TEXT_CURSOR
WAIT_CURSOR
SW_RESIZE_CURSOR
public static final int SW_RESIZE_CURSORThe south-west-resize cursor type.- See Also:
SE_RESIZE_CURSOR
public static final int SE_RESIZE_CURSORThe south-east-resize cursor type.- See Also:
NW_RESIZE_CURSOR
public static final int NW_RESIZE_CURSORThe north-west-resize cursor type.- See Also:
NE_RESIZE_CURSOR
public static final int NE_RESIZE_CURSORThe north-east-resize cursor type.- See Also:
N_RESIZE_CURSOR
S_RESIZE_CURSOR
W_RESIZE_CURSOR
E_RESIZE_CURSOR
HAND_CURSOR
MOVE_CURSOR
predefined
Deprecated.As of JDK version 1.7, thegetPredefinedCursor(int)method should be used instead.CUSTOM_CURSOR
public static final int CUSTOM_CURSORThe type associated with all custom cursors.- See Also:
name
Constructor Details
Cursor
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
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:
Method Details
getPredefinedCursor
Returns a cursor object with the specified predefined type.- Parameters:
type- the type of predefined cursor- Returns:
- the specified predefined cursor
- Throws:
IllegalArgumentException- if the specified cursor type is invalid
getSystemCustomCursor
Returns a system-specific custom cursor object matching the specified name. Cursor names are, for example: "Invalid.16x16"- Parameters:
name- a string describing the desired system-specific custom cursor- Returns:
- the system specific custom cursor named
- Throws:
HeadlessException- ifGraphicsEnvironment.isHeadlessreturns trueAWTException- in case of erroneous retrieving of the cursor
getDefaultCursor
getType
public int getType()Returns the type for this cursor.- Returns:
- the cursor type
getName
Returns the name of this cursor.- Returns:
- a localized description of this cursor.
- Since:
- 1.2
toString