JavaTM 2 Platform
Standard Ed. 5.0

java.awt
类 Cursor

java.lang.Object
  继承者 java.awt.Cursor
所有已实现的接口:
Serializable

public class Cursor
extends Object
implements Serializable

封装鼠标光标的位图表示形式的类。

另请参见:
Component.setCursor(java.awt.Cursor), 序列化表格

字段摘要
static int CROSSHAIR_CURSOR
          十字光标类型。
static int CUSTOM_CURSOR
          与所有定制光标有关的类型。
static int DEFAULT_CURSOR
          默认光标类型(如果没有定义光标,则获得该设置)。
static int E_RESIZE_CURSOR
          调整窗口右边框位置的光标类型。
static int HAND_CURSOR
          手状光标类型。
static int MOVE_CURSOR
          移动光标类型。
static int N_RESIZE_CURSOR
          调整窗口上边框位置的光标类型。
protected  String name
          光标的用户可视名称。
static int NE_RESIZE_CURSOR
          调整窗口右上角位置的光标类型。
static int NW_RESIZE_CURSOR
          调整窗口左上角位置的光标类型。
protected static Cursor[] predefined
           
static int S_RESIZE_CURSOR
          调整窗口下边框位置的光标类型。
static int SE_RESIZE_CURSOR
          调整窗口右下角位置的光标类型。
static int SW_RESIZE_CURSOR
          调整窗口左下角位置的光标类型。
static int TEXT_CURSOR
          文字光标类型。
static int W_RESIZE_CURSOR
          调整窗口左边框位置的光标类型。
static int WAIT_CURSOR
          等待光标类型。
 
构造方法摘要
  Cursor(int type)
          用指定类型创建一个新的光标对象。
protected Cursor(String name)
          用指定名称创建一个新的定制光标对象。
 
方法摘要
protected  void finalize()
          当垃圾回收器确定不存在对该对象的更多引用时,由对象的垃圾回收器调用此方法。
static Cursor getDefaultCursor()
          返回系统默认光标。
 String getName()
          返回此光标的名称。
static Cursor getPredefinedCursor(int type)
          返回一个具有指定预定义类型的光标对象。
static Cursor getSystemCustomCursor(String name)
          返回与指定名称匹配的特定于系统的定制光标对象。
 int getType()
          返回此光标的类型。
 String toString()
          返回此光标的字符串表示形式。
 
从类 java.lang.Object 继承的方法
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

字段详细信息

DEFAULT_CURSOR

public static final int DEFAULT_CURSOR
默认光标类型(如果没有定义光标,则获得该设置)。

另请参见:
常量字段值

CROSSHAIR_CURSOR

public static final int CROSSHAIR_CURSOR
十字光标类型。

另请参见:
常量字段值

TEXT_CURSOR

public static final int TEXT_CURSOR
文字光标类型。

另请参见:
常量字段值

WAIT_CURSOR

public static final int WAIT_CURSOR
等待光标类型。

另请参见:
常量字段值

SW_RESIZE_CURSOR

public static final int SW_RESIZE_CURSOR
调整窗口左下角位置的光标类型。

另请参见:
常量字段值

SE_RESIZE_CURSOR

public static final int SE_RESIZE_CURSOR
调整窗口右下角位置的光标类型。

另请参见:
常量字段值

NW_RESIZE_CURSOR

public static final int NW_RESIZE_CURSOR
调整窗口左上角位置的光标类型。

另请参见:
常量字段值

NE_RESIZE_CURSOR

public static final int NE_RESIZE_CURSOR
调整窗口右上角位置的光标类型。

另请参见:
常量字段值

N_RESIZE_CURSOR

public static final int N_RESIZE_CURSOR
调整窗口上边框位置的光标类型。

另请参见:
常量字段值

S_RESIZE_CURSOR

public static final int S_RESIZE_CURSOR
调整窗口下边框位置的光标类型。

另请参见:
常量字段值

W_RESIZE_CURSOR

public static final int W_RESIZE_CURSOR
调整窗口左边框位置的光标类型。

另请参见:
常量字段值

E_RESIZE_CURSOR

public static final int E_RESIZE_CURSOR
调整窗口右边框位置的光标类型。

