BackgroundSize

java.lang.Object
- javafx.scene.layout.BackgroundSize

```
public final class BackgroundSize
extends Object
```
Определяет размер области, которую BackgroundImage должна заполнить относительно Region, которую она стилизует. Есть несколько свойств, значения которых имеют приоритет над другими. В частности, есть 4 ключевых свойства, width, height, contain и cover. Ширина и высота независимы друг от друга, однако обе взаимодействуют с contain и cover.
Согласно спецификации CSS, cover определяется следующим образом:

Масштабировать изображение, сохраняя его собственное соотношение сторон (если оно есть), до минимального размера, при котором и его ширина, и его высота могут полностью покрыть область размещения фона.
contain определяется следующим образом:
Масштабировать изображение, сохраняя его собственное соотношение сторон (если оно есть), до максимального размера, при котором и его ширина, и его высота могут поместиться внутри области размещения фона.
И ширина, и высота оба задают (в абсолютных значениях или процентах) размер для использования. Эти два свойства применяются только в том случае, если как cover, так и contain ложны. Если и cover, и contain истинны, то cover будет использоваться.
Ширина и высота также могут быть установлены в значение AUTO, что указывает на то, что область должна быть размером, чтобы использовать собственный размер изображения, или, если его нельзя определить, 100%.

С тех пор:

JavaFX 8.0

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

Поля
Модификатор и тип	Поле	Описание
`static double`	`AUTO`	Согласно спецификации CSS: значение "auto" для одного измерения определяется с использованием соотношения сторон изображения и размера другого измерения, или, если это невозможно, с использованием собственного размера изображения, или, если это невозможно, как 100%.
`static BackgroundSize`	`DEFAULT`	Значение BackgroundSize по умолчанию, используемое BackgroundImages, когда явный размер не определен.

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

Конструкторы
Конструктор	Описание
`BackgroundSize(double width, double height, boolean widthAsPercentage, boolean heightAsPercentage, boolean contain, boolean cover)`	Создать новый BackgroundSize.

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

Все методыМетоды экземпляраКонкретные методы
Модификатор и тип	Метод	Описание
`boolean`	`equals(Object o)`
`double`	`getHeight()`	Высота области внутри Region, где должен отображаться связанный BackgroundImage.
`double`	`getWidth()`	Ширина области внутри Region, где должен отображаться связанный BackgroundImage.
`int`	`hashCode()`
`boolean`	`isContain()`	Если true, масштабировать изображение, сохраняя его собственное соотношение сторон (если оно есть), до максимального размера, при котором и его ширина, и его высота могут поместиться внутри области размещения фона.
`boolean`	`isCover()`	Если true, масштабировать изображение, сохраняя его собственное соотношение сторон (если оно есть), до минимального размера, при котором и его ширина, и его высота могут полностью покрыть область размещения фона.
`boolean`	`isHeightAsPercentage()`	Указывает, должно ли значение, содержащееся в `height`, интерпретироваться как процент или как обычное значение.
`boolean`	`isWidthAsPercentage()`	Указывает, должно ли значение, содержащееся в `width`, интерпретироваться как процент или как обычное значение.

Методы, унаследованные от класса java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Подробное описание полей
- AUTO
```
public static final double AUTO
```
  Из спецификации CSS:
  Значение "auto" для одной размерности определяется с использованием собственного соотношения сторон изображения и размера другой размерности, или, если это не удается, с использованием собственного размера изображения, или, если это не удается, рассматривается как 100%.
  Если оба значения "auto", то используются собственные ширина и/или высота изображения, если таковые имеются, а отсутствующая размерность (если таковая имеется) ведет себя как "auto" в соответствии с описанием выше. Если у изображения нет ни собственной ширины, ни собственной высоты, его размер определяется так же, как и для "contain".
  
  При установке значения AUTO, значения widthAsPercentage и heightAsPercentage игнорируются.
  
  См. также:
  
  Постоянные значения полей
- 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.
  
  height - Высота. Не может быть меньше 0, за исключением значения AUTO.
  
  widthAsPercentage - Нужно ли интерпретировать ширину как процентное значение
  
  heightAsPercentage - Нужно ли интерпретировать высоту как процентное значение
  
  contain - Нужно ли масштабировать изображение так, чтобы оно максимально вписалось в область
  
  cover - Нужно ли масштабировать изображение так, чтобы оно полностью покрыло область

Подробное описание методов
- getWidth
```
public final double getWidth()
```
  Ширина области внутри области, где должно отображаться связанное BackgroundImage. Если установлено значение AUTO, то widthAsPercentage игнорируется. Это значение не имеет смысла, если указаны либо contain, либо cover. Это значение не может быть отрицательным, за исключением случаев, когда установлено значение AUTO.
  
  Возвращает:
  
  ширина области внутри области, где должно отображаться связанное BackgroundImage
- getHeight
```
public final double getHeight()
```
  Высота области внутри области, где должно отображаться связанное BackgroundImage. Если установлено значение AUTO, то heightAsPercentage игнорируется. Это значение не имеет смысла, если указаны либо contain, либо cover. Это значение не может быть отрицательным, за исключением случаев, когда установлено значение AUTO.
  
  Возвращает:
  
  высота области внутри области, где должно отображаться связанное BackgroundImage
- isWidthAsPercentage
```
public final boolean isWidthAsPercentage()
```
  Указывает, должно ли значение, содержащееся в width, интерпретироваться как процентное или как обычное значение.
  
  Возвращает:
  
  true, если ширина должна интерпретироваться как процент
- isHeightAsPercentage
```
public final boolean isHeightAsPercentage()
```
  Указывает, должно ли значение, содержащееся в height, интерпретироваться как процентное или как обычное значение.
  
  Возвращает:
  
  true, если высота должна интерпретироваться как процент
- isContain
```
public final boolean isContain()
```
  Если true, масштабирует изображение, сохраняя его собственное соотношение сторон (если таковое имеется), до наибольшего размера, при котором и ширина, и высота могут поместиться внутри области позиционирования фона.
  
  Возвращает:
  
  true, если изображение может поместиться внутри области позиционирования фона
- isCover
```
public final boolean isCover()
```
  Если true, масштабирует изображение, сохраняя его собственное соотношение сторон (если таковое имеется), до наименьшего размера, при котором и ширина, и высота могут полностью покрыть область позиционирования фона.
  
  Возвращает:
  
  true, если изображение может полностью покрыть область позиционирования фона
- equals
```
public boolean equals(Object o)
```
  Переопределяет:
  
  equals в классе Object
- hashCode
```
public int hashCode()
```
  Переопределяет:
  
  hashCode в классе Object

© 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.

Класс BackgroundSize

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

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

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

Методы, унаследованные от класса java.lang.Object

Подробное описание полей

AUTO

DEFAULT

Подробное описание конструкторов

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

getWidth

getHeight

isWidthAsPercentage

isHeightAsPercentage

isContain

isCover

equals

hashCode