Cursor (Java Platform SE 6) (original) (raw)
java.awt
Class Cursor
java.lang.Object
java.awt.Cursor
All Implemented Interfaces:
public class Cursor
extends Object
implements Serializable
A class to encapsulate the bitmap representation of the mouse cursor.
See Also:
Component.setCursor(java.awt.Cursor), Serialized Form
Field Summary | |
---|---|
static int | CROSSHAIR_CURSOR The crosshair cursor type. |
static int | CUSTOM_CURSOR The type associated with all custom cursors. |
static int | DEFAULT_CURSOR The default cursor type (gets set if no cursor is defined). |
static int | E_RESIZE_CURSOR The east-resize cursor type. |
static int | HAND_CURSOR The hand cursor type. |
static int | MOVE_CURSOR The move cursor type. |
static int | N_RESIZE_CURSOR The north-resize cursor type. |
protected String | name The user-visible name of the cursor. |
static int | NE_RESIZE_CURSOR The north-east-resize cursor type. |
static int | NW_RESIZE_CURSOR The north-west-resize cursor type. |
protected static Cursor[] | predefined |
static int | S_RESIZE_CURSOR The south-resize cursor type. |
static int | SE_RESIZE_CURSOR The south-east-resize cursor type. |
static int | SW_RESIZE_CURSOR The south-west-resize cursor type. |
static int | TEXT_CURSOR The text cursor type. |
static int | W_RESIZE_CURSOR The west-resize cursor type. |
static int | WAIT_CURSOR The wait cursor type. |
Constructor Summary | |
---|---|
Cursor(int type) 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 | |
---|---|
static Cursor | getDefaultCursor() Return the system default cursor. |
String | getName() Returns the name of this cursor. |
static Cursor | getPredefinedCursor(int type) Returns a cursor object with the specified predefined type. |
static Cursor | getSystemCustomCursor(String name) Returns a system-specific custom cursor object matching the specified name. |
int | getType() Returns the type for this cursor. |
String | toString() Returns a string representation of this cursor. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, [wait](../../java/lang/Object.html#wait%28long, int%29) |
Field Detail |
---|
DEFAULT_CURSOR
public static final int DEFAULT_CURSOR
The default cursor type (gets set if no cursor is defined).
See Also:
CROSSHAIR_CURSOR
public static final int CROSSHAIR_CURSOR
The crosshair cursor type.
See Also:
TEXT_CURSOR
public static final int TEXT_CURSOR
The text cursor type.
See Also:
WAIT_CURSOR
public static final int WAIT_CURSOR
The wait cursor type.
See Also:
SW_RESIZE_CURSOR
public static final int SW_RESIZE_CURSOR
The south-west-resize cursor type.
See Also:
SE_RESIZE_CURSOR
public static final int SE_RESIZE_CURSOR
The south-east-resize cursor type.
See Also:
NW_RESIZE_CURSOR
public static final int NW_RESIZE_CURSOR
The north-west-resize cursor type.
See Also:
NE_RESIZE_CURSOR
public static final int NE_RESIZE_CURSOR
The north-east-resize cursor type.
See Also:
N_RESIZE_CURSOR
public static final int N_RESIZE_CURSOR
The north-resize cursor type.
See Also:
S_RESIZE_CURSOR
public static final int S_RESIZE_CURSOR
The south-resize cursor type.
See Also:
W_RESIZE_CURSOR
public static final int W_RESIZE_CURSOR
The west-resize cursor type.
See Also:
E_RESIZE_CURSOR
public static final int E_RESIZE_CURSOR
The east-resize cursor type.
See Also:
HAND_CURSOR
public static final int HAND_CURSOR
The hand cursor type.
See Also:
MOVE_CURSOR
public static final int MOVE_CURSOR
The move cursor type.
See Also:
predefined
protected static Cursor[] predefined
CUSTOM_CURSOR
public static final int CUSTOM_CURSOR
The type associated with all custom cursors.
See Also:
name
protected String name
The user-visible name of the cursor.
See Also:
Constructor Detail |
---|
Cursor
public Cursor(int type)
Creates a new cursor object with the specified type.
Parameters:
type
- the type of cursor
Throws:
[IllegalArgumentException](../../java/lang/IllegalArgumentException.html "class in java.lang")
- 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:
[Toolkit.createCustomCursor(java.awt.Image, java.awt.Point, java.lang.String)](../../java/awt/Toolkit.html#createCustomCursor%28java.awt.Image, java.awt.Point, java.lang.String%29)
Method Detail |
---|
getPredefinedCursor
public static Cursor getPredefinedCursor(int type)
Returns a cursor object with the specified predefined type.
Parameters:
type
- the type of predefined cursor
Returns:
the specified predefined cursor
Throws:
[IllegalArgumentException](../../java/lang/IllegalArgumentException.html "class in java.lang")
- if the specified cursor type is invalid
getSystemCustomCursor
public static Cursor getSystemCustomCursor(String name) throws AWTException, HeadlessException
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](../../java/awt/HeadlessException.html "class in java.awt")
- ifGraphicsEnvironment.isHeadless
returns true
[AWTException](../../java/awt/AWTException.html "class in java.awt")
getDefaultCursor
public static Cursor getDefaultCursor()
Return the system default cursor.
getType
public int getType()
Returns the type for this cursor.
getName
public String getName()
Returns the name of this cursor.
Returns:
a localized description of this cursor.
Since:
1.2
toString
public String toString()
Returns a string representation of this cursor.
Overrides:
[toString](../../java/lang/Object.html#toString%28%29)
in class [Object](../../java/lang/Object.html "class in java.lang")
Returns:
a string representation of this cursor.
Since:
1.2
Submit a bug or feature
For further API reference and developer documentation, see Java SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2015, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
Scripting on this page tracks web page traffic, but does not change the content in any way.