首页 > 解决方案 > JavaFX:如何将 TitledPane 中的“下拉箭头”移动到右侧

问题描述

我希望每个人都做得很好。

我正在尝试将 TitledPane 中的下拉箭头移动到右侧,而不是默认情况下的左侧。我正在使用 JavaFX 8,我发现的许多资源似乎都不起作用。

我发现我可以将箭头移动一个特定的量,如下图所示的 20 个像素

.accordion .title > .arrow-button .arrow
{
    -fx-translate-x: 20;
}

但我想要一些反应灵敏的东西。有什么方法可以让我获得标题窗格的宽度,然后减去一些像素,以便在调整大小时箭头显示在右侧?有更好的方法吗?如果这很重要,我使用 SceneBuilder2 添加了元素。

非常感谢您的宝贵时间。

编辑:添加以下内容以进行澄清

在此处输入图像描述 在此处输入图像描述

首先,我希望箭头右对齐,如下所示

在此处输入图像描述 在此处输入图像描述

而不仅仅是箭头的“右侧”。我非常感谢所有的帮助。

标签: javajavafxaccordionscenebuilder

解决方案


不幸的是,没有公共 API 可以将箭头移动到TitledPane. 这并不意味着这不能完成,但是,我们只需要使用绑定来动态转换箭头。为了让标题区域的其余部分看起来正确,我们还必须将文本和图形(如果存在)翻译到左侧。完成这一切的最简单方法是继承TitledPaneSkin和访问“标题区域”的内部结构。

这是一个示例实现。它允许您通过 CSS 将箭头定位在左侧或右侧。它还可以响应调整大小以及对齐和图形更改。

package com.example;

import static javafx.css.StyleConverter.getEnumConverter;

import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import java.util.Objects;
import javafx.beans.binding.Bindings;
import javafx.beans.binding.DoubleBinding;
import javafx.beans.property.ObjectProperty;
import javafx.beans.property.Property;
import javafx.css.CssMetaData;
import javafx.css.SimpleStyleableObjectProperty;
import javafx.css.StyleableObjectProperty;
import javafx.css.StyleableProperty;
import javafx.scene.Node;
import javafx.scene.control.Skin;
import javafx.scene.control.TitledPane;
import javafx.scene.control.skin.TitledPaneSkin;
import javafx.scene.layout.Region;
import javafx.scene.text.Text;

public class CustomTitledPaneSkin extends TitledPaneSkin {

    public enum ArrowSide {
        LEFT, RIGHT
    }

    /* ********************************************************
     *                                                        *
     * Properties                                             *
     *                                                        *
     **********************************************************/

    private final StyleableObjectProperty<ArrowSide> arrowSide
            = new SimpleStyleableObjectProperty<>(StyleableProperties.ARROW_SIDE, this, "arrowSide", ArrowSide.LEFT) {
        @Override protected void invalidated() {
            adjustTitleLayout();
        }
    };
    public final void setArrowSide(ArrowSide arrowSide) { this.arrowSide.set(arrowSide); }
    public final ArrowSide getArrowSide() { return arrowSide.get(); }
    public final ObjectProperty<ArrowSide> arrowSideProperty() { return arrowSide; }

    /* ********************************************************
     *                                                        *
     * Instance Fields                                        *
     *                                                        *
     **********************************************************/

    private final Region title;
    private final Region arrow;
    private final Text text;

    private DoubleBinding arrowTranslateBinding;
    private DoubleBinding textGraphicTranslateBinding;
    private Node graphic;

    /* ********************************************************
     *                                                        *
     * Constructors                                           *
     *                                                        *
     **********************************************************/

    public CustomTitledPaneSkin(TitledPane control) {
        super(control);
        title = (Region) Objects.requireNonNull(control.lookup(".title"));
        arrow = (Region) Objects.requireNonNull(title.lookup(".arrow-button"));
        text = (Text) Objects.requireNonNull(title.lookup(".text"));

        registerChangeListener(control.graphicProperty(), ov -> adjustTitleLayout());
    }

    /* ********************************************************
     *                                                        *
     * Skin Stuff                                             *
     *                                                        *
     **********************************************************/

