Spec-Zone .ru
спецификации, руководства, описания, API

JavaFX: Обеспечение Богатого Опыта На Все Экраны Вашей Жизни

разверните все

Профиль: рабочий стол, распространенный

Краткий обзор

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

Пример:

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

def image = Image { url: "{__DIR__}mycursor.png" }

Scene {
    width: 400
    height: 300
    cursor: ImageCursor {
        image: image
        hotspotX: image.width/2
        hotspotY: image.height/2
    }
}
 

Профиль: распространенный

Переменная Сводка

доступимяввестиМожет ЧитатьМожет InitМожет ЗаписатьЗначение по умолчаниюописание
общественность-inithotspotXЧисло0

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

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

0  
общественность-inithotspotYЧисло0

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

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

0  
общественность-initизображениеИзображениенуль

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

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

нуль  

Наследованные Переменные

Сводка Функции сценария

общественность chooseBestCursor (изображения: Изображение [], hotspotX: Число, hotspotY: Число): ImageCursor

Создает пользовательский курсор изображения из одного из указанных изображений.

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

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

Параметры
изображения
последовательность изображений, из которых можно выбрать, в порядке предпочтения
hotspotX
X координат горячей точки в пределах первого изображения в последовательности изображений
hotspotY
координата Y горячей точки в пределах первого изображения в последовательности изображений
Возвраты
ImageCursor
курсор создается из лучшего изображения

Профиль: распространенный

 
общественность getBestSize (preferredWidth: Число, preferredHeight: Число): Dimension2D

Получает поддерживаемый размер курсора, который является самым близким к указанному привилегированному размеру.

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

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

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

Параметры
preferredWidth
привилегированный width курсора
preferredHeight
привилегированный height курсора
Возвраты
Dimension2D
поддерживаемый размер курсора

Профиль: распространенный

 
общественность getMaximumColors (): Целое число

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

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

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

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

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

Профиль: распространенный

 

Наследованные Функции