Spec-Zone.ru › OpenJavaFX 11
Модуль javafx.controls
Пакет javafx.scene.control

Класс DialogPane

  • java.lang.Object
    • javafx.scene.Node
      • javafx.scene.Parent
        • javafx.scene.layout.Region
          • javafx.scene.layout.Pane
            • javafx.scene.control.DialogPane
  • Все реализованные интерфейсы:
    Styleable, EventTarget
    @DefaultProperty("buttonTypes")
    public class DialogPane
    extends Pane
    DialogPane следует рассматривать как корневой узел, отображаемый в экземпляре Dialog. В этой роли DialogPane отвечает за размещение headers, graphics, content и buttons. По умолчанию DialogPane (то есть сам класс DialogPane) обрабатывает макет с помощью обычного метода layoutChildren(). Этот метод может быть переопределен подклассами, которые хотят обработать макет альтернативным способом.

    В дополнение к свойствам header и content существуют свойства header text и content text. Способ работы свойств *Text заключается в том, что они имеют более низкий приоритет по сравнению со свойствами Node, но они намного удобнее для разработчиков в общем случае, поскольку, скорее всего, разработчик чаще всего хочет просто установить строковое значение в заголовок или область содержимого DialogPane.

    Важно понимать последствия установки не-null значений в свойства header и headerText. Основные моменты следующие:

    1. Свойство header имеет приоритет над свойством headerText, поэтому, если оба установлены в не-null значения, будет использоваться header, а headerText будет проигнорировано.
    2. Если headerText установлено в не-null значение, и также установлено graphic, то положение графики по умолчанию меняется с расположения слева от области содержимого на расположение справа от текста заголовка.
    3. Если header установлено в не-null значение, и также установлено graphic, графика удаляется из своего положения по умолчанию (слева от области содержимого) и не размещается справа от пользовательского узла заголовка. Если графика требуется, ее необходимо вручную добавить в макет пользовательского узла заголовка.

    DialogPane работает с концепцией ButtonType. ButtonType — это описание отдельной кнопки, которая должна быть визуально представлена в DialogPane. Разработчики, создающие DialogPane, должны указать типы кнопок, которые они хотят отобразить, и это делается через метод getButtonTypes(), который возвращает изменяемый ObservableList, который пользователи могут добавлять и удалять по своему усмотрению.

    Класс ButtonType определяет ряд предопределённых типов кнопок, таких как ButtonType.OK и ButtonType.CANCEL. Многие пользователи API диалогов JavaFX обнаруживают, что эти предопределённые типы кнопок удовлетворяют их потребностям, особенно благодаря встроенной поддержке кнопок default и cancel, а также преимуществу перевода строк на все языки, поддерживаемые JavaFX. Для пользователей, которые хотят определить свои собственные ButtonType (чаще всего для определения кнопки с пользовательским текстом), они могут сделать это с помощью конструкторов, доступных в классе ButtonType.

    Разработчики быстро поймут, что возможности настройки с помощью класса ButtonType минимальны. Это намеренно, но не означает, что разработчики не могут изменять кнопки, созданные с помощью ButtonType, которые были указаны. Для этого разработчики просто вызывают метод lookupButton(ButtonType) с ButtonType (предполагая, что он уже был установлен в списке getButtonTypes()). Возвращаемый узел обычно имеет тип Button, но это зависит от того, был ли переопределен метод createButton(ButtonType).

    Класс DialogPane предлагает несколько методов, которые могут быть переопределены подклассами для более удобной настройки функциональности. Эти методы включают в себя:

    • createButton(ButtonType)
    • createDetailsButton()
    • createButtonBar()

    Эти методы задокументированы, поэтому обратите внимание на ожидания, предъявляемые к любому разработчику, который хочет переопределить эти методы своей функциональностью.

    Since:
    JavaFX 8u40
    См. также:
    Dialog
  • Краткое описание свойств

    Свойства
    Тип Свойство Описание
    ObjectProperty<Node> content
    Свойство, представляющее область содержимого диалога.
    StringProperty contentText
    Свойство, представляющее текст содержимого для диалогового окна.
    ObjectProperty<Node> expandableContent
    Свойство, представляющее область расширяемого содержимого диалога.
    BooleanProperty expanded
    Представляет, расширено ли диалоговое окно.
    ObjectProperty<Node> graphic
    Графика диалога, представленная либо в заголовке, если он отображается, либо слева от content.
    ObjectProperty<Node> header
    Свойство, представляющее область заголовка диалогового окна.
    StringProperty headerText
    Свойство, представляющее текст заголовка диалогового окна.
    • Свойства унаследованные от класса javafx.scene.layout.Region

      background, border, cacheShape, centerShape, height, insets, maxHeight, maxWidth, minHeight, minWidth, opaqueInsets, padding, prefHeight, prefWidth, scaleShape, shape, snapToPixel, width
    • Свойства унаследованные от класса javafx.scene.Parent

      needsLayout
    • Свойства унаследованные от класса 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
  • Краткое описание полей

    • Поля унаследованные от класса javafx.scene.layout.Region

      USE_COMPUTED_SIZE, USE_PREF_SIZE
    • Поля унаследованные от класса javafx.scene.Node

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

    Конструкторы
    Конструктор Описание
    DialogPane()
    Создаёт новый экземпляр DialogPane со стилем класса 'dialog-pane'.
  • Краткое описание методов

    Все методыСтатические методыМетоды экземпляраКонкретные методы
    Модификатор и тип Метод Описание
    protected double computeMinHeight​(double width)
    Вычисляет минимальную высоту этого региона.
    protected double computeMinWidth​(double height)
    Вычисляет минимальную ширину этого региона.
    protected double computePrefHeight​(double width)
    Вычисляет предпочтительную высоту этого региона для заданной ширины; Подклассы Region должны переопределять этот метод, чтобы возвращать соответствующее значение на основе их содержимого и стратегии макета.
    protected double computePrefWidth​(double height)
    Вычисляет предпочтительную ширину этого региона для заданной высоты.
    ObjectProperty<Node> contentProperty()
    Свойство, представляющее область содержимого диалогового окна.
    StringProperty contentTextProperty()
    Свойство, представляющее текст содержимого для области диалогового окна.
    protected Node createButton​(ButtonType buttonType)
    Этот метод может быть переопределен подклассами для создания пользовательской кнопки, которая впоследствии будет вставлена ​​в область кнопок DialogPane (созданная методом createButtonBar()), но чаще всего это экземпляр ButtonBar.
    protected Node createButtonBar()
    Этот метод может быть переопределён подклассами для предоставления панели кнопок.
    protected Node createDetailsButton()
    Этот метод может быть переопределен подклассами для создания пользовательской кнопки деталей.
    ObjectProperty<Node> expandableContentProperty()
    Свойство, представляющее область расширяемого содержимого диалогового окна.
    BooleanProperty expandedProperty()
    Представляет, расширено ли диалоговое окно.
    ObservableList<ButtonType> getButtonTypes()
    Наблюдаемый список типов кнопок, используемых для области панели кнопок диалогового окна (созданной методом createButtonBar()).
    static List<CssMetaData<? extends Styleable,​?>> getClassCssMetaData()
    Node getContent()
    Возвращает содержимое диалогового окна как узел (даже если оно было задано в виде строки с помощью setContentText(String) - это было просто преобразовано в Node (скорее всего, Label).
    String getContentText()
    Возвращает текущий установленный текст содержимого для этого DialogPane.
    List<CssMetaData<? extends Styleable,​?>> getCssMetaData()
    Этот метод должен делегировать Node.getClassCssMetaData(), чтобы можно было получить доступ к CssMetaData узла без необходимости рефлексии.
    Node getExpandableContent()
    Возвращает узел расширяемого содержимого диалогового окна, если он задан, или null в противном случае.
    Node getGraphic()
    Получает значение свойства graphic.
    Node getHeader()
    Узел, который выступает в качестве заголовка области диалогового окна.
    String getHeaderText()
    Возвращает текущий установленный текст заголовка для этого DialogPane.
    ObjectProperty<Node> graphicProperty()
    Графика диалогового окна, представленная либо в заголовке, если он отображается, либо слева от content.
    ObjectProperty<Node> headerProperty()
    Свойство, представляющее область заголовка панели диалогового окна.
    StringProperty headerTextProperty()
    Свойство, представляющее текст заголовка для панели диалогового окна.
    boolean isExpanded()
    Возвращает, расширено ли диалоговое окно.
    protected void layoutChildren()
    Вызывается во время прохода макета для размещения дочерних элементов в этом Parent.
    Node lookupButton​(ButtonType buttonType)
    Этот метод предоставляет способ, с помощью которого разработчики могут получить фактический узел для заданного ButtonType (при условии, что он входит в список button types).
    void setContent​(Node content)
    Назначение содержимого диалога.
    void setContentText​(String contentText)
    Устанавливает строку для отображения в области содержимого диалога.
    void setExpandableContent​(Node content)
    Устанавливает узел расширяемого содержимого диалогового окна, или null, если расширяемое содержимое отображать не нужно.
    void setExpanded​(boolean value)
    Устанавливает, расширено ли диалоговое окно.
    void setGraphic​(Node graphic)
    Устанавливает графику диалога, которая будет отображаться либо в заголовке, если он отображается, либо слева от content.
    void setHeader​(Node header)
    Назначает заголовок панели диалогового окна.
    void setHeaderText​(String headerText)
    Устанавливает строку для отображения в области заголовка диалогового окна.
    • Методы, унаследованные от класса javafx.scene.layout.Pane

      getChildren
    • Методы, унаследованные от класса javafx.scene.layout.Region

      backgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, computeMaxHeight, computeMaxWidth, getBackground, getBorder, getHeight, getInsets, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getOpaqueInsets, getPadding, getPrefHeight, getPrefWidth, getShape, getUserAgentStylesheet, getWidth, heightProperty, insetsProperty, isCacheShape, isCenterShape, isResizable, isScaleShape, isSnapToPixel, layoutInArea, layoutInArea, layoutInArea, layoutInArea, maxHeight, maxHeightProperty, maxWidth, maxWidthProperty, minHeight, minHeightProperty, minWidth, minWidthProperty, opaqueInsetsProperty, paddingProperty, positionInArea, positionInArea, prefHeight, prefHeightProperty, prefWidth, prefWidthProperty, resize, scaleShapeProperty, setBackground, setBorder, setCacheShape, setCenterShape, setHeight, setMaxHeight, setMaxSize, setMaxWidth, setMinHeight, setMinSize, setMinWidth, setOpaqueInsets, setPadding, setPrefHeight, setPrefSize, setPrefWidth, setScaleShape, setShape, setSnapToPixel, setWidth, shapeProperty, snappedBottomInset, snappedLeftInset, snappedRightInset, snappedTopInset, snapPosition, snapPositionX, snapPositionY, snapSize, snapSizeX, snapSizeY, snapSpace, snapSpaceX, snapSpaceY, snapToPixelProperty, widthProperty
    • Методы, унаследованные от класса javafx.scene.Parent

      getBaselineOffset, getChildrenUnmodifiable, getManagedChildren, getStylesheets, isNeedsLayout, layout, lookup, needsLayoutProperty, queryAccessibleAttribute, requestLayout, requestParentLayout, setNeedsLayout, updateBounds
    • Методы, унаследованные от класса 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, 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, isHover, isManaged, isMouseTransparent, isPickOnBounds, isPressed, 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, lookupAll, managedProperty, 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, pressedProperty, pseudoClassStateChanged, relocate, removeEventFilter, removeEventHandler, requestFocus, 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
  • Подробное описание свойств

    • graphic

      public final ObjectProperty<Node> graphicProperty
      Графика диалога, отображаемая либо в заголовке, если он отображается, либо слева от content.
      См. также:
      getGraphic(), setGraphic(Node)
    • header

      public final ObjectProperty<Node> headerProperty
      Свойство, представляющее область заголовка диалогового окна. Обратите внимание, что если этот заголовок задан отличным от null значением, он займёт всю верхнюю область DialogPane. Это также приведёт к изменению макета DialogPane на макет 'header' — как указано в документации к классу DialogPane.
      См. также:
      getHeader(), setHeader(Node)
    • headerText

      public final StringProperty headerTextProperty
      Свойство, представляющее текст заголовка диалогового окна. Текст заголовка имеет меньший приоритет, чем header node, то есть, если установлены оба свойства — узел заголовка и headerText, текст заголовка не будет отображаться в экземпляре DialogPane по умолчанию.

      Когда headerText установлено в значение, отличное от null, это приведёт к изменению макета DialogPane на макет 'header' — как указано в документации к классу DialogPane.

      См. также:
      getHeaderText(), setHeaderText(String)
    • content

      public final ObjectProperty<Node> contentProperty
      Свойство, представляющее область содержимого диалогового окна.
      См. также:
      getContent(), setContent(Node)
    • contentText

      public final StringProperty contentTextProperty
      Свойство, представляющее текст содержимого диалогового окна. Текст содержимого имеет меньший приоритет, чем content node, то есть, если установлены оба свойства — узел содержимого и contentText, текст содержимого не будет отображаться в экземпляре DialogPane по умолчанию.
      См. также:
      getContentText(), setContentText(String)
    • expandableContent

      public final ObjectProperty<Node> expandableContentProperty
      Свойство, представляющее область расширяемого содержимого диалогового окна. Любой узел может быть размещён в этой области, но он будет отображаться только при нажатии пользователем кнопки «Показать подробности». Эта кнопка будет добавлена автоматически, если свойство expandableContent имеет значение, отличное от null.
      См. также:
      getExpandableContent(), setExpandableContent(Node)
    • expanded

      public final BooleanProperty expandedProperty
      Представляет, расширено ли диалоговое окно.
      См. также:
      isExpanded(), setExpanded(boolean)
  • Подробное описание конструкторов

    • DialogPane

      public DialogPane()
      Создаёт новый экземпляр DialogPane со стилизованным классом 'dialog-pane'.
  • Подробное описание методов

    • graphicProperty

      public final ObjectProperty<Node> graphicProperty()
      Графика диалога, отображаемая либо в заголовке, если он отображается, либо слева от content.
      См. также:
      getGraphic(), setGraphic(Node)
    • getGraphic

      public final Node getGraphic()
      Получает значение свойства graphic.
      Описание свойства:
      Графика диалога, отображаемая либо в заголовке, если он отображается, либо слева от content.
    • setGraphic

      public final void setGraphic​(Node graphic)
      Устанавливает графику диалога, которая будет отображаться либо в заголовке, если он отображается, либо слева от content.
      Параметры:
      graphic - Новая графика диалога или null, если графика не должна отображаться.
    • getHeader

      public final Node getHeader()
      Узел, который действует как заголовок панели диалога.
      Возвращает:
      заголовок панели диалога.
    • setHeader

      public final void setHeader​(Node header)
      Назначает заголовок панели диалога. Может использоваться любой узел.
      Параметры:
      header - Новый заголовок DialogPane.
    • headerProperty

      public final ObjectProperty<Node> headerProperty()
      Свойство, представляющее область заголовка панели диалога. Обратите внимание, что если этот заголовок установлен в значение, отличное от null, он займет всю верхнюю область DialogPane. Это также приведет к переключению макета DialogPane на макет «заголовок» — как описано в документации к классу DialogPane.
      См. также:
      getHeader(), setHeader(Node)
    • setHeaderText

      public final void setHeaderText​(String headerText)
      Устанавливает строку для отображения в области заголовка диалога. Обратите внимание, что текст заголовка имеет меньший приоритет, чем header node, что означает, что если установлены и узел заголовка, и свойства headerText, текст заголовка не будет отображаться в стандартном экземпляре DialogPane.

      При установке headerText в ненулевое значение это приведет к переключению макета DialogPane на макет «заголовок» — как описано в документации к классу DialogPane.

      Параметры:
      headerText - строка для отображения в области заголовка диалога
    • getHeaderText

      public final String getHeaderText()
      Возвращает текущий текст заголовка для этого DialogPane.
      Возвращает:
      текущий текст заголовка для этого DialogPane
    • headerTextProperty

      public final StringProperty headerTextProperty()
      Свойство, представляющее текст заголовка для панели диалога. Текст заголовка имеет меньший приоритет, чем header node, что означает, что если установлены и узел заголовка, и свойства headerText, текст заголовка не будет отображаться в стандартном экземпляре DialogPane.

      При установке headerText в ненулевое значение это приведет к переключению макета DialogPane на макет «заголовок» — как описано в документации к классу DialogPane.

      См. также:
      getHeaderText(), setHeaderText(String)
    • getContent

      public final Node getContent()
      Возвращает содержимое диалога в виде узла (даже если оно было установлено как строка с помощью setContentText(String) — это просто преобразуется в Node (вероятно, в Label).
      Возвращает:
      содержимое диалога
    • setContent

      public final void setContent​(Node content)
      Назначает содержимое диалога. Может использоваться любой узел.
      Параметры:
      content - содержимое диалога
    • contentProperty

      public final ObjectProperty<Node> contentProperty()
      Свойство, представляющее область содержимого диалога.
      См. также:
      getContent(), setContent(Node)
    • setContentText

      public final void setContentText​(String contentText)
      Устанавливает строку для отображения в области содержимого диалога. Обратите внимание, что текст содержимого имеет меньший приоритет, чем content node, что означает, что если установлены и узел содержимого, и свойства contentText, текст содержимого не будет отображаться в стандартном экземпляре DialogPane.
      Параметры:
      contentText - строка для отображения в области содержимого диалога
    • getContentText

      public final String getContentText()
      Возвращает текущий текст содержимого для этого DialogPane.
      Возвращает:
      текущий текст содержимого для этого DialogPane
    • contentTextProperty

      public final StringProperty contentTextProperty()
      Свойство, представляющее текст содержимого для панели диалога. Текст содержимого имеет меньший приоритет, чем content node, что означает, что если установлены и узел содержимого, и свойства contentText, текст содержимого не будет отображаться в стандартном экземпляре DialogPane.
      См. также:
      getContentText(), setContentText(String)
    • expandableContentProperty

      public final ObjectProperty<Node> expandableContentProperty()
      Свойство, представляющее область расширяемого содержимого диалога. В эту область можно поместить любой узел, но он будет отображаться только при нажатии пользователем кнопки «Показать детали» для расширения. Эта кнопка будет автоматически добавлена, когда свойство расширяемого содержимого не равно null.
      См. также:
      getExpandableContent(), setExpandableContent(Node)
    • getExpandableContent

      public final Node getExpandableContent()
      Возвращает узел расширяемого содержимого диалога, если он установлен, или null в противном случае.
      Возвращает:
      узел расширяемого содержимого диалога
    • setExpandableContent

      public final void setExpandableContent​(Node content)
      Устанавливает узел расширяемого содержимого диалога или null, если расширяемое содержимое не должно отображаться.
      Параметры:
      content - узел расширяемого содержимого диалога
    • expandedProperty

      public final BooleanProperty expandedProperty()
      Представляет, расширена ли панель диалога.
      См. также:
      isExpanded(), setExpanded(boolean)
    • isExpanded

      public final boolean isExpanded()
      Возвращает значение, указывающее, расширена ли панель диалога.
      Возвращает:
      true, если панель диалога расширена.
    • setExpanded

      public final void setExpanded​(boolean value)
      Устанавливает, расширена ли панель диалога. Это имеет смысл только в том случае, если свойство expandable content содержит содержимое для показа.
      Параметры:
      value - true, если панель диалога должна быть расширена.
    • getButtonTypes

      public final ObservableList<ButtonType> getButtonTypes()
      Наблюдаемый список типов кнопок, используемых для области панели кнопок диалога (созданной методом createButtonBar()). Изменение содержимого этого списка немедленно изменит отображаемые пользователю кнопки на панели диалога.
      Возвращает:
      Список ObservableList доступных пользователю button types.
    • lookupButton

      public final Node lookupButton​(ButtonType buttonType)
      Этот метод предоставляет разработчикам способ извлечения фактического узла для заданного ButtonType (предполагая, что он является частью списка button types).
      Параметры:
      buttonType - ButtonType, для которого запрашивается представление узла.
      Возвращает:
      Узел, используемый для представления типа кнопки, созданный методом createButton(ButtonType), и только если тип кнопки является частью списка button types, в противном случае null.
    • createButtonBar

      protected Node createButtonBar()
      Этот метод может быть переопределён подклассами для предоставления панели кнопок. Обратите внимание, что переопределяя этот метод, разработчик берёт на себя несколько задач:
      1. Разработчик должен немедленно пройтись по всем button types и вызвать createButton(ButtonType) для каждого из них по очереди.
      2. Разработчик должен добавить слушатель к списку button types и при изменении этого списка обновить панель кнопок соответствующим образом.
      3. Аналогично, разработчик должен следить за изменениями свойства expandable content, добавляя и удаляя кнопку деталей (созданную методом createDetailsButton()).

      По умолчанию этот метод создаёт и возвращает новый экземпляр ButtonBar.

      Возвращает:
      созданную панель кнопок
    • createButton

      protected Node createButton​(ButtonType buttonType)
      Этот метод может быть переопределён подклассами для создания настраиваемой кнопки, которая впоследствии будет вставлена в область кнопок DialogPane (созданную методом createButtonBar()), но чаще всего это экземпляр ButtonBar.
      Параметры:
      buttonType - ButtonType для создания кнопки из.
      Возвращает:
      JavaFX Node, представляющий заданный ButtonType, чаще всего экземпляр Button.
    • createDetailsButton

      protected Node createDetailsButton()
      Этот метод может быть переопределён подклассами для создания настраиваемой кнопки деталей.

      Для переопределения этого метода нужно сделать две вещи:

      1. Кнопка должна иметь свой собственный код для обработки взаимодействия с мышкой/клавиатурой и переключения состояния свойства expanded.
      2. Если визуальные эффекты вашей кнопки изменяются в зависимости от того, развернута или свернута область диалогового окна, добавьте слушатель к свойству expanded, чтобы обновить визуальные эффекты кнопки.
      Возвращает:
      созданную кнопку деталей
    • layoutChildren

      protected void layoutChildren()
      Вызывается во время прохода по макетированию для расположения дочерних элементов в этом Parent. По умолчанию он устанавливает размер управляемого, масштабируемого содержимого до их предпочтительных размеров и не выполняет позиционирование узлов.

      Подклассы должны переопределять эту функцию для макетирования содержимого по мере необходимости.

      Переопределяет:
      layoutChildren в классе Parent
    • computeMinWidth

      protected double computeMinWidth​(double height)
      Вычисляет минимальную ширину этого региона. По умолчанию возвращает сумму левых и правых отступов. Подклассы Region должны переопределять этот метод, чтобы вернуть соответствующее значение, основанное на их содержимом и стратегии макетирования. Если у подкласса нет вертикальной ориентации содержимого, то параметр высоты можно игнорировать.
      Переопределяет:
      computeMinWidth в классе Region
      Параметры:
      height - высота, которая должна быть использована, если минимальная ширина зависит от неё
      Возвращает:
      вычисленная минимальная ширина этого региона
    • computeMinHeight

      protected double computeMinHeight​(double width)
      Вычисляет минимальную высоту этого региона. По умолчанию возвращает сумму верхних и нижних отступов. Подклассы Region должны переопределять этот метод, чтобы вернуть соответствующее значение, основанное на их содержимом и стратегии макетирования. Если у подкласса нет горизонтальной ориентации содержимого, то параметр ширины можно игнорировать.
      Переопределяет:
      computeMinHeight в классе Region
      Параметры:
      width - ширина, которая должна быть использована, если минимальная высота зависит от неё
      Возвращает:
      вычисленная минимальная высота этого региона
    • computePrefWidth

      protected double computePrefWidth​(double height)
      Вычисляет предпочтительную ширину этого региона для заданной высоты. Подклассы Region должны переопределять этот метод, чтобы вернуть соответствующее значение, основанное на их содержимом и стратегии макетирования. Если у подкласса нет вертикальной ориентации содержимого, то параметр высоты можно игнорировать.
      Переопределяет:
      computePrefWidth в классе Region
      Параметры:
      height - высота, которая должна быть использована, если предпочтительная ширина зависит от неё
      Возвращает:
      вычисленная предпочтительная ширина этого региона
    • computePrefHeight

      protected double computePrefHeight​(double width)
      Вычисляет предпочтительную высоту этого региона для заданной ширины; Подклассы Region должны переопределять этот метод, чтобы вернуть соответствующее значение, основанное на их содержимом и стратегии макетирования. Если у подкласса нет горизонтальной ориентации содержимого, то параметр ширины можно игнорировать.
      Переопределяет:
      computePrefHeight в классе Region
      Параметры:
      width - ширина, которая должна быть использована, если предпочтительная высота зависит от неё
      Возвращает:
      вычисленная предпочтительная высота этого региона
    • getClassCssMetaData

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

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

© 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