Интерфейс Platform.Preferences

Все суперинтерфейсы:: Map<String,Object>, Observable, ObservableMap<String,Object>

Включающий класс:: Platform

public static sealed interface Platform.Preferences extends ObservableMap<String,Object>

Содержит настройки текущей платформы.

Preferences расширяет ObservableMap, чтобы предоставить доступ к настройкам платформы в виде пар "ключ-значение". Карта является неизменяемой, что означает, что ключи и значения нельзя добавлять, удалять или обновлять. Вызов любого метода изменения карты всегда приведет к броске UnsupportedOperationException. Однако, отображения будут обновляться JavaFX, когда операционная система сообщит о том, что настройка платформы изменилась.

Для удобства, предоставляются типизированные альтернативы нетипизированному методу Map.get(java.lang.Object): getInteger(java.lang.String), getDouble(java.lang.String), getBoolean(java.lang.String), getString(java.lang.String), getColor(java.lang.String) и getValue(java.lang.String, java.lang.Class<T>).

Настройки, предоставляемые платформой, могут зависеть от версии операционной системы и ее текущей конфигурации, поэтому приложения не должны предполагать, что конкретная настройка всегда доступна.

Следующие настройки потенциально доступны на указанных платформах:

Windows
`Windows.SPI.HighContrast`	`Boolean`
`Windows.SPI.HighContrastColorScheme`	`String`
`Windows.SPI.ClientAreaAnimation`	`Boolean`
`Windows.SysColor.COLOR_3DFACE`	`Color`
`Windows.SysColor.COLOR_BTNTEXT`	`Color`
`Windows.SysColor.COLOR_GRAYTEXT`	`Color`
`Windows.SysColor.COLOR_HIGHLIGHT`	`Color`
`Windows.SysColor.COLOR_HIGHLIGHTTEXT`	`Color`
`Windows.SysColor.COLOR_HOTLIGHT`	`Color`
`Windows.SysColor.COLOR_WINDOW`	`Color`
`Windows.SysColor.COLOR_WINDOWTEXT`	`Color`
`Windows.UIColor.Background`	`Color`
`Windows.UIColor.Foreground`	`Color`
`Windows.UIColor.AccentDark3`	`Color`
`Windows.UIColor.AccentDark2`	`Color`
`Windows.UIColor.AccentDark1`	`Color`
`Windows.UIColor.Accent`	`Color`
`Windows.UIColor.AccentLight1`	`Color`
`Windows.UIColor.AccentLight2`	`Color`
`Windows.UIColor.AccentLight3`	`Color`
`Windows.UISettings.AdvancedEffectsEnabled`	`Boolean`
`Windows.UISettings.AutoHideScrollBars`	`Boolean`
`Windows.NetworkInformation.InternetCostType`	`String`

macOS
`macOS.NSColor.labelColor`	`Color`
`macOS.NSColor.secondaryLabelColor`	`Color`
`macOS.NSColor.tertiaryLabelColor`	`Color`
`macOS.NSColor.quaternaryLabelColor`	`Color`
`macOS.NSColor.textColor`	`Color`
`macOS.NSColor.placeholderTextColor`	`Color`
`macOS.NSColor.selectedTextColor`	`Color`
`macOS.NSColor.textBackgroundColor`	`Color`
`macOS.NSColor.selectedTextBackgroundColor`	`Color`
`macOS.NSColor.keyboardFocusIndicatorColor`	`Color`
`macOS.NSColor.unemphasizedSelectedTextColor`	`Color`
`macOS.NSColor.unemphasizedSelectedTextBackgroundColor`	`Color`
`macOS.NSColor.linkColor`	`Color`
`macOS.NSColor.separatorColor`	`Color`
`macOS.NSColor.selectedContentBackgroundColor`	`Color`
`macOS.NSColor.unemphasizedSelectedContentBackgroundColor`	`Color`
`macOS.NSColor.selectedMenuItemTextColor`	`Color`
`macOS.NSColor.gridColor`	`Color`
`macOS.NSColor.headerTextColor`	`Color`
`macOS.NSColor.alternatingContentBackgroundColors`	`Color[]`
`macOS.NSColor.controlAccentColor`	`Color`
`macOS.NSColor.controlColor`	`Color`
`macOS.NSColor.controlBackgroundColor`	`Color`
`macOS.NSColor.controlTextColor`	`Color`
`macOS.NSColor.disabledControlTextColor`	`Color`
`macOS.NSColor.selectedControlColor`	`Color`
`macOS.NSColor.selectedControlTextColor`	`Color`
`macOS.NSColor.alternateSelectedControlTextColor`	`Color`
`macOS.NSColor.currentControlTint`	`String`
`macOS.NSColor.windowBackgroundColor`	`Color`
`macOS.NSColor.windowFrameTextColor`	`Color`
`macOS.NSColor.underPageBackgroundColor`	`Color`
`macOS.NSColor.findHighlightColor`	`Color`
`macOS.NSColor.highlightColor`	`Color`
`macOS.NSColor.shadowColor`	`Color`
`macOS.NSColor.systemBlueColor`	`Color`
`macOS.NSColor.systemBrownColor`	`Color`
`macOS.NSColor.systemGrayColor`	`Color`
`macOS.NSColor.systemGreenColor`	`Color`
`macOS.NSColor.systemIndigoColor`	`Color`
`macOS.NSColor.systemOrangeColor`	`Color`
`macOS.NSColor.systemPinkColor`	`Color`
`macOS.NSColor.systemPurpleColor`	`Color`
`macOS.NSColor.systemRedColor`	`Color`
`macOS.NSColor.systemTealColor`	`Color`
`macOS.NSColor.systemYellowColor`	`Color`
`macOS.NSWorkspace.accessibilityDisplayShouldReduceMotion`	`Boolean`
`macOS.NSWorkspace.accessibilityDisplayShouldReduceTransparency`	`Boolean`
`macOS.NSScroller.preferredScrollerStyle`	`String`
`macOS.NWPathMonitor.currentPathConstrained`	`Boolean`
`macOS.NWPathMonitor.currentPathExpensive`	`Boolean`

