Spec-Zone.ru › OpenJavaFX 24

Класс ImageView

java.lang.Object
javafx.scene.Node
javafx.scene.image.ImageView
Все реализуемые интерфейсы:
Styleable, EventTarget
@DefaultProperty("image") public non-sealed class ImageView extends Node
Класс `ImageView` — это виджет, используемый для отображения изображений, загруженных с помощью класса Image.

Этот класс позволяет изменять размер отображаемого изображения (с сохранением или без сохранения исходного соотношения сторон) и указывать область просмотра в исходном изображении для ограничения отображаемых пикселей этим виджетом.

Пример кода для отображения изображений


 import javafx.application.Application;
 import javafx.geometry.Rectangle2D;
 import javafx.scene.Group;
 import javafx.scene.Scene;
 import javafx.scene.image.Image;
 import javafx.scene.image.ImageView;
 import javafx.scene.layout.HBox;
 import javafx.scene.paint.Color;
 import javafx.stage.Stage;

 public class HelloImageView extends Application {

     @Override public void start(Stage stage) {
         // load the image
         Image image = new Image("flower.png");

         // simple displays ImageView the image as is
         ImageView iv1 = new ImageView();
         iv1.setImage(image);

         // resizes the image to have width of 100 while preserving the ratio and using
         // higher quality filtering method; this ImageView is also cached to
         // improve performance
         ImageView iv2 = new ImageView();
         iv2.setImage(image);
         iv2.setFitWidth(100);
         iv2.setPreserveRatio(true);
         iv2.setSmooth(true);
         iv2.setCache(true);

         // defines a viewport into the source image (achieving a "zoom" effect) and
         // displays it rotated
         ImageView iv3 = new ImageView();
         iv3.setImage(image);
         Rectangle2D viewportRect = new Rectangle2D(40, 35, 110, 110);
         iv3.setViewport(viewportRect);
         iv3.setRotate(90);

         Group root = new Group();
         Scene scene = new Scene(root);
         scene.setFill(Color.BLACK);
         HBox box = new HBox();
         box.getChildren().add(iv1);
         box.getChildren().add(iv2);
         box.getChildren().add(iv3);
         root.getChildren().add(box);

         stage.setTitle("ImageView");
         stage.setWidth(415);
         stage.setHeight(200);
         stage.setScene(scene);
         stage.sizeToScene();
         stage.show();
     }

     public static void main(String[] args) {
         Application.launch(args);
     }
 }
 

Приведенный выше код создаст следующее:

A visual rendering of the ImageView example

С момента:
JavaFX 2.0

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

Тип Свойство Описание
final DoubleProperty fitHeight
Высота ограничивающей области, в которой исходное изображение масштабируется для подгонки.
final DoubleProperty fitWidth
Ширина ограничивающей области, в которой исходное изображение масштабируется для подгонки.
final ObjectProperty<Image> image
Изображение `Image` для отображения этим виджетом.
final BooleanProperty preserveRatio
Указывает, нужно ли сохранять соотношение сторон исходного изображения при масштабировании для подгонки изображения к ограничивающей области.
final BooleanProperty smooth
Указывает, использовать ли алгоритм обработки с лучшим качеством или более быстрый алгоритм при преобразовании или масштабировании исходного изображения для подгонки к ограничивающей области, заданной fitWidth и fitHeight.
final ObjectProperty<Rectangle2D> viewport
Прямоугольная область просмотра в изображении.
final DoubleProperty x
Текущая координата x начала координат области просмотра.
final DoubleProperty y
Текущая координата y начала координат области просмотра.

Свойства, объявленные в классе javafx.scene.Node

