Класс BackgroundSize
- javafx.scene.layout.BackgroundSize
public final class BackgroundSize extends Object
width, height, contain и cover. Ширина и высота независимы друг от друга, но обе взаимодействуют с contain и cover. Согласно спецификации CSS, cover определяется как:
Масштабировать изображение, сохраняя его исходное соотношение сторон (если таковое имеется), до минимального размера, при котором и ширина, и высота могут полностью покрыть область позиционирования фона.
contain определяется как: Масштабировать изображение, сохраняя его исходное соотношение сторон (если таковое имеется), до максимального размера, при котором и ширина, и высота могут поместиться внутри области позиционирования фона.И ширина, и высота указывают (в абсолютных значениях или процентах) размер для использования. Эти два свойства применяются только в том случае, если оба cover и contain ложны. Если оба cover и contain истинны, то будет использоваться
cover. Ширина и высота также могут быть установлены в значение AUTO, что означает, что область должна быть размером, соответствующим исходному размеру изображения, или, если его невозможно определить, 100%.
С тех пор:
JavaFX 8.0
-
Краткое описание полей
Поля Модификатор и тип Поле и описание static doubleAUTOИз спецификации CSS: значение "auto" для одного измерения определяется с использованием исходного соотношения сторон изображения и размера другого измерения, или, если это невозможно, с использованием исходного размера изображения, или, если это невозможно, рассматривается как 100%.static BackgroundSizeDEFAULTЗначение BackgroundSize по умолчанию, используемое BackgroundImages, когда явный размер не определен.
-
Краткое описание конструкторов
Конструкторы Конструктор и описание BackgroundSize(double width, double height, boolean widthAsPercentage, boolean heightAsPercentage, boolean contain, boolean cover)Создает новый BackgroundSize.
-
Краткое описание методов
Все методыМетоды экземпляровКонкретные методы Модификатор и тип Метод и описание booleanequals(Object o)doublegetHeight()Высота области в Region, где должен отображаться связанный BackgroundImage.doublegetWidth()Ширина области в Region, где должен отображаться связанный BackgroundImage.inthashCode()booleanisContain()Если true, масштабирует изображение, сохраняя его исходное соотношение сторон (если оно есть), до максимального размера, при котором и ширина, и высота могут поместиться внутри области позиционирования фона.booleanisCover()Если true, масштабирует изображение, сохраняя его исходное соотношение сторон (если оно есть), до минимального размера, при котором и ширина, и высота могут полностью покрыть область позиционирования фона.booleanisHeightAsPercentage()Указывает, должно ли значение, содержащееся вheight, интерпретироваться как процент или как обычное значение.booleanisWidthAsPercentage()Указывает, должно ли значение, содержащееся вwidth, интерпретироваться как процент или как обычное значение.
-
Подробное описание полей
-
AUTO
public static final double AUTO
Из спецификации CSS:Значение "auto" для одного измерения определяется с использованием исходного соотношения сторон изображения и размера другого измерения, или, если это невозможно, с использованием исходного размера изображения, или, если это невозможно, рассматривается как 100%.
При установке в AUTO значения widthAsPercentage и heightAsPercentage игнорируются.Если оба значения равны "auto", то следует использовать исходную ширину и/или высоту изображения, если таковые имеются; пропущенное измерение (если таковое имеется) ведет себя как "auto", как описано выше. Если у изображения нет ни исходной ширины, ни исходной высоты, его размер определяется, как для "contain".
См. также:
-
DEFAULT
public static final BackgroundSize DEFAULT
Значение BackgroundSize по умолчанию, используемое BackgroundImages, когда явный размер не определен. По умолчанию, BackgroundSize — AUTO, AUTO для ширины и высоты, и ни cover, ни contain не заданы.
-
-
Подробное описание конструкторов
-
BackgroundSize
public BackgroundSize(double width, double height, boolean widthAsPercentage, boolean heightAsPercentage, boolean contain, boolean cover)Создает новый BackgroundSize.Параметры:
width- Ширина. Не может быть меньше 0, за исключением значения AUTO.
-
-
Подробное описание методов
-
getWidth
public final double getWidth()
Ширина области в Region, где должен отображаться связанный BackgroundImage. Если установлено в AUTO, тоwidthAsPercentageигнорируется. Это значение не имеет смысла, если заданы либоcontain, либоcover. Это значение не может быть отрицательным, за исключением случая, когда установлено в AUTO.
-
getHeight
public final double getHeight()
Высота области в Region, где должен отображаться связанный BackgroundImage. Если установлено в AUTO, тоheightAsPercentageигнорируется. Это значение не имеет смысла, если заданы либоcontain, либоcover. Это значение не может быть отрицательным, за исключением случая, когда установлено в AUTO.
-
isWidthAsPercentage
public final boolean isWidthAsPercentage()
Указывает, должно ли значение, содержащееся вwidth, интерпретироваться как процент или как обычное значение.
-
isHeightAsPercentage
public final boolean isHeightAsPercentage()
Указывает, должно ли значение, содержащееся вheight, интерпретироваться как процент или как обычное значение.
-
isContain
public final boolean isContain()
Если true, масштабирует изображение, сохраняя его исходное соотношение сторон (если оно есть), до максимального размера, при котором и ширина, и высота могут поместиться внутри области позиционирования фона.
-
isCover
public final boolean isCover()
Если true, масштабирует изображение, сохраняя его исходное соотношение сторон (если оно есть), до минимального размера, при котором и ширина, и высота могут полностью покрыть область позиционирования фона.
-
equals
public boolean equals(Object o)
-
hashCode
public int hashCode()
-
© 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.