Linux
`GTK.theme_name`	`String`
`GTK.theme_fg_color`	`Color`
`GTK.theme_bg_color`	`Color`
`GTK.theme_base_color`	`Color`
`GTK.theme_selected_bg_color`	`Color`
`GTK.theme_selected_fg_color`	`Color`
`GTK.theme_unfocused_fg_color`	`Color`
`GTK.theme_unfocused_bg_color`	`Color`
`GTK.theme_unfocused_base_color`	`Color`
`GTK.theme_unfocused_selected_bg_color`	`Color`
`GTK.theme_unfocused_selected_fg_color`	`Color`
`GTK.insensitive_bg_color`	`Color`
`GTK.insensitive_fg_color`	`Color`
`GTK.insensitive_base_color`	`Color`
`GTK.borders`	`Color`
`GTK.unfocused_borders`	`Color`
`GTK.warning_color`	`Color`
`GTK.error_color`	`Color`
`GTK.success_color`	`Color`
`GTK.enable_animations`	`Boolean`
`GTK.overlay_scrolling`	`Boolean`
`GTK.network_metered`	`Boolean`

Since:: 22

Краткое описание вложенных классов

Вложенные классы/интерфейсы, объявленные в интерфейсе java.util.Map

Map.Entry<K,V>

Краткое описание свойств

Тип	Свойство	Описание
`ReadOnlyObjectProperty<Color>`	`accentColor`	Цвет акцента, который используется для выделения активной или важной части элемента управления и его отличия от остальной части пользовательского интерфейса.
`ReadOnlyObjectProperty<Color>`	`backgroundColor`	Цвет, используемый для областей фона.
`ReadOnlyObjectProperty<ColorScheme>`	`colorScheme`	Схема цветовой схемы платформы, которая определяет, должны ли приложения предпочитать светлый текст на тёмном фоне или тёмный текст на светлом фоне.
`ReadOnlyObjectProperty<Color>`	`foregroundColor`	Цвет, используемый для элементов переднего плана, таких как текст.
`ReadOnlyBooleanProperty`	`persistentScrollBars`	Указывает, должны ли приложения всегда отображать полосы прокрутки.
`ReadOnlyBooleanProperty`	`reducedData`	Указывает, должны ли приложения минимизировать объём интернет-трафика, который пользователи могут запросить, поскольку они находятся в сети с ограниченным доступом или с ограниченным пакетом данных.
`ReadOnlyBooleanProperty`	`reducedMotion`	Указывает, должны ли приложения минимизировать количество неважных анимаций, уменьшая дискомфорт для пользователей, которые испытывают укачивание или головокружение.
`ReadOnlyBooleanProperty`	`reducedTransparency`	Указывает, должны ли приложения минимизировать количество прозрачных или полупрозрачных эффектов слоя, что может помочь повысить контрастность и читаемость для некоторых пользователей.

Краткое описание методов