accessibleHelp, accessibleRoleDescription, accessibleRole, accessibleText, blendMode, boundsInLocal, boundsInParent, cacheHint, cache, clip, cursor, depthTest, disabled, disable, effectiveNodeOrientation, effect, eventDispatcher, focused, focusTraversable, focusVisible, focusWithin, hover, id, inputMethodRequests, layoutBounds, layoutX, layoutY, localToParentTransform, localToSceneTransform, managed, mouseTransparent, nodeOrientation, onContextMenuRequested, onDragDetected, onDragDone, onDragDropped, onDragEntered, onDragExited, onDragOver, onInputMethodTextChanged, onKeyPressed, onKeyReleased, onKeyTyped, onMouseClicked, onMouseDragEntered, onMouseDragExited, onMouseDragged, onMouseDragOver, onMouseDragReleased, onMouseEntered, onMouseExited, onMouseMoved, onMousePressed, onMouseReleased, onRotate, onRotationFinished, onRotationStarted, onScrollFinished, onScroll, onScrollStarted, onSwipeDown, onSwipeLeft, onSwipeRight, onSwipeUp, onTouchMoved, onTouchPressed, onTouchReleased, onTouchStationary, onZoomFinished, onZoom, onZoomStarted, opacity, parent, pickOnBounds, pressed, rotate, rotationAxis, scaleX, scaleY, scaleZ, scene, style, translateX, translateY, translateZ, viewOrder, visible

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

Модификатор и тип Поле Описание
static final boolean SMOOTH_DEFAULT
Зависимая от платформы, стандартное значение свойства smooth.

Поля, объявленные в классе javafx.scene.Node

BASELINE_OFFSET_SAME_AS_HEIGHT

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

Конструктор Описание
ImageView()
Создаёт новый объект `ImageView`.
ImageView(String url)
Создаёт новый объект `ImageView` с изображением, загруженным из указанного URL.
ImageView(Image image)
Создаёт новый объект `ImageView` с заданным изображением.

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

Модификатор и тип Метод Описание
final DoubleProperty fitHeightProperty()
Высота ограничивающей области, в которой исходное изображение масштабируется для подгонки.
final DoubleProperty fitWidthProperty()
Ширина ограничивающей области, в которой исходное изображение масштабируется для подгонки.
static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()
Получает `CssMetaData` для данного класса, включающего `CssMetaData` его суперклассов.
List<CssMetaData<? extends Styleable,?>> getCssMetaData()
Этот метод должен делегировать вызов Node.getClassCssMetaData(), чтобы получить доступ к `CssMetaData` узла без рефлексии.
final double getFitHeight()
Получает значение свойства fitHeight.
final double getFitWidth()
Получает значение свойства fitWidth.
final Image getImage()
Получает значение свойства image.
final Rectangle2D getViewport()
Получает значение свойства viewport.
final double getX()
Получает значение свойства x.
final double getY()
Получает значение свойства y.
final ObjectProperty<Image> imageProperty()
Изображение `Image` для отображения этим виджетом.
final boolean isPreserveRatio()
Получает значение свойства preserveRatio.
final boolean isSmooth()
Получает значение свойства smooth.
final BooleanProperty preserveRatioProperty()
Указывает, нужно ли сохранять соотношение сторон исходного изображения при масштабировании для подгонки изображения к ограничивающей области.
final void setFitHeight(double value)
Устанавливает значение свойства fitHeight.
final void setFitWidth(double value)
Устанавливает значение свойства fitWidth.
final void setImage(Image value)
Устанавливает значение свойства image.
final void setPreserveRatio(boolean value)
Устанавливает значение свойства preserveRatio.
final void setSmooth(boolean value)
Устанавливает значение свойства smooth.
final void setViewport(Rectangle2D value)
Устанавливает значение свойства viewport.
final void setX(double value)
Устанавливает значение свойства x.
final void setY(double value)
Устанавливает значение свойства y.
final BooleanProperty smoothProperty()
Указывает, использовать ли алгоритм обработки с лучшим качеством или более быстрый алгоритм при преобразовании или масштабировании исходного изображения для подгонки к ограничивающей области, заданной fitWidth и fitHeight.
final ObjectProperty<Rectangle2D> viewportProperty()
Прямоугольная область просмотра в изображении.
final DoubleProperty xProperty()
Текущая координата x начала координат области просмотра.
final DoubleProperty yProperty()
Текущая координата y начала координат области просмотра.

Методы, объявленные в классе javafx.scene.Node

