Spec-Zone.ru › OpenJavaFX 17

Класс ImageView

java.lang.Object
javafx.scene.Node
javafx.scene.image.ImageView
Все реализованные интерфейсы:
Styleable, EventTarget
@DefaultProperty("image")
public 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

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

Свойства
Тип Свойство Описание
DoubleProperty fitHeight
Высота ограничивающей области, в пределах которой исходное изображение масштабируется для соответствия.
DoubleProperty fitWidth
Ширина ограничивающей области, в пределах которой исходное изображение масштабируется для соответствия.
ObjectProperty<Image> image
Изображение Image, которое должно быть отображено данным компонентом.
BooleanProperty preserveRatio
Указывает, следует ли сохранять соотношение сторон исходного изображения при масштабировании для отображения изображения в заданной ограничивающей области.
BooleanProperty smooth
Указывает, следует ли использовать алгоритм фильтрации с лучшим качеством или более быстрый при преобразовании или масштабировании исходного изображения для соответствия заданной ограничивающей области, заданной свойствами fitWidth и fitHeight.
ObjectProperty<Rectangle2D> viewport
Прямоугольная область просмотра изображения.
DoubleProperty x
Текущая координата x начала области просмотра.
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, 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 boolean SMOOTH_DEFAULT
Платформенно-зависимое значение по умолчанию свойства smooth.

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

BASELINE_OFFSET_SAME_AS_HEIGHT

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

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

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

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

Методы, объявленные в классе 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, 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, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getTypeSelector, getUserData, getViewOrder, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, 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, 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, getStyleClass

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

image

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

x

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

y

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

fitWidth

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

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

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

fitHeight

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

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

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

preserveRatio

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

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

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

smooth

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

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

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

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

viewport

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

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

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

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

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

getImage

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

imageProperty

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

setX

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

getX

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

xProperty

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

setY

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

getY

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

yProperty

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

setFitWidth

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

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

Значение по умолчанию:
0

getFitWidth

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

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

Значение по умолчанию:
0

fitWidthProperty

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

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

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

setFitHeight

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

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

Значение по умолчанию:
0

getFitHeight

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

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

Значение по умолчанию:
0

fitHeightProperty

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

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

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

setPreserveRatio

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

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

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

isPreserveRatio

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

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

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

preserveRatioProperty

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

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

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

setSmooth

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

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

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

Значение по умолчанию:
зависит от платформы

isSmooth

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

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

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

Значение по умолчанию:
зависит от платформы

smoothProperty

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

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

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

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

setViewport

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

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

Значение по умолчанию:
null

getViewport

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

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

Значение по умолчанию:
null

viewportProperty

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

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

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

getClassCssMetaData

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

getCssMetaData

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

© 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