Модификатор и тип	Метод	Описание
`ReadOnlyObjectProperty<Color>`	`accentColorProperty()`	Цвет акцента, который используется для выделения активной или важной части элемента управления и его отличия от остальной части пользовательского интерфейса.
`ReadOnlyObjectProperty<Color>`	`backgroundColorProperty()`	Цвет, используемый для областей фона.
`ReadOnlyObjectProperty<ColorScheme>`	`colorSchemeProperty()`	Схема цветовой схемы платформы, которая определяет, должны ли приложения предпочитать светлый текст на тёмном фоне или тёмный текст на светлом фоне.
`ReadOnlyObjectProperty<Color>`	`foregroundColorProperty()`	Цвет, используемый для элементов переднего плана, таких как текст.
`Color`	`getAccentColor()`	Получает значение свойства `accentColor`.
`Color`	`getBackgroundColor()`	Получает значение свойства `backgroundColor`.
`Optional<Boolean>`	`getBoolean(String key)`	Возвращает необязательное значение `Boolean`, которому сопоставлен указанный ключ.
`Optional<Color>`	`getColor(String key)`	Возвращает необязательное значение `Color`, которому сопоставлен указанный ключ.
`ColorScheme`	`getColorScheme()`	Получает значение свойства `colorScheme`.
`Optional<Double>`	`getDouble(String key)`	Возвращает необязательное значение `Double`, которому сопоставлен указанный ключ.
`Color`	`getForegroundColor()`	Получает значение свойства `foregroundColor`.
`Optional<Integer>`	`getInteger(String key)`	Возвращает необязательное значение `Integer`, которому сопоставлен указанный ключ.
`Optional<String>`	`getString(String key)`	Возвращает необязательное значение `String`, которому сопоставлен указанный ключ.
`<T> Optional<T>`	`getValue(String key, Class<T> type)`	Возвращает необязательное значение, которому сопоставлен указанный ключ.
`boolean`	`isPersistentScrollBars()`	Получает значение свойства `persistentScrollBars`.
`boolean`	`isReducedData()`	Получает значение свойства `reducedData`.
`boolean`	`isReducedMotion()`	Получает значение свойства `reducedMotion`.
`boolean`	`isReducedTransparency()`	Получает значение свойства `reducedTransparency`.
`ReadOnlyBooleanProperty`	`persistentScrollBarsProperty()`	Указывает, должны ли приложения всегда отображать полосы прокрутки.
`ReadOnlyBooleanProperty`	`reducedDataProperty()`	Указывает, должны ли приложения минимизировать объём интернет-трафика, который пользователи могут запросить, поскольку они находятся в сети с ограниченным доступом или с ограниченным пакетом данных.
`ReadOnlyBooleanProperty`	`reducedMotionProperty()`	Указывает, должны ли приложения минимизировать количество неважных анимаций, уменьшая дискомфорт для пользователей, которые испытывают укачивание или головокружение.
`ReadOnlyBooleanProperty`	`reducedTransparencyProperty()`	Указывает, должны ли приложения минимизировать количество прозрачных или полупрозрачных эффектов слоя, что может помочь повысить контрастность и читаемость для некоторых пользователей.

Методы, объявленные в интерфейсе java.util.Map

clear, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, entrySet, equals, forEach, get, getOrDefault, hashCode, isEmpty, keySet, merge, put, putAll, putIfAbsent, remove, remove, replace, replace, replaceAll, size, values

Методы, объявленные в интерфейсе javafx.beans.Observable

addListener, removeListener, subscribe

Методы, объявленные в интерфейсе javafx.collections.ObservableMap

addListener, removeListener

Подробности свойств

persistentScrollBars

ReadOnlyBooleanProperty persistentScrollBarsProperty

Указывает, должны ли приложения всегда отображать полосы прокрутки. Если не задано, приложение может скрыть полосы прокрутки, которые не используются активно, или сделать их меньше или менее заметными.

Если платформа не сообщает об этом предпочтении, по умолчанию это свойство устанавливается в значение false.

Значение по умолчанию:

false

С:

См. также:

reducedMotion

ReadOnlyBooleanProperty reducedMotionProperty

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

Если платформа не сообщает об этом предпочтении, по умолчанию это свойство устанавливается в значение false.

Значение по умолчанию:

false

С:

См. также:

reducedTransparency

ReadOnlyBooleanProperty reducedTransparencyProperty

Указывает, должны ли приложения минимизировать количество прозрачных или полупрозрачных эффектов слоёв, что может помочь увеличить контраст и читаемость для некоторых пользователей.

Если платформа не сообщает об этом предпочтении, по умолчанию это свойство устанавливается в значение false.

Значение по умолчанию:

false

С:

См. также:

reducedData

ReadOnlyBooleanProperty reducedDataProperty

Указывает, должны ли приложения минимизировать объем интернет-трафика, который пользователи могут запросить, поскольку они находятся в сети с тарифицированным трафиком или с ограниченным пакетом данных.

Если платформа не сообщает об этом предпочтении, по умолчанию это свойство устанавливается в значение false.

Значение по умолчанию:

false

С:

См. также:

colorScheme

ReadOnlyObjectProperty<ColorScheme> colorSchemeProperty

Схема цветов платформы, которая указывает, должны ли приложения отдавать предпочтение светлому тексту на тёмном фоне или тёмному тексту на светлом фоне.

Если платформа не сообщает о предпочтениях по цветам, по умолчанию это свойство устанавливается в значение LIGHT.

Значение по умолчанию:

ColorScheme.LIGHT

См. также:

backgroundColor

ReadOnlyObjectProperty<Color> backgroundColorProperty

Цвет, используемый для областей фона.

Если платформа не сообщает о цвете фона, по умолчанию это свойство устанавливается в значение WHITE.

Значение по умолчанию:

Color.WHITE

См. также:

foregroundColor

ReadOnlyObjectProperty<Color> foregroundColorProperty

Цвет, используемый для элементов переднего плана, таких как текст.

Если платформа не сообщает о цвете переднего плана, по умолчанию это свойство устанавливается в значение BLACK.

Значение по умолчанию:

Color.BLACK

См. также:

accentColor

ReadOnlyObjectProperty<Color> accentColorProperty

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