accessibleHelpProperty, accessibleRoleDescriptionProperty, accessibleRoleProperty, accessibleTextProperty, addEventFilter, addEventHandler, applyCss, autosize, blendModeProperty, boundsInLocalProperty, boundsInParentProperty, buildEventDispatchChain, cacheHintProperty, cacheProperty, clipProperty, computeAreaInScreen, contains, contains, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectiveNodeOrientationProperty, effectProperty, eventDispatcherProperty, executeAccessibleAction, fireEvent, focusedProperty, focusTraversableProperty, focusVisibleProperty, focusWithinProperty, getAccessibleHelp, getAccessibleRole, getAccessibleRoleDescription, getAccessibleText, getBaselineOffset, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClip, getContentBias, getCursor, getDepthTest, getEffect, getEffectiveNodeOrientation, getEventDispatcher, getId, getInitialCursor, getInitialFocusTraversable, getInputMethodRequests, getLayoutBounds, getLayoutX, getLayoutY, getLocalToParentTransform, getLocalToSceneTransform, getNodeOrientation, getOnContextMenuRequested, getOnDragDetected, getOnDragDone, getOnDragDropped, getOnDragEntered, getOnDragExited, getOnDragOver, getOnInputMethodTextChanged, getOnKeyPressed, getOnKeyReleased, getOnKeyTyped, getOnMouseClicked, getOnMouseDragEntered, getOnMouseDragExited, getOnMouseDragged, getOnMouseDragOver, getOnMouseDragReleased, getOnMouseEntered, getOnMouseExited, getOnMouseMoved, getOnMousePressed, getOnMouseReleased, getOnRotate, getOnRotationFinished, getOnRotationStarted, getOnScroll, getOnScrollFinished, getOnScrollStarted, getOnSwipeDown, getOnSwipeLeft, getOnSwipeRight, getOnSwipeUp, getOnTouchMoved, getOnTouchPressed, getOnTouchReleased, getOnTouchStationary, getOnZoom, getOnZoomFinished, getOnZoomStarted, getOpacity, getParent, getProperties, getPseudoClassStates, getRotate, getRotationAxis, getScaleX, getScaleY, getScaleZ, getScene, getStyle, getStyleableParent, getStyleClass, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getTypeSelector, getUserData, getViewOrder, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isFocusVisible, isFocusWithin, isHover, isManaged, isMouseTransparent, isPickOnBounds, isPressed, isResizable, isVisible, layoutBoundsProperty, layoutXProperty, layoutYProperty, localToParent, localToParent, localToParent, localToParent, localToParent, localToParentTransformProperty, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToSceneTransformProperty, localToScreen, localToScreen, localToScreen, localToScreen, localToScreen, lookup, lookupAll, managedProperty, maxHeight, maxWidth, minHeight, minWidth, mouseTransparentProperty, nodeOrientationProperty, notifyAccessibleAttributeChanged, onContextMenuRequestedProperty, onDragDetectedProperty, onDragDoneProperty, onDragDroppedProperty, onDragEnteredProperty, onDragExitedProperty, onDragOverProperty, onInputMethodTextChangedProperty, onKeyPressedProperty, onKeyReleasedProperty, onKeyTypedProperty, onMouseClickedProperty, onMouseDragEnteredProperty, onMouseDragExitedProperty, onMouseDraggedProperty, onMouseDragOverProperty, onMouseDragReleasedProperty, onMouseEnteredProperty, onMouseExitedProperty, onMouseMovedProperty, onMousePressedProperty, onMouseReleasedProperty, onRotateProperty, onRotationFinishedProperty, onRotationStartedProperty, onScrollFinishedProperty, onScrollProperty, onScrollStartedProperty, onSwipeDownProperty, onSwipeLeftProperty, onSwipeRightProperty, onSwipeUpProperty, onTouchMovedProperty, onTouchPressedProperty, onTouchReleasedProperty, onTouchStationaryProperty, onZoomFinishedProperty, onZoomProperty, onZoomStartedProperty, opacityProperty, parentProperty, parentToLocal, parentToLocal, parentToLocal, parentToLocal, parentToLocal, pickOnBoundsProperty, prefHeight, prefWidth, pressedProperty, pseudoClassStateChanged, queryAccessibleAttribute, relocate, removeEventFilter, removeEventHandler, requestFocus, requestFocusTraversal, resize, resizeRelocate, rotateProperty, rotationAxisProperty, scaleXProperty, scaleYProperty, scaleZProperty, sceneProperty, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, screenToLocal, screenToLocal, screenToLocal, setAccessibleHelp, setAccessibleRole, setAccessibleRoleDescription, setAccessibleText, setBlendMode, setCache, setCacheHint, setClip, setCursor, setDepthTest, setDisable, setDisabled, setEffect, setEventDispatcher, setEventHandler, setFocused, setFocusTraversable, setHover, setId, setInputMethodRequests, setLayoutX, setLayoutY, setManaged, setMouseTransparent, setNodeOrientation, setOnContextMenuRequested, setOnDragDetected, setOnDragDone, setOnDragDropped, setOnDragEntered, setOnDragExited, setOnDragOver, setOnInputMethodTextChanged, setOnKeyPressed, setOnKeyReleased, setOnKeyTyped, setOnMouseClicked, setOnMouseDragEntered, setOnMouseDragExited, setOnMouseDragged, setOnMouseDragOver, setOnMouseDragReleased, setOnMouseEntered, setOnMouseExited, setOnMouseMoved, setOnMousePressed, setOnMouseReleased, setOnRotate, setOnRotationFinished, setOnRotationStarted, setOnScroll, setOnScrollFinished, setOnScrollStarted, setOnSwipeDown, setOnSwipeLeft, setOnSwipeRight, setOnSwipeUp, setOnTouchMoved, setOnTouchPressed, setOnTouchReleased, setOnTouchStationary, setOnZoom, setOnZoomFinished, setOnZoomStarted, setOpacity, setPickOnBounds, setPressed, setRotate, setRotationAxis, setScaleX, setScaleY, setScaleZ, setStyle, setTranslateX, setTranslateY, setTranslateZ, setUserData, setViewOrder, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, toString, translateXProperty, translateYProperty, translateZProperty, usesMirroring, viewOrderProperty, visibleProperty

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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

