javafx.scene

Класс ImageCursor

java.lang. Объект

javafx.scene. Курсор

javafx.scene. ImageCursor

public class ImageCursor
extends Cursor

Пользовательское представление изображения курсора мыши. На платформах, которые не поддерживают пользовательские курсоры, Cursor.DEFAULT будет использоваться вместо указанного ImageCursor.

Пример:

import javafx.scene.*;
import javafx.scene.image.*;

Image image = new Image("mycursor.png");

Scene scene = new Scene(400, 300);
scene.setCursor(new ImageCursor(image,
                                image.getWidth() / 2,
                                image.getHeight() /2));
 

С тех пор:

JavaFX 1.3

Сводка свойства

Свойства

Ввести	Свойство и Описание
ReadOnlyDoubleProperty	hotspotX X координат горячей точки курсора.
ReadOnlyDoubleProperty	hotspotY Координата Y горячей точки курсора.
ReadOnlyObjectProperty<Image>	изображение Изображение, чтобы вывести на экран, когда курсор является активным.

Полевая Сводка

Поля, наследованные от class javafx.scene. Курсор

CLOSED_HAND, CROSSHAIR, DEFAULT, DISAPPEAR, E_RESIZE, H_RESIZE, HAND, MOVE, N_RESIZE, NE_RESIZE, NONE, NW_RESIZE, OPEN_HAND, S_RESIZE, SE_RESIZE, SW_RESIZE, TEXT, V_RESIZE, W_RESIZE, WAIT

Сводка конструктора

Конструкторы

Конструктор и Описание
ImageCursor() Создает новое пустое ImageCursor который будет смотреть как Cursor.DEFAULT.
ImageCursor(Image image) Конструкции ImageCursor от указанного изображения.
ImageCursor(Image image, double hotspotX, double hotspotY) Конструкции ImageCursor от указанного изображения и координат горячей точки.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
static ImageCursor	chooseBestCursor(Image[] images, double hotspotX, double hotspotY) Создает пользовательский курсор изображения из одного из указанных изображений.
static Dimension2D	getBestSize(double preferredWidth, double preferredHeight) Получает поддерживаемый размер курсора, который является самым близким к указанному привилегированному размеру.
double	getHotspotX() X координат горячей точки курсора.
double	getHotspotY() Координата Y горячей точки курсора.
Изображение	getImage() Изображение, чтобы вывести на экран, когда курсор является активным.
static int	getMaximumColors() Возвращает максимальное количество цветов, поддерживаемых в пользовательской палитре курсора изображения.
ReadOnlyDoubleProperty	hotspotXProperty() X координат горячей точки курсора.
ReadOnlyDoubleProperty	hotspotYProperty() Координата Y горячей точки курсора.
ReadOnlyObjectProperty<Image>	imageProperty() Изображение, чтобы вывести на экран, когда курсор является активным.

Методы, наследованные от class javafx.scene. Курсор

cursor, toString

Методы, наследованные от class java.lang. Объект

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

Деталь свойства

изображение

Изображение, чтобы вывести на экран, когда курсор является активным. Если изображение является нулем, Cursor.DEFAULT будет использоваться.

См. Также:

getImage()

hotspotX

X координат горячей точки курсора. Эта горячая точка представляет расположение в пределах изображения курсора, которое будет выведено на экран в позиции мыши. Это должно быть в диапазоне [0, изображение. width-1]. Значение меньше чем 0 будут установлены в 0. Значение, больше чем изображение. width-1 будет установлен отобразить. width-1.

См. Также:

getHotspotX()

hotspotY

Координата Y горячей точки курсора. Эта горячая точка представляет расположение в пределах изображения курсора, которое будет выведено на экран в позиции мыши. Это должно быть в диапазоне [0, изображение. height-1]. Значение меньше чем 0 будут установлены в 0. Значение, больше чем изображение. height-1 будет установлен отобразить. height-1.

См. Также:

getHotspotY()

Деталь конструктора

ImageCursor

public ImageCursor()

Создает новое пустое ImageCursor который будет смотреть как Cursor.DEFAULT.

ImageCursor

public ImageCursor(Image image)

Конструкции ImageCursor от указанного изображения. Горячая точка курсора примет значение по умолчанию к левому верхнему углу.

Параметры:

image - изображение

ImageCursor

public ImageCursor(Image image,
           double hotspotX,
           double hotspotY)

Конструкции ImageCursor от указанного изображения и координат горячей точки.

Параметры:

image - изображение

hotspotX - X координат горячей точки курсора

hotspotY - координата Y горячей точки курсора

Деталь метода

getImage

public final Image getImage()

Изображение, чтобы вывести на экран, когда курсор является активным. Если изображение является нулем, Cursor.DEFAULT будет использоваться.

imageProperty

public final ReadOnlyObjectProperty<Image> imageProperty()

