Spec-Zone.ru › OpenJavaFX 8
javafx.scene.layout

Класс 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.

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

    • 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)

      Переопределяет:

      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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API