getStyleableNode

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

image

public final ObjectProperty<Image> imageProperty
Изображение Image, которое должно быть отображено этим ImageView.
Значение по умолчанию:
null
См. также:
  • getImage()
  • setImage(Image)
  • imageProperty()

x

public final DoubleProperty xProperty
Текущая координата x начала ImageView.
Значение по умолчанию:
0
См. также:
  • getX()
  • setX(double)
  • xProperty()

y

public final DoubleProperty yProperty
Текущая координата y начала ImageView.
Значение по умолчанию:
0
См. также:
  • getY()
  • setY(double)
  • yProperty()

fitWidth

public final DoubleProperty fitWidthProperty
Ширина ограничивающей рамки, в которой исходное изображение масштабируется для соответствия. Если значение равно <= 0, используется внутренняя ширина изображения в качестве fitWidth.

См. preserveRatio для информации о взаимодействии между атрибутами представления изображения: fitWidth, fitHeight и preserveRatio.

Значение по умолчанию:
0
См. также:
  • getFitWidth()
  • setFitWidth(double)
  • fitWidthProperty()

fitHeight

public final DoubleProperty fitHeightProperty
Высота ограничивающей рамки, в которой исходное изображение масштабируется для соответствия. Если значение равно <= 0, используется внутренняя высота изображения в качестве fitHeight.

См. preserveRatio для информации о взаимодействии между атрибутами представления изображения: fitWidth, fitHeight и preserveRatio.

Значение по умолчанию:
0
См. также:
  • getFitHeight()
  • setFitHeight(double)
  • fitHeightProperty()

preserveRatio

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

Если установлено значение true, это повлияет на размеры этого ImageView следующим образом

  • Если задана только fitWidth, высота масштабируется для сохранения соотношения
  • Если задана только fitHeight, ширина масштабируется для сохранения соотношения
  • Если заданы оба значения, оба могут быть отмасштабированы для лучшей подгонки в прямоугольник со сторонами ширина и высота при сохранении исходного соотношения сторон
