Класс BackgroundImage
java.lang.Object
javafx.scene.layout.BackgroundImage
public final class BackgroundImage extends Object
Определяет свойства, описывающие, как отрисовать изображение в качестве фона для некоторого
Region. У BackgroundImage должно быть указано изображение (не может быть null). Свойства repeatX и repeatY определяют, как изображение будет повторяться в каждом направлении. Свойство position определяет, как разместить изображение на области, а свойство size определяет размер изображения на области. Например, size может быть определено с cover = true, что означает, что изображение должно быть растянуто, чтобы покрыть всю область отрисовки области. Поскольку BackgroundImage неизменяем, его можно безопасно использовать в любом кэше и повторно использовать среди нескольких областей.
- С момента:
- JavaFX 8.0
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
BackgroundImage |
Создаёт новый BackgroundImage. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
final Image |
getImage() |
Используемое изображение. |
final BackgroundPosition |
getPosition() |
Положение этого BackgroundImage относительно области. |
final BackgroundRepeat |
getRepeatX() |
Указывает, каким образом (если вообще) изображение фона должно повторяться вдоль оси x области. |
final BackgroundRepeat |
getRepeatY() |
Указывает, каким образом (если вообще) изображение фона должно повторяться вдоль оси y области. |
final BackgroundSize |
getSize() |
Размер этого изображения относительно области. |
Подробное описание конструкторов
BackgroundImage
public BackgroundImage(Image image, BackgroundRepeat repeatX, BackgroundRepeat repeatY, BackgroundPosition position, BackgroundSize size)
Создаёт новый BackgroundImage.
image должно быть указано.- Параметры:
-
image- Используемое изображение. Не может быть null. -
repeatX- BackgroundRepeat для оси x. Если null, по умолчанию используется REPEAT. -
repeatY- BackgroundRepeat для оси y. Если null, по умолчанию используется REPEAT. -
position- Используемое BackgroundPosition. Если null, по умолчанию используется BackgroundPosition.DEFAULT. -
size- BackgroundSize. Если null, по умолчанию используется BackgroundSize.DEFAULT.
Подробное описание методов
getImage
public final Image getImage()
Используемое изображение. Никогда не будет null. Если загрузка этого изображения завершится ошибкой, весь BackgroundImage будет пропущен при отрисовке.
- Возвращает:
- используемое изображение
getRepeatX
public final BackgroundRepeat getRepeatX()
Указывает, каким образом (если вообще) изображение фона должно повторяться вдоль оси x области. Никогда не будет null.
- Возвращает:
- BackgroundRepeat, указывающий, нужно ли повторять изображение фона вдоль оси x области
getRepeatY
public final BackgroundRepeat getRepeatY()
Указывает, каким образом (если вообще) изображение фона должно повторяться вдоль оси y области. Никогда не будет null.
- Возвращает:
- BackgroundRepeat, указывающий, нужно ли повторять изображение фона вдоль оси y области
getPosition
public final BackgroundPosition getPosition()
Положение этого BackgroundImage относительно области. Обратите внимание, что любые позиции за пределами области фона области будут обрезаны.
- Возвращает:
- положение этого BackgroundImage относительно области
getSize
public final BackgroundSize getSize()
Размер этого изображения относительно области.
- Возвращает:
- размер этого изображения относительно области
© 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.