另请参见:
常量字段值

HAND_CURSOR

public static final int HAND_CURSOR
手状光标类型。

另请参见:
常量字段值

MOVE_CURSOR

public static final int MOVE_CURSOR
移动光标类型。

另请参见:
常量字段值

predefined

protected static Cursor[] predefined

CUSTOM_CURSOR

public static final int CUSTOM_CURSOR
与所有定制光标有关的类型。

另请参见:
常量字段值

name

protected String name
光标的用户可视名称。

另请参见:
getName()
构造方法详细信息

Cursor

public Cursor(int type)
用指定类型创建一个新的光标对象。

参数:
type - 光标的类型
抛出:
IllegalArgumentException - 如果指定的光标类型无效

Cursor

protected Cursor(String name)
用指定名称创建一个新的定制光标对象。

注:此构造方法应该只由 AWT 实现使用,用作它们支持定制光标的一部分。应用程序应该使用 Toolkit.createCustomCursor()。

参数:
name - 光标的用户可视名称。
另请参见:
Toolkit.createCustomCursor(java.awt.Image, java.awt.Point, java.lang.String)
方法详细信息

getPredefinedCursor

public static Cursor getPredefinedCursor(int type)
返回一个具有指定预定义类型的光标对象。

参数:
type - 指定光标的类型
返回:
指定的预定义光标
抛出:
IllegalArgumentException - 如果指定的光标类型无效

getSystemCustomCursor

public static Cursor getSystemCustomCursor(String name)
                                    throws AWTException,
                                           HeadlessException
返回与指定名称匹配的特定于系统的定制光标对象。例如,光标名称为:"Invalid.16x16"

参数:
name - 描述所需的特定于系统的定制光标的字符串
返回:
与指定名称匹配的特定于系统的定制光标
抛出:
HeadlessException - 如果 GraphicsEnvironment.isHeadless 返回 true
AWTException

getDefaultCursor

public static Cursor getDefaultCursor()
返回系统默认光标。


getType

public int getType()
返回此光标的类型。


getName

public String getName()
返回此光标的名称。

返回:
此光标的本地化描述。
从以下版本开始:
1.2

toString

public String toString()
返回此光标的字符串表示形式。

覆盖:
Object 中的 toString
返回:
此光标的字符串表示形式。
从以下版本开始:
1.2

finalize

protected void finalize()
                 throws Throwable
从类 Object 复制的描述
当垃圾回收器确定不存在对该对象的更多引用时,由对象的垃圾回收器调用此方法。子类重写 finalize 方法,以配置系统资源或执行其他清除。

finalize 的常规协定是:当 JavaTM 虚拟机已确定尚未终止的任何线程无法再通过任何方法访问此对象时,将调用此方法,除非由于准备终止的其他某个对象或类的终结操作执行了某个操作。finalize 方法可以采取任何操作,其中包括再次使此对象对其他线程可用;不过,finalize 的主要目的是在不可撤消地丢弃对象之前执行清除操作。例如,表示输入/输出连接的对象的 finalize 方法可执行显式 I/O 事务,以便在永久丢弃对象之前中断连接。

Object 类的 finalize 方法执行非特殊性操作;它仅执行一些常规返回。Object 的子类可以重写此定义。

Java 编程语言不保证哪个线程将调用某个给定对象的 finalize 方法。但可以保证在调用 finalize 时,调用 finalize 的线程将不会持有任何用户可见的同步锁定。如果 finalize 方法抛出未捕获的异常,那么该异常将被忽略,并且该对象的终结操作将终止。

在启用某个对象的 finalize 方法后,将不会执行进一步操作,直到 Java 虚拟机再次确定尚未终止的任何线程无法再通过任何方法访问此对象,其中包括由准备终止的其他对象或类执行的可能操作,在执行该操作时,对象可能被丢弃。

对于任何给定对象,Java 虚拟机最多只调用一次 finalize 方法。

finalize 方法抛出的任何异常都会导致此对象的终结操作停止,但可以通过其他方法忽略它。

覆盖:
Object 中的 finalize
抛出:
Throwable - 此方法抛出的 Exception

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策