Если не задано или установлено значение false, это повлияет на размеры этого ImageView следующим образом
  • Если задана только fitWidth, ширина представления изображения масштабируется для соответствия, а высота остается без изменений;
  • Если задана только fitHeight, высота представления изображения масштабируется для соответствия, а высота остается без изменений;
  • Если заданы оба значения, представление изображения масштабируется для соответствия обоим значениям.
Обратите внимание, что размеры этого узла, сообщаемые границами узла, будут равны размеру отмасштабированного изображения и гарантированно будут содержаться в пределах fitWidth x fitHeight ограничивающей рамки.
Значение по умолчанию:
false
См. также:
  • isPreserveRatio()
  • setPreserveRatio(boolean)
  • preserveRatioProperty()

smooth

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

Если установлено значение true, будет использована фильтрация лучшего качества, если установлено значение false, будет использована более быстрая, но менее качественная фильтрация.

Значение по умолчанию зависит от конфигурации платформы.

Значение по умолчанию:
зависит от платформы
См. также:
  • isSmooth()
  • setSmooth(boolean)
  • smoothProperty()

viewport

public final ObjectProperty<Rectangle2D> viewportProperty
Прямоугольный фрагмент изображения. Фрагмент задаётся в координатах изображения до масштабирования или других преобразований.

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

Значение по умолчанию:
null
См. также:
  • getViewport()
  • setViewport(Rectangle2D)
  • viewportProperty()

Подробности поля

SMOOTH_DEFAULT

public static final boolean SMOOTH_DEFAULT
Значение по умолчанию свойства smooth, зависящее от платформы.

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

ImageView

public ImageView()
Выделяет новый объект ImageView.

ImageView

public ImageView(String url)
Выделяет новый объект ImageView с изображением, загруженным из указанного URL.

new ImageView(url) имеет тот же эффект, что и new ImageView(new Image(url)).

Параметры:
url - строка, представляющая URL для загрузки изображения
Исключения:
NullPointerException - если URL равен null
IllegalArgumentException - если URL недействителен или не поддерживается
С тех пор:
JavaFX 2.1

ImageView

public ImageView(Image image)
Выделяет новый объект ImageView, используя заданное изображение.
Параметры:
image - Изображение, которое используется этим ImageView

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

setImage

public final void setImage(Image value)
Устанавливает значение свойства image.
Описание свойства:
Изображение Image, которое должно быть отображено этим ImageView.
Значение по умолчанию:
null
Параметры:
value - значение для свойства image
См. также:
  • getImage()
  • imageProperty()

getImage

public final Image getImage()
Получает значение свойства image.
Описание свойства:
Изображение Image, которое должно быть отображено этим ImageView.
Значение по умолчанию:
null
Возвращает:
значение свойства image
См. также:
  • setImage(Image)
  • imageProperty()

imageProperty

public final ObjectProperty<Image> imageProperty()
Изображение Image, которое должно быть отображено этим ImageView.
Значение по умолчанию:
null
Возвращает:
свойство image
См. также:
  • getImage()
  • setImage(Image)

setX

public final void setX(double value)
Устанавливает значение свойства x.
Описание свойства:
Текущая координата x начала отсчета ImageView.
Значение по умолчанию:
0
Параметры:
value - значение для свойства x
См. также:
  • getX()
  • xProperty()

getX

public final double getX()
Получает значение свойства x.
Описание свойства:
Текущая координата x начала отсчета ImageView.
Значение по умолчанию:
0
Возвращает:
значение свойства x
См. также:
  • setX(double)
  • xProperty()

xProperty

public final DoubleProperty xProperty()
Текущая координата x начала отсчета ImageView.
Значение по умолчанию:
0
Возвращает:
свойство x
См. также:
  • getX()
  • setX(double)

setY

public final void setY(double value)
Устанавливает значение свойства y.
Описание свойства:
Текущая координата y начала отсчета ImageView.
Значение по умолчанию:
0
Параметры:
value - значение для свойства y
См. также:
  • getY()
  • yProperty()

getY