Изображение, чтобы вывести на экран, когда курсор является активным. Если изображение является нулем, Cursor.DEFAULT будет использоваться.

См. Также:

getImage()

getHotspotX

public final double getHotspotX()

X координат горячей точки курсора. Эта горячая точка представляет расположение в пределах изображения курсора, которое будет выведено на экран в позиции мыши. Это должно быть в диапазоне [0, изображение. width-1]. Значение меньше чем 0 будут установлены в 0. Значение, больше чем изображение. width-1 будет установлен отобразить. width-1.

hotspotXProperty

public final ReadOnlyDoubleProperty hotspotXProperty()

X координат горячей точки курсора. Эта горячая точка представляет расположение в пределах изображения курсора, которое будет выведено на экран в позиции мыши. Это должно быть в диапазоне [0, изображение. width-1]. Значение меньше чем 0 будут установлены в 0. Значение, больше чем изображение. width-1 будет установлен отобразить. width-1.

См. Также:

getHotspotX()

getHotspotY

public final double getHotspotY()

Координата Y горячей точки курсора. Эта горячая точка представляет расположение в пределах изображения курсора, которое будет выведено на экран в позиции мыши. Это должно быть в диапазоне [0, изображение. height-1]. Значение меньше чем 0 будут установлены в 0. Значение, больше чем изображение. height-1 будет установлен отобразить. height-1.

hotspotYProperty

public final ReadOnlyDoubleProperty hotspotYProperty()

Координата Y горячей точки курсора. Эта горячая точка представляет расположение в пределах изображения курсора, которое будет выведено на экран в позиции мыши. Это должно быть в диапазоне [0, изображение. height-1]. Значение меньше чем 0 будут установлены в 0. Значение, больше чем изображение. height-1 будет установлен отобразить. height-1.

См. Также:

getHotspotY()

getBestSize

public static Dimension2D getBestSize(double preferredWidth,
                      double preferredHeight)

Получает поддерживаемый размер курсора, который является самым близким к указанному привилегированному размеру. Значение (0,0) возвращается, если платформа не поддерживает пользовательские курсоры.

Отметьте: если изображение будет использоваться, чьи размерности не соответствуют поддерживаемый размер (как возвращено этим методом), то реализация изменит размеры изображения к поддерживаемому размеру. Это может привести к потере качества.

Отметьте: Эти значения могут измениться между операционными системами, видеокартами и разрешением экрана, но во время этой записи, демонстрационная машина Windows Vista, возвращенная 32x32 для всех требуемых размеров, в то время как демонстрационные машины Mac и Linux, возвращенные требуемый размер до максимума 64x64. Приложения должны обеспечить 32x32 курсор, который будет работать хорошо над всеми платформами, и может дополнительно хотеть обеспечить 64x64 курсор для тех платформ, на которых это поддерживается.

Параметры:

preferredWidth - привилегированный width курсора

preferredHeight - привилегированный height курсора

Возвраты:

поддерживаемый размер курсора

С тех пор:

JavaFX 1.3

getMaximumColors

public static int getMaximumColors()

Возвращает максимальное количество цветов, поддерживаемых в пользовательской палитре курсора изображения.

Отметьте: если изображение будет использоваться, у которого есть больше цветов в его палитре чем поддерживаемый максимум, то реализация попытается сгладить палитру к максимуму. Это может привести к потере качества.

Отметьте: Эти значения могут измениться между операционными системами, видеокартами и разрешением экрана, но во время этой записи, демонстрационная машина Windows Vista, возвращенная 256, демонстрационная машина Mac возвращенное Целое число. MAX_VALUE, указывая на поддержку полноцветных курсоров, и демонстрационную машину Linux, возвращенную 2. Приложения могут хотеть предназначаться для этих трех глубины цвета для оптимального курсора на каждой платформе.

Возвраты:

максимальное количество цветов поддерживается в пользовательской палитре курсора изображения

С тех пор:

JavaFX 1.3

chooseBestCursor

public static ImageCursor chooseBestCursor(Image[] images,
                           double hotspotX,
                           double hotspotY)

Создает пользовательский курсор изображения из одного из указанных изображений. Эта функция выберет изображение чей размер, наиболее близко соответствующий лучший размер курсора. hotpotX возвращенного ImageCursor масштабируется chosenImage. width / изображения [0].width и hotspotY масштабируется chosenImage. height / изображения [0].height.

На платформах, которые не поддерживают пользовательские курсоры, Cursor.DEFAULT будет использоваться вместо возвращенного ImageCursor.

Параметры:

images - последовательность изображений, из которых можно выбрать, в порядке предпочтения

hotspotX - X координат горячей точки в пределах первого изображения в последовательности изображений

hotspotY - координата Y горячей точки в пределах первого изображения в последовательности изображений

Возвраты:

курсор создается из лучшего изображения

С тех пор:

JavaFX 1.3