    private void adjustTitleLayout() {
        clearBindings();
        if (getArrowSide() != ArrowSide.RIGHT) {
            // if arrow is on the left we don't need to translate anything
            return;
        }

        arrowTranslateBinding = Bindings.createDoubleBinding(() -> {
            double rightInset = title.getPadding().getRight();
            return title.getWidth() - arrow.getLayoutX() - arrow.getWidth() - rightInset;
        }, title.paddingProperty(), title.widthProperty(), arrow.widthProperty(), arrow.layoutXProperty());
        arrow.translateXProperty().bind(arrowTranslateBinding);

        textGraphicTranslateBinding = Bindings.createDoubleBinding(() -> {
            switch (getSkinnable().getAlignment()) {
                case TOP_CENTER:
                case CENTER:
                case BOTTOM_CENTER:
                case BASELINE_CENTER:
                    return 0.0;
                default:
                    return -(arrow.getWidth());
            }
        }, getSkinnable().alignmentProperty(), arrow.widthProperty());
        text.translateXProperty().bind(textGraphicTranslateBinding);

        graphic = getSkinnable().getGraphic();
        if (graphic != null) {
            graphic.translateXProperty().bind(textGraphicTranslateBinding);
        }
    }

    private void clearBindings() {
        if (arrowTranslateBinding != null) {
            arrow.translateXProperty().unbind();
            arrow.setTranslateX(0);
            arrowTranslateBinding.dispose();
            arrowTranslateBinding = null;
        }
        if (textGraphicTranslateBinding != null) {
            text.translateXProperty().unbind();
            text.setTranslateX(0);
            if (graphic != null) {
                graphic.translateXProperty().unbind();
                graphic.setTranslateX(0);
                graphic = null;
            }
            textGraphicTranslateBinding.dispose();
            textGraphicTranslateBinding = null;
        }
    }

    @Override
    public void dispose() {
        clearBindings();
        unregisterChangeListeners(getSkinnable().graphicProperty());
        super.dispose();
    }

    /* ********************************************************
     *                                                        *
     * Stylesheet Handling                                    *
     *                                                        *
     **********************************************************/

    public static List<CssMetaData<?, ?>> getClassCssMetaData() {
        return StyleableProperties.CSS_META_DATA;
    }

    @Override
    public List<CssMetaData<?, ?>> getCssMetaData() {
        return getClassCssMetaData();
    }

    private static class StyleableProperties {

        private static final CssMetaData<TitledPane, ArrowSide> ARROW_SIDE
                = new CssMetaData<>("-fx-arrow-side", getEnumConverter(ArrowSide.class), ArrowSide.LEFT) {

            @Override
            public boolean isSettable(TitledPane styleable) {
                Property<?> prop = (Property<?>) getStyleableProperty(styleable);
                return prop != null && !prop.isBound();
            }

            @Override
            public StyleableProperty<ArrowSide> getStyleableProperty(TitledPane styleable) {
                Skin<?> skin = styleable.getSkin();
                if (skin instanceof CustomTitledPaneSkin) {
                    return ((CustomTitledPaneSkin) skin).arrowSide;
                }
                return null;
            }

        };

        private static final List<CssMetaData<?, ?>> CSS_META_DATA;

        static {
            List<CssMetaData<?,?>> list = new ArrayList<>(TitledPane.getClassCssMetaData().size() + 1);
            list.addAll(TitledPaneSkin.getClassCssMetaData());
            list.add(ARROW_SIDE);
            CSS_META_DATA = Collections.unmodifiableList(list);
        }

    }

}

TitledPane然后,您可以通过 CSS将此皮肤应用于应用程序中的所有s,如下所示:

.titled-pane {
    -fx-skin: "com.example.CustomTitledPaneSkin";
    -fx-arrow-side: right;
}

/*
 * The arrow button has some right padding that's added
 * by "modena.css". This simply puts the padding on the
 * left since the arrow is positioned on the right.
 */
.titled-pane > .title > .arrow-button {
    -fx-padding: 0.0em 0.0em 0.0em 0.583em;
}

或者您可以TitledPane通过添加样式类并使用所述类而不是.titled-pane.

以上适用于 JavaFX 11,也可能适用于 JavaFX 10 和 9。要让它在 JavaFX 8 上编译,您需要更改一些内容:

  • com.sun.javafx.scene.control.skin.TitledPaneSkin改为导入。

    • 皮肤类在 JavaFX 9 中公开。
  • registerChangeListener(...)删除对和的调用unregisterChangeListeners(...)。我相信用以下内容替换它们是正确的:

    @Override
    protected void handleControlPropertyChange(String p) {
        super.handleControlPropertyChange(p);
        if ("GRAPHIC".equals(p)) {
            adjustTitleLayout();
        }
    }
    
  • 使用new SimpleStyleableObjectProperty<ArrowSide>(...) {...}new CssMetaData<TitledPane, ArrowSide>(...) {...}

    • 类型推断在 Java 的更高版本中得到了改进。
  • 使用(StyleConverter<?, ArrowSide>) getEnumConverter(ArrowSide.class).

    • 通用签名中存在一个错误,该错误getEnumConverter已在更高版本中修复。使用演员表可以解决这个问题。你不妨来@SuppressWarnings("unchecked")选角。