public final double getY()
Получает значение свойства y.
Описание свойства:
Текущая координата y начала отсчета ImageView.
Значение по умолчанию:
0
Возвращает:
значение свойства y
См. также:
  • setY(double)
  • yProperty()

yProperty

public final DoubleProperty yProperty()
Текущая координата y начала отсчета ImageView.
Значение по умолчанию:
0
Возвращает:
свойство y
См. также:
  • getY()
  • setY(double)

setFitWidth

public final void setFitWidth(double value)
Устанавливает значение свойства fitWidth.
Описание свойства:
Ширина ограничивающей рамки, в пределах которой масштабируется исходное изображение для подгонки. Если значение равно или меньше 0, используется внутренняя ширина изображения как fitWidth.

См. preserveRatio для информации о взаимодействии атрибутов представления изображения: fitWidth, fitHeight и preserveRatio.

Значение по умолчанию:
0
Параметры:
value - значение для свойства fitWidth
См. также:
  • getFitWidth()
  • fitWidthProperty()

getFitWidth

public final double getFitWidth()
Получает значение свойства fitWidth.
Описание свойства:
Ширина ограничивающей рамки, в пределах которой масштабируется исходное изображение для подгонки. Если значение равно или меньше 0, используется внутренняя ширина изображения как fitWidth.

См. preserveRatio для информации о взаимодействии атрибутов представления изображения: fitWidth, fitHeight и preserveRatio.

Значение по умолчанию:
0
Возвращает:
значение свойства fitWidth
См. также:
  • setFitWidth(double)
  • fitWidthProperty()

fitWidthProperty

public final DoubleProperty fitWidthProperty()
Ширина ограничивающей рамки, в пределах которой масштабируется исходное изображение для подгонки. Если значение равно или меньше 0, используется внутренняя ширина изображения как fitWidth.

См. preserveRatio для информации о взаимодействии атрибутов представления изображения: fitWidth, fitHeight и preserveRatio.

Значение по умолчанию:
0
Возвращает:
свойство fitWidth
См. также:
  • getFitWidth()
  • setFitWidth(double)

setFitHeight

public final void setFitHeight(double value)
Устанавливает значение свойства fitHeight.
Описание свойства:
Высота ограничивающей рамки, в пределах которой масштабируется исходное изображение для подгонки. Если значение равно или меньше 0, используется внутренняя высота изображения как fitHeight.

См. preserveRatio для информации о взаимодействии атрибутов представления изображения: fitWidth, fitHeight и preserveRatio.

Значение по умолчанию:
0
Параметры:
value - значение для свойства fitHeight
См. также:
  • getFitHeight()
  • fitHeightProperty()

getFitHeight

public final double getFitHeight()
Получает значение свойства fitHeight.
Описание свойства:
Высота ограничивающей рамки, в пределах которой масштабируется исходное изображение для подгонки. Если значение равно или меньше 0, используется внутренняя высота изображения как fitHeight.

См. preserveRatio для информации о взаимодействии атрибутов представления изображения: fitWidth, fitHeight и preserveRatio.

Значение по умолчанию:
0
Возвращает:
значение свойства fitHeight
См. также:
  • setFitHeight(double)
  • fitHeightProperty()

fitHeightProperty

public final DoubleProperty fitHeightProperty()
Высота ограничивающей рамки, в пределах которой масштабируется исходное изображение для подгонки. Если значение равно или меньше 0, используется внутренняя высота изображения как fitHeight.

См. preserveRatio для информации о взаимодействии атрибутов представления изображения: fitWidth, fitHeight и preserveRatio.

Значение по умолчанию:
0
Возвращает:
свойство fitHeight
См. также:
  • getFitHeight()
  • setFitHeight(double)

setPreserveRatio

public final void setPreserveRatio(boolean value)
Устанавливает значение свойства preserveRatio.
Описание свойства:
Указывает, нужно ли сохранять соотношение сторон исходного изображения при масштабировании для подгонки изображения в ограничивающую рамку.