Если платформа не сообщает о цвете акцента, по умолчанию это свойство устанавливается в яркий синий цвет (соответствующий шестнадцатеричному значению цвета #157EFB).

Значение по умолчанию:

#157EFB

См. также:

Подробности методов

persistentScrollBarsProperty

ReadOnlyBooleanProperty persistentScrollBarsProperty()

Если платформа не сообщает об этом предпочтении, по умолчанию это свойство устанавливается в значение false.

Значение по умолчанию:

false

Возвращает:

свойство persistentScrollBars

С:

См. также:

isPersistentScrollBars

boolean isPersistentScrollBars()

Возвращает значение свойства persistentScrollBars.

Описание свойства:

Если платформа не сообщает об этом предпочтении, по умолчанию это свойство устанавливается в значение false.

Значение по умолчанию:

false

Возвращает:

значение свойства persistentScrollBars

С:

См. также:

reducedMotionProperty

ReadOnlyBooleanProperty reducedMotionProperty()

Если платформа не сообщает об этом предпочтении, по умолчанию это свойство устанавливается в значение false.

Значение по умолчанию:

false

Возвращает:

свойство reducedMotion

С:

См. также:

isReducedMotion

boolean isReducedMotion()

Возвращает значение свойства reducedMotion.

Описание свойства:

Если платформа не сообщает об этом предпочтении, по умолчанию это свойство устанавливается в значение false.

Значение по умолчанию:

false

Возвращает:

значение свойства reducedMotion

С:

См. также:

reducedTransparencyProperty

ReadOnlyBooleanProperty reducedTransparencyProperty()

Если платформа не сообщает об этом предпочтении, по умолчанию это свойство устанавливается в значение false.

Значение по умолчанию:

false

Возвращает:

свойство reducedTransparency

С:

См. также:

isReducedTransparency

boolean isReducedTransparency()

Возвращает значение свойства reducedTransparency.

Описание свойства:

Если платформа не сообщает об этом предпочтении, по умолчанию это свойство устанавливается в значение false.

Значение по умолчанию:

false

Возвращает:

значение свойства reducedTransparency

С:

См. также:

reducedDataProperty

ReadOnlyBooleanProperty reducedDataProperty()

Указывает, должны ли приложения минимизировать объем интернет-трафика, что пользователи могут запросить, потому что они находятся в сети с ограниченным трафиком или с ограниченным планом данных.

Если платформа не сообщает об этом предпочтении, свойство по умолчанию равно false.

Значение по умолчанию:

false

Возвращает:

свойство reducedData

С:

См. также:

isReducedData

boolean isReducedData()

Получает значение свойства reducedData.

Описание свойства:

Если платформа не сообщает об этом предпочтении, свойство по умолчанию равно false.

Значение по умолчанию:

false

Возвращает:

значение свойства reducedData

С:

См. также:

colorSchemeProperty

ReadOnlyObjectProperty<ColorScheme> colorSchemeProperty()

Схема цветов платформы, которая определяет, должны ли приложения предпочитать светлый текст на тёмном фоне или тёмный текст на светлом фоне.

Если платформа не сообщает о предпочтениях цветов, свойство по умолчанию равно LIGHT.

Значение по умолчанию:

ColorScheme.LIGHT

Возвращает:

свойство colorScheme

См. также:

getColorScheme

ColorScheme getColorScheme()

Получает значение свойства colorScheme.

Описание свойства:

Если платформа не сообщает о предпочтениях цветов, свойство по умолчанию равно LIGHT.

Значение по умолчанию:

ColorScheme.LIGHT

Возвращает:

значение свойства colorScheme

См. также:

backgroundColorProperty

ReadOnlyObjectProperty<Color> backgroundColorProperty()

Цвет, используемый для областей фона.

Если платформа не сообщает о цвете фона, свойство по умолчанию равно WHITE.

Значение по умолчанию:

Color.WHITE

Возвращает:

свойство backgroundColor

См. также:

getBackgroundColor

Color getBackgroundColor()

Получает значение свойства backgroundColor.

Описание свойства:

Цвет, используемый для областей фона.

Если платформа не сообщает о цвете фона, свойство по умолчанию равно WHITE.

Значение по умолчанию:

Color.WHITE

Возвращает:

значение свойства backgroundColor

См. также:

foregroundColorProperty

ReadOnlyObjectProperty<Color> foregroundColorProperty()

Цвет, используемый для элементов переднего плана, таких как текст.

Если платформа не сообщает о цвете переднего плана, свойство по умолчанию равно BLACK.

Значение по умолчанию:

Color.BLACK

Возвращает:

свойство foregroundColor

См. также:

getForegroundColor

Color getForegroundColor()

Получает значение свойства foregroundColor.

Описание свойства:

Цвет, используемый для элементов переднего плана, таких как текст.

Если платформа не сообщает о цвете переднего плана, свойство по умолчанию равно BLACK.

Значение по умолчанию:

Color.BLACK

Возвращает:

значение свойства foregroundColor

См. также:

accentColorProperty

ReadOnlyObjectProperty<Color> accentColorProperty()

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

Если платформа не сообщает об акцентном цвете, свойство по умолчанию равно ярко-синему (соответствующему шестнадцатеричному значению цвета #157EFB).

Значение по умолчанию:

#157EFB

Возвращает:

свойство accentColor

См. также:

getAccentColor

Color getAccentColor()

Получает значение свойства accentColor.

Описание свойства:

Значение по умолчанию:

#157EFB

Возвращает:

значение свойства accentColor

См. также:

getInteger

Optional<Integer> getInteger(String key)

Возвращает необязательное Integer, которому сопоставлен указанный ключ.

Параметры:: key - ключ
Возвращает:: необязательное Integer, которому сопоставлен ключ
Исключения:: NullPointerException - если key равно null; IllegalArgumentException - если ключ не может быть сопоставлен с Integer

getDouble

Optional<Double> getDouble(String key)

Возвращает необязательное Double, которому сопоставлен указанный ключ.

Параметры:: key - ключ
Возвращает:: необязательное Double, которому сопоставлен ключ
Исключения:: NullPointerException - если key равно null; IllegalArgumentException - если ключ не может быть сопоставлен с Double

getBoolean

Optional<Boolean> getBoolean(String key)

Возвращает необязательное Boolean, которому сопоставлен указанный ключ.

Параметры:: key - ключ
Возвращает:: необязательное Boolean, которому сопоставлен ключ
Исключения:: NullPointerException - если key равно null; IllegalArgumentException - если ключ не может быть сопоставлен с Boolean

getString

Optional<String> getString(String key)

Возвращает необязательное String, которому сопоставлен указанный ключ.

Параметры:: key - ключ
Возвращает:: необязательное String, которому сопоставлен ключ
Исключения:: NullPointerException - если key равно null; IllegalArgumentException - если ключ не может быть сопоставлен с String

getColor

Optional<Color> getColor(String key)

Возвращает необязательный Color, которому сопоставлен указанный ключ.

Параметры:: key - ключ
Возвращает:: необязательный экземпляр Color, которому сопоставлен ключ
Исключения:: NullPointerException - если key равно null; IllegalArgumentException - если ключ не может быть сопоставлен с Color

getValue

<T> Optional<T> getValue(String key, Class<T> type)

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

Type Parameters:: T - тип значения
Parameters:: key - ключ; type - тип значения
Returns:: необязательное значение, которому сопоставлен ключ
Throws:: NullPointerException - если key или type равно null; IllegalArgumentException - если ключ не может быть сопоставлен со значением типа T

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.