问题:即使进行了上述更改,JavaFX 8 中也存在一个问题——箭头只有在获得TitledPane焦点时才会被翻译。这似乎不是上述代码的问题,因为即使更改alignment属性也不会导致TitledPane更新,直到它具有焦点(即使不使用上述皮肤,而只是使用默认皮肤)。我一直无法找到解决此问题的方法(在使用自定义皮肤时),但也许您或其他人可以。我在测试 JavaFX 8 时使用的是 Java 1.8.0_202。


如果您不想使用自定义皮肤,或者您使用的是 JavaFX 8(这将导致箭头被翻译而无需关注第TitledPane一个),您可以提取必要的代码并进行一些修改,并将其放入实用程序中方法:

public static void putArrowOnRight(TitledPane pane) {
    Region title = (Region) pane.lookup(".title");
    Region arrow = (Region) title.lookup(".arrow-button");
    Text text = (Text) title.lookup(".text");

    arrow.translateXProperty().bind(Bindings.createDoubleBinding(() -> {
        double rightInset = title.getPadding().getRight();
        return title.getWidth() - arrow.getLayoutX() - arrow.getWidth() - rightInset;
    }, title.paddingProperty(), title.widthProperty(), arrow.widthProperty(), arrow.layoutXProperty()));
    arrow.setStyle("-fx-padding: 0.0em 0.0em 0.0em 0.583em;");

    DoubleBinding textGraphicBinding = Bindings.createDoubleBinding(() -> {
        switch (pane.getAlignment()) {
            case TOP_CENTER:
            case CENTER:
            case BOTTOM_CENTER:
            case BASELINE_CENTER:
                return 0.0;
            default:
                return -(arrow.getWidth());
        }
    }, arrow.widthProperty(), pane.alignmentProperty());
    text.translateXProperty().bind(textGraphicBinding);

    pane.graphicProperty().addListener((observable, oldGraphic, newGraphic) -> {
        if (oldGraphic != null) {
            oldGraphic.translateXProperty().unbind();
            oldGraphic.setTranslateX(0);
        }
        if (newGraphic != null) {
            newGraphic.translateXProperty().bind(textGraphicBinding);
        }
    });
    if (pane.getGraphic() != null) {
        pane.getGraphic().translateXProperty().bind(textGraphicBinding);
    }
}

注意:虽然这会将箭头放在右侧而不必首先关注第TitledPane一个,但TitledPane仍然会遇到上述问题。例如,更改alignment属性不会更新,TitledPane直到它获得焦点。我猜这只是 JavaFX 8 中的一个错误。

这种做事方式并不像皮肤方式那样“简单”,需要做两件事:

  1. TitledPane必须使用默认值TitledPaneSkin
  2. 在调用实用程序方法之前TitledPane 必须已在Window(窗口正在显示)中显示。

    • 由于 JavaFX 控件的惰性特性,在控件显示在窗口中之前,不会创建外观和相关节点。在显示控件之前调用实用程序方法将导致一个NullPointerException被抛出,因为lookup调用将返回null
    • 如果使用 FXML,请注意initialize在调用FXMLLoader.load(任何重载)期间调用该方法。这意味着,在正常情况下,创建的节点不可能成为 a Sceneyet 的一部分,更不用说 show 了Window。您必须先等待TitledPane显示,然后调用实用程序方法。

      等待TitledPane显示可以通过监听Node.scene属性、Scene.window属性和Window.showing属性来实现(或者你可以监听WindowEvent.WINDOW_SHOWN事件)。但是,如果您立即将加载的节点放入显示Window中,那么您可以放弃观察属性;Platform.runLater在内部调用中调用实用程序方法initialize

使用皮肤方法时,避免了整个等待显示窗口的麻烦。


通常警告:此答案依赖于其内部结构,TitledPane其内部结构可能会在未来版本中发生变化。更改 JavaFX 版本时要小心。我只(有点)在 JavaFX 8u202 和 JavaFX 11.0.2 上对此进行了测试。


推荐阅读