Если установлено true, это влияет на размеры этого ImageView следующим образом

  • Если задана только fitWidth, высота масштабируется для сохранения соотношения
  • Если задана только fitHeight, ширина масштабируется для сохранения соотношения
  • Если заданы оба, оба могут быть масштабированы для наилучшей подгонки в прямоугольник ширина x высота, сохраняя исходное соотношение сторон
Если не установлено или установлено false, это влияет на размеры этого ImageView следующим образом
  • Если задана только fitWidth, ширина представления изображения масштабируется для соответствия, а высота остается неизменной;
  • Если задана только fitHeight, высота представления изображения масштабируется для соответствия, а ширина остается неизменной;
  • Если заданы оба, представление изображения масштабируется для соответствия обоим.
Обратите внимание, что размеры этого узла, указанные границами узла, будут равны размеру масштабированного изображения и гарантированно будут находиться внутри fitWidth x fitHeight ограничивающей рамки.
Значение по умолчанию:
false
Параметры:
value - значение для свойства preserveRatio
См. также:
  • isPreserveRatio()
  • preserveRatioProperty()

isPreserveRatio

public final boolean isPreserveRatio()
Получает значение свойства preserveRatio.
Описание свойства:
Указывает, нужно ли сохранять соотношение сторон исходного изображения при масштабировании для размещения изображения в заданной области.

Если установлено в значение true, это влияет на размеры этого ImageView следующим образом:

  • Если установлено только fitWidth, высота масштабируется для сохранения соотношения
  • Если установлена только fitHeight, ширина масштабируется для сохранения соотношения
  • Если установлены оба значения, они могут быть оба масштабированы для наилучшего соответствия прямоугольнику заданной ширины и высоты, сохраняя при этом исходное соотношение сторон
Если не установлено или установлено в значение false, это влияет на размеры этого ImageView следующим образом:
  • Если установлена только fitWidth, ширина изображения масштабируется для соответствия, а высота остается без изменений;
  • Если установлена только fitHeight, высота изображения масштабируется для соответствия, а ширина остается без изменений;
  • Если установлены оба значения, размер изображения масштабируется для соответствия обеим сторонам.
Обратите внимание, что размеры этого узла, как сообщается границами узла, будут равны размеру масштабированного изображения и гарантированно будут содержаться в fitWidth x fitHeight области.
Значение по умолчанию:
false
Возвращает:
значение свойства preserveRatio
См. также:
  • setPreserveRatio(boolean)
  • preserveRatioProperty()

preserveRatioProperty

public final BooleanProperty preserveRatioProperty()
Указывает, нужно ли сохранять соотношение сторон исходного изображения при масштабировании для размещения изображения в заданной области.

Если установлено в значение true, это влияет на размеры этого ImageView следующим образом:

  • Если установлено только fitWidth, высота масштабируется для сохранения соотношения
  • Если установлена только fitHeight, ширина масштабируется для сохранения соотношения
  • Если установлены оба значения, они могут быть оба масштабированы для наилучшего соответствия прямоугольнику заданной ширины и высоты, сохраняя при этом исходное соотношение сторон
Если не установлено или установлено в значение false, это влияет на размеры этого ImageView следующим образом:
  • Если установлена только fitWidth, ширина изображения масштабируется для соответствия, а высота остается без изменений;
  • Если установлена только fitHeight, высота изображения масштабируется для соответствия, а ширина остается без изменений;
  • Если установлены оба значения, размер изображения масштабируется для соответствия обеим сторонам.
Обратите внимание, что размеры этого узла, как сообщается границами узла, будут равны размеру масштабированного изображения и гарантированно будут содержаться в fitWidth x fitHeight области.
Значение по умолчанию:
false
Возвращает:
свойство preserveRatio
См. также:
  • isPreserveRatio()
  • setPreserveRatio(boolean)

setSmooth

public final void setSmooth(boolean value)
Устанавливает значение свойства smooth.
Описание свойства:
Указывает, использовать ли алгоритм фильтрации лучшего качества или более быстрый при преобразовании или масштабировании исходного изображения для размещения его в области, заданной fitWidth и fitHeight.

Если установлено в значение true, будет использоваться фильтрация лучшего качества, если установлено в false, будет использоваться более быстрая фильтрация, но с меньшим качеством.

