Spec-Zone.ru › OpenJavaFX 21

Класс ImageView

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

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

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


 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, которое должно быть отображено этим ImageView.
final BooleanProperty preserveRatio
Указывает, сохранять ли соотношение сторон исходного изображения при масштабировании для размещения изображения в пределах области обрезки.
final BooleanProperty smooth
Указывает, использовать ли алгоритм фильтрации лучшего качества или более быстрый, при преобразовании или масштабировании исходного изображения для размещения его в пределах области обрезки, предоставленной fitWidth и fitHeight.
final ObjectProperty<Rectangle2D> viewport
Прямоугольная область просмотра изображения.
final DoubleProperty x
Текущая координата x начала ImageView.
final DoubleProperty y
Текущая координата y начала ImageView.

Свойства, объявленные в классе 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 объекта Node без необходимости в рефлексии.
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, которое должно быть отображено этим ImageView.
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 начала ImageView.
final 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, 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, 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 bonding box.
Значение по умолчанию:
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 in interface Styleable
Overrides:
getCssMetaData in class Node
Возвращает:
CssMetaData, связанный с этим классом, который может включать CssMetaData его суперклассов.
Since:
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