Значение по умолчанию зависит от конфигурации платформы.

Значение по умолчанию:
зависит от платформы
Параметры:
value - значение для свойства smooth
См. также:
  • isSmooth()
  • smoothProperty()

isSmooth

public final boolean isSmooth()
Получает значение свойства smooth.
Описание свойства:
Указывает, использовать ли алгоритм фильтрации лучшего качества или более быстрый при преобразовании или масштабировании исходного изображения для размещения его в области, заданной fitWidth и fitHeight.

Если установлено в значение true, будет использоваться фильтрация лучшего качества, если установлено в false, будет использоваться более быстрая фильтрация, но с меньшим качеством.

Значение по умолчанию зависит от конфигурации платформы.

Значение по умолчанию:
зависит от платформы
Возвращает:
значение свойства smooth
См. также:
  • setSmooth(boolean)
  • smoothProperty()

smoothProperty

public final BooleanProperty smoothProperty()
Указывает, использовать ли алгоритм фильтрации лучшего качества или более быстрый при преобразовании или масштабировании исходного изображения для размещения его в области, заданной fitWidth и fitHeight.

Если установлено в значение true, будет использоваться фильтрация лучшего качества, если установлено в false, будет использоваться более быстрая фильтрация, но с меньшим качеством.

Значение по умолчанию зависит от конфигурации платформы.

Значение по умолчанию:
зависит от платформы
Возвращает:
свойство smooth
См. также:
  • isSmooth()
  • setSmooth(boolean)

setViewport

public final void setViewport(Rectangle2D value)
Устанавливает значение свойства viewport.
Описание свойства:
Прямоугольная область просмотра изображения. Область просмотра задается в координатах изображения до масштабирования или других преобразований.

Если viewport равно null, отображается всё изображение. Если viewport не равно null, отображается только часть изображения, попадающая в область просмотра. Если изображение не полностью покрывает область просмотра, остальная часть области просмотра будет пустой.

Значение по умолчанию:
null
Параметры:
value - значение для свойства viewport
См. также:
  • getViewport()
  • viewportProperty()

getViewport

public final Rectangle2D getViewport()
Получает значение свойства viewport.
Описание свойства:
Прямоугольная область просмотра изображения. Область просмотра задается в координатах изображения до масштабирования или других преобразований.

Если viewport равно null, отображается всё изображение. Если viewport не равно null, отображается только часть изображения, попадающая в область просмотра. Если изображение не полностью покрывает область просмотра, остальная часть области просмотра будет пустой.

Значение по умолчанию:
null
Возвращает:
значение свойства viewport
См. также:
  • setViewport(Rectangle2D)
  • viewportProperty()

viewportProperty

public final ObjectProperty<Rectangle2D> viewportProperty()
Прямоугольная область просмотра изображения. Область просмотра задается в координатах изображения до масштабирования или других преобразований.

Если viewport равно null, отображается всё изображение. Если viewport не равно null, отображается только часть изображения, попадающая в область просмотра. Если изображение не полностью покрывает область просмотра, остальная часть области просмотра будет пустой.

Значение по умолчанию:
null
Возвращает:
свойство viewport
См. также:
  • getViewport()
  • setViewport(Rectangle2D)

getClassCssMetaData

public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()
Получает CssMetaData, связанную с этим классом, которая может включать CssMetaData его суперклассов.
Возвращает:
CssMetaData
Since:
JavaFX 8.0

getCssMetaData

public List<CssMetaData<? extends Styleable,?>> getCssMetaData()
Этот метод должен делегировать вызов Node.getClassCssMetaData(), чтобы к CssMetaData узла можно было получить доступ без необходимости рефлексии.
Specified by:
getCssMetaData в интерфейсе Styleable
Overrides:
getCssMetaData в классе Node
Возвращает:
CssMetaData, связанную с этим классом, которая может включать CssMetaData его суперклассов.
Since:
JavaFX 8.0

Отправить сообщение об ошибке или предложить улучшение
Авторские права © 2008, 2025, Oracle и/или его аффилированные лица. Все права защищены.

© 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