javafx.scene.control.PopupControl Maven / Gradle / Ivy
/*
* Copyright (c) 2010, 2013, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package javafx.scene.control;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import javafx.application.Application;
import javafx.beans.property.DoubleProperty;
import javafx.beans.property.DoublePropertyBase;
import javafx.beans.property.ObjectProperty;
import javafx.beans.property.ObjectPropertyBase;
import javafx.beans.property.SimpleStringProperty;
import javafx.beans.property.StringProperty;
import javafx.collections.FXCollections;
import javafx.collections.ListChangeListener.Change;
import javafx.collections.ObservableList;
import javafx.collections.ObservableSet;
import javafx.scene.Group;
import javafx.scene.Node;
import javafx.scene.Parent;
import javafx.scene.Scene;
import javafx.stage.PopupWindow;
import com.sun.javafx.application.PlatformImpl;
import com.sun.javafx.collections.TrackableObservableList;
import com.sun.javafx.css.CssError;
import javafx.css.CssMetaData;
import javafx.css.PseudoClass;
import com.sun.javafx.css.StyleManager;
import javafx.css.Styleable;
import javafx.css.StyleableStringProperty;
import com.sun.javafx.css.converters.StringConverter;
import com.sun.javafx.scene.control.Logging;
import javafx.css.StyleableProperty;
import javafx.stage.Window;
import sun.util.logging.PlatformLogger;
/**
* An extension of PopupWindow that allows for CSS styling.
* @since JavaFX 2.0
*/
public class PopupControl extends PopupWindow implements Skinnable, Styleable {
/**
* Sentinel value which can be passed to a control's setMinWidth(), setMinHeight(),
* setMaxWidth() or setMaxHeight() methods to indicate that the preferred dimension
* should be used for that max and/or min constraint.
*/
public static final double USE_PREF_SIZE = Double.NEGATIVE_INFINITY;
/**
* Sentinel value which can be passed to a control's setMinWidth(), setMinHeight(),
* setPrefWidth(), setPrefHeight(), setMaxWidth(), setMaxHeight() methods
* to reset the control's size constraint back to it's intrinsic size returned
* by computeMinWidth(), computeMinHeight(), computePrefWidth(), computePrefHeight(),
* computeMaxWidth(), or computeMaxHeight().
*/
public static final double USE_COMPUTED_SIZE = -1;
static {
// Ensures that the default application user agent stylesheet is loaded
if (Application.getUserAgentStylesheet() == null) {
PlatformImpl.setDefaultPlatformUserAgentStylesheet();
}
}
/**
* We need a special root node, except we can't replace the special
* root node already in the PopupControl. So we'll set our own
* special almost-root node that is a child of the root.
*
* This special root node is responsible for mapping the id, styleClass,
* and style defined on the PopupControl such that CSS will read the
* values from the PopupControl, and then apply CSS state to that
* special node. The node will then be able to pass impl_cssSet calls
* along, such that any subclass of PopupControl will be able to
* use the Styleable properties and we'll be able to style it from
* CSS, in such a way that it participates and applies to the skin,
* exactly the way that normal Skin's work for normal Controls.
* @since JavaFX 2.1
*/
protected CSSBridge bridge;
/**
* Create a new empty PopupControl.
*/
public PopupControl() {
super();
this.bridge = new CSSBridge();
// Bind up these two properties. Note that the third, styleClass, is
// handled in the onChange listener for that list.
bridge.idProperty().bind(idProperty());
bridge.styleProperty().bind(styleProperty());
getContent().add(bridge);
// TODO the fact that PopupWindow uses a group for auto-moving things
// around means that the scene resize semantics don't work if the
// child is a resizable. I will need to replicate those semantics
// here sometime, such that if the Skin provides a resizable, it is
// given to match the popup window's width & height.
}
// TODO we should have some interface which has id, styleClass, style, etc
// which is in common between PopupControl and Node.
// TODO we should have some interface for minWidth, maxWidth, etc which are
// both here and on Node.
/**
* The id of this {@code PopupControl}. This simple string identifier is useful for
* finding a specific Node within the scene graph. While the id of a Node
* should be unique within the scene graph, this uniqueness is not enforced.
* This is analogous to the "id" attribute on an HTML element
* (CSS ID Specification).
*
* @defaultValue null
*/
private final StringProperty id = new SimpleStringProperty(this, "id");
public final StringProperty idProperty() { return id; }
/**
* Sets the id of this {@code PopupControl}. This simple string identifier is useful for
* finding a specific Node within the scene graph. While the id of a Node
* should be unique within the scene graph, this uniqueness is not enforced.
* This is analogous to the "id" attribute on an HTML element
* (CSS ID Specification).
*
* @param value the id assigned to this {@code PopupControl} using the {@code setId}
* method or {@code null}, if no id has been assigned.
* @defaultValue null
*/
public final void setId(String value) { id.set(value); }
/**
* The id of this {@code PopupControl}. This simple string identifier is useful for
* finding a specific Node within the scene graph. While the id of a Node
* should be unique within the scene graph, this uniqueness is not enforced.
* This is analogous to the "id" attribute on an HTML element
* (CSS ID Specification).
*
* @return the id assigned to this {@code PopupControl} using the {@code setId}
* method or {@code null}, if no id has been assigned.
* @defaultValue null
*/
@Override public final String getId() { return id.get(); }
/**
* A list of String identifiers which can be used to logically group
* Nodes, specifically for an external style engine. This variable is
* analogous to the "class" attribute on an HTML element and, as such,
* each element of the list is a style class to which this Node belongs.
*
* @see CSS3 class selectors
* @defaultValue null
*/
private final ObservableList styleClass = new TrackableObservableList() {
// TODO we can save one class if we factor this into a StyleClassList, and reuse it between
// here and in Node.
@Override protected void onChanged(Change c) {
// Push the change along to the bridge group
bridge.getStyleClass().setAll(styleClass);
}
@Override public String toString() {
if (size() == 0) {
return "";
} else if (size() == 1) {
return get(0);
} else {
StringBuilder buf = new StringBuilder();
for (int i = 0; i < size(); i++) {
buf.append(get(i));
if (i + 1 < size()) {
buf.append(' ');
}
}
return buf.toString();
}
}
};
/**
* Returns the list of String identifiers that make up the styleClass
* for this PopupControl.
*/
@Override public final ObservableList getStyleClass() { return styleClass; }
/**
* A string representation of the CSS style associated with this
* specific PopupControl. This is analogous to the "style" attribute of an
* HTML element. Note that, like the HTML style attribute, this
* variable contains style properties and values and not the
* selector portion of a style rule.
*
* Parsing this style might not be supported on some limited
* platforms. It is recommended to use a standalone CSS file instead.
*
* @defaultValue empty string
*/
private final StringProperty style = new SimpleStringProperty(this, "style");
/**
* A string representation of the CSS style associated with this
* specific {@code PopupControl}. This is analogous to the "style" attribute of an
* HTML element. Note that, like the HTML style attribute, this
* variable contains style properties and values and not the
* selector portion of a style rule.
* @param value The inline CSS style to use for this {@code PopupControl}.
* {@code null} is implicitly converted to an empty String.
* @defaultValue empty string
*/
public final void setStyle(String value) { style.set(value); }
// TODO: javadoc copied from property for the sole purpose of providing a return tag
/**
* A string representation of the CSS style associated with this
* specific {@code PopupControl}. This is analogous to the "style" attribute of an
* HTML element. Note that, like the HTML style attribute, this
* variable contains style properties and values and not the
* selector portion of a style rule.
* @defaultValue empty string
* @return The inline CSS style associated with this {@code PopupControl}.
* If this {@code PopupControl} does not have an inline style,
* an empty String is returned.
*/
@Override public final String getStyle() { return style.get(); }
public final StringProperty styleProperty() { return style; }
@Override public final ObjectProperty> skinProperty() {
return bridge.skin; }
@Override public final void setSkin(Skin value) {
skinProperty().set(value);
}
@Override public final Skin getSkin() {
return skinProperty().getValue();
}
/**
* Gets the Skin's node, or returns null if there is no Skin.
* Convenience method for getting the node of the skin. This is null-safe,
* meaning if skin is null then it will return null instead of throwing
* a NullPointerException.
*
* @return The Skin's node, or null.
*/
private Node getSkinNode() {
return getSkin() == null ? null : getSkin().getNode();
}
/**
* Property for overriding the control's computed minimum width.
* This should only be set if the control's internally computed minimum width
* doesn't meet the application's layout needs.
*
* Defaults to the USE_COMPUTED_SIZE flag, which means that
* getMinWidth(forHeight) will return the control's internally
* computed minimum width.
*
* Setting this value to the USE_PREF_SIZE flag will cause
* getMinWidth(forHeight) to return the control's preferred width,
* enabling applications to easily restrict the resizability of the control.
*/
private DoubleProperty minWidth;
/**
* Property for overriding the control's computed minimum width.
* This should only be set if the control's internally computed minimum width
* doesn't meet the application's layout needs.
*
* Defaults to the USE_COMPUTED_SIZE flag, which means that
* getMinWidth(forHeight) will return the control's internally
* computed minimum width.
*
* Setting this value to the USE_PREF_SIZE flag will cause
* getMinWidth(forHeight) to return the control's preferred width,
* enabling applications to easily restrict the resizability of the control.
*/
public final void setMinWidth(double value) { minWidthProperty().set(value); }
/**
* Property for overriding the control's computed minimum width.
* This should only be set if the control's internally computed minimum width
* doesn't meet the application's layout needs.
*
* Defaults to the USE_COMPUTED_SIZE flag, which means that
* getMinWidth(forHeight) will return the control's internally
* computed minimum width.
*
* Setting this value to the USE_PREF_SIZE flag will cause
* getMinWidth(forHeight) to return the control's preferred width,
* enabling applications to easily restrict the resizability of the control.
*/
public final double getMinWidth() { return minWidth == null ? USE_COMPUTED_SIZE : minWidth.get(); }
public final DoubleProperty minWidthProperty() {
if (minWidth == null) {
minWidth = new DoublePropertyBase(USE_COMPUTED_SIZE) {
@Override public void invalidated() {
if (isShowing()) bridge.requestLayout();
}
@Override
public Object getBean() {
return PopupControl.this;
}
@Override
public String getName() {
return "minWidth";
}
};
}
return minWidth;
}
/**
* Property for overriding the control's computed minimum height.
* This should only be set if the control's internally computed minimum height
* doesn't meet the application's layout needs.
*
* Defaults to the USE_COMPUTED_SIZE flag, which means that
* getMinHeight(forWidth) will return the control's internally
* computed minimum height.
*
* Setting this value to the USE_PREF_SIZE flag will cause
* getMinHeight(forWidth) to return the control's preferred height,
* enabling applications to easily restrict the resizability of the control.
*
*/
private DoubleProperty minHeight;
/**
* Property for overriding the control's computed minimum height.
* This should only be set if the control's internally computed minimum height
* doesn't meet the application's layout needs.
*
* Defaults to the USE_COMPUTED_SIZE flag, which means that
* getMinHeight(forWidth) will return the control's internally
* computed minimum height.
*
* Setting this value to the USE_PREF_SIZE flag will cause
* getMinHeight(forWidth) to return the control's preferred height,
* enabling applications to easily restrict the resizability of the control.
*
*/
public final void setMinHeight(double value) { minHeightProperty().set(value); }
/**
* Property for overriding the control's computed minimum height.
* This should only be set if the control's internally computed minimum height
* doesn't meet the application's layout needs.
*
* Defaults to the USE_COMPUTED_SIZE flag, which means that
* getMinHeight(forWidth) will return the control's internally
* computed minimum height.
*
* Setting this value to the USE_PREF_SIZE flag will cause
* getMinHeight(forWidth) to return the control's preferred height,
* enabling applications to easily restrict the resizability of the control.
*
*/
public final double getMinHeight() { return minHeight == null ? USE_COMPUTED_SIZE : minHeight.get(); }
public final DoubleProperty minHeightProperty() {
if (minHeight == null) {
minHeight = new DoublePropertyBase(USE_COMPUTED_SIZE) {
@Override public void invalidated() {
if (isShowing()) bridge.requestLayout();
}
@Override
public Object getBean() {
return PopupControl.this;
}
@Override
public String getName() {
return "minHeight";
}
};
}
return minHeight;
}
/**
* Convenience method for overriding the control's computed minimum width and height.
* This should only be called if the control's internally computed minimum size
* doesn't meet the application's layout needs.
*
* @see #setMinWidth
* @see #setMinHeight
* @param minWidth the override value for minimum width
* @param minHeight the override value for minimum height
*/
public void setMinSize(double minWidth, double minHeight) {
setMinWidth(minWidth);
setMinHeight(minHeight);
}
/**
* Property for overriding the control's computed preferred width.
* This should only be set if the control's internally computed preferred width
* doesn't meet the application's layout needs.
*
* Defaults to the USE_COMPUTED_SIZE flag, which means that
* getPrefWidth(forHeight) will return the control's internally
* computed preferred width.
*/
private DoubleProperty prefWidth;
/**
* Property for overriding the control's computed preferred width.
* This should only be set if the control's internally computed preferred width
* doesn't meet the application's layout needs.
*
* Defaults to the USE_COMPUTED_SIZE flag, which means that
* getPrefWidth(forHeight) will return the control's internally
* computed preferred width.
*/
public final void setPrefWidth(double value) { prefWidthProperty().set(value); }
/**
* Property for overriding the control's computed preferred width.
* This should only be set if the control's internally computed preferred width
* doesn't meet the application's layout needs.
*
* Defaults to the USE_COMPUTED_SIZE flag, which means that
* getPrefWidth(forHeight) will return the control's internally
* computed preferred width.
*/
public final double getPrefWidth() { return prefWidth == null ? USE_COMPUTED_SIZE : prefWidth.get(); }
public final DoubleProperty prefWidthProperty() {
if (prefWidth == null) {
prefWidth = new DoublePropertyBase(USE_COMPUTED_SIZE) {
@Override public void invalidated() {
if (isShowing()) bridge.requestLayout();
}
@Override
public Object getBean() {
return PopupControl.this;
}
@Override
public String getName() {
return "prefWidth";
}
};
}
return prefWidth;
}
/**
* Property for overriding the control's computed preferred height.
* This should only be set if the control's internally computed preferred height
* doesn't meet the application's layout needs.
*
* Defaults to the USE_COMPUTED_SIZE flag, which means that
* getPrefHeight(forWidth) will return the control's internally
* computed preferred width.
*
*/
private DoubleProperty prefHeight;
/**
* Property for overriding the control's computed preferred height.
* This should only be set if the control's internally computed preferred height
* doesn't meet the application's layout needs.
*
* Defaults to the USE_COMPUTED_SIZE flag, which means that
* getPrefHeight(forWidth) will return the control's internally
* computed preferred width.
*
*/
public final void setPrefHeight(double value) { prefHeightProperty().set(value); }
/**
* Property for overriding the control's computed preferred height.
* This should only be set if the control's internally computed preferred height
* doesn't meet the application's layout needs.
*
* Defaults to the USE_COMPUTED_SIZE flag, which means that
* getPrefHeight(forWidth) will return the control's internally
* computed preferred width.
*
*/
public final double getPrefHeight() { return prefHeight == null ? USE_COMPUTED_SIZE : prefHeight.get(); }
public final DoubleProperty prefHeightProperty() {
if (prefHeight == null) {
prefHeight = new DoublePropertyBase(USE_COMPUTED_SIZE) {
@Override public void invalidated() {
if (isShowing()) bridge.requestLayout();
}
@Override
public Object getBean() {
return PopupControl.this;
}
@Override
public String getName() {
return "prefHeight";
}
};
}
return prefHeight;
}
/**
* Convenience method for overriding the control's computed preferred width and height.
* This should only be called if the control's internally computed preferred size
* doesn't meet the application's layout needs.
*
* @see #setPrefWidth
* @see #setPrefHeight
* @param prefWidth the override value for preferred width
* @param prefHeight the override value for preferred height
*/
public void setPrefSize(double prefWidth, double prefHeight) {
setPrefWidth(prefWidth);
setPrefHeight(prefHeight);
}
/**
* Property for overriding the control's computed maximum width.
* This should only be set if the control's internally computed maximum width
* doesn't meet the application's layout needs.
*
* Defaults to the USE_COMPUTED_SIZE flag, which means that
* getMaxWidth(forHeight) will return the control's internally
* computed maximum width.
*
* Setting this value to the USE_PREF_SIZE flag will cause
* getMaxWidth(forHeight) to return the control's preferred width,
* enabling applications to easily restrict the resizability of the control.
*/
private DoubleProperty maxWidth;
/**
* Property for overriding the control's computed maximum width.
* This should only be set if the control's internally computed maximum width
* doesn't meet the application's layout needs.
*
* Defaults to the USE_COMPUTED_SIZE flag, which means that
* getMaxWidth(forHeight) will return the control's internally
* computed maximum width.
*
* Setting this value to the USE_PREF_SIZE flag will cause
* getMaxWidth(forHeight) to return the control's preferred width,
* enabling applications to easily restrict the resizability of the control.
*/
public final void setMaxWidth(double value) { maxWidthProperty().set(value); }
/**
* Property for overriding the control's computed maximum width.
* This should only be set if the control's internally computed maximum width
* doesn't meet the application's layout needs.
*
* Defaults to the USE_COMPUTED_SIZE flag, which means that
* getMaxWidth(forHeight) will return the control's internally
* computed maximum width.
*
* Setting this value to the USE_PREF_SIZE flag will cause
* getMaxWidth(forHeight) to return the control's preferred width,
* enabling applications to easily restrict the resizability of the control.
*/
public final double getMaxWidth() { return maxWidth == null ? USE_COMPUTED_SIZE : maxWidth.get(); }
public final DoubleProperty maxWidthProperty() {
if (maxWidth == null) {
maxWidth = new DoublePropertyBase(USE_COMPUTED_SIZE) {
@Override public void invalidated() {
if (isShowing()) bridge.requestLayout();
}
@Override
public Object getBean() {
return PopupControl.this;
}
@Override
public String getName() {
return "maxWidth";
}
};
}
return maxWidth;
}
/**
* Property for overriding the control's computed maximum height.
* This should only be set if the control's internally computed maximum height
* doesn't meet the application's layout needs.
*
* Defaults to the USE_COMPUTED_SIZE flag, which means that
* getMaxHeight(forWidth) will return the control's internally
* computed maximum height.
*
* Setting this value to the USE_PREF_SIZE flag will cause
* getMaxHeight(forWidth) to return the control's preferred height,
* enabling applications to easily restrict the resizability of the control.
*
*/
private DoubleProperty maxHeight;
/**
* Property for overriding the control's computed maximum height.
* This should only be set if the control's internally computed maximum height
* doesn't meet the application's layout needs.
*
* Defaults to the USE_COMPUTED_SIZE flag, which means that
* getMaxHeight(forWidth) will return the control's internally
* computed maximum height.
*
* Setting this value to the USE_PREF_SIZE flag will cause
* getMaxHeight(forWidth) to return the control's preferred height,
* enabling applications to easily restrict the resizability of the control.
*
*/
public final void setMaxHeight(double value) { maxHeightProperty().set(value); }
/**
* Property for overriding the control's computed maximum height.
* This should only be set if the control's internally computed maximum height
* doesn't meet the application's layout needs.
*
* Defaults to the USE_COMPUTED_SIZE flag, which means that
* getMaxHeight(forWidth) will return the control's internally
* computed maximum height.
*
* Setting this value to the USE_PREF_SIZE flag will cause
* getMaxHeight(forWidth) to return the control's preferred height,
* enabling applications to easily restrict the resizability of the control.
*
*/
public final double getMaxHeight() { return maxHeight == null ? USE_COMPUTED_SIZE : maxHeight.get(); }
public final DoubleProperty maxHeightProperty() {
if (maxHeight == null) {
maxHeight = new DoublePropertyBase(USE_COMPUTED_SIZE) {
@Override public void invalidated() {
if (isShowing()) bridge.requestLayout();
}
@Override
public Object getBean() {
return PopupControl.this;
}
@Override
public String getName() {
return "maxHeight";
}
};
}
return maxHeight;
}
/**
* Convenience method for overriding the control's computed maximum width and height.
* This should only be called if the control's internally computed maximum size
* doesn't meet the application's layout needs.
*
* @see #setMaxWidth
* @see #setMaxHeight
* @param maxWidth the override value for maximum width
* @param maxHeight the override value for maximum height
*/
public void setMaxSize(double maxWidth, double maxHeight) {
setMaxWidth(maxWidth);
setMaxHeight(maxHeight);
}
/**
* Cached prefWidth, prefHeight, minWidth, minHeight. These
* results are repeatedly sought during the layout pass,
* and caching the results leads to a significant decrease
* in overhead.
*/
private double prefWidthCache = -1;
private double prefHeightCache = -1;
private double minWidthCache = -1;
private double minHeightCache = -1;
private double maxWidthCache = -1;
private double maxHeightCache = -1;
private boolean skinSizeComputed = false;
/**
* Called during layout to determine the minimum width for this node.
* Returns the value from minWidth(forHeight) unless
* the application overrode the minimum width by setting the minWidth property.
*
* @param height the height
* @see #setMinWidth
* @return the minimum width that this node should be resized to during layout
*/
public final double minWidth(double height) {
double override = getMinWidth();
if (override == USE_COMPUTED_SIZE) {
if (minWidthCache == -1) minWidthCache = recalculateMinWidth(height);
return minWidthCache;
} else if (override == USE_PREF_SIZE) {
return prefWidth(height);
}
return override;
}
/**
* Called during layout to determine the minimum height for this node.
* Returns the value from minHeight(forWidth) unless
* the application overrode the minimum height by setting the minHeight property.
*
* @param width The width
* @see #setMinHeight
* @return the minimum height that this node should be resized to during layout
*/
public final double minHeight(double width) {
double override = getMinHeight();
if (override == USE_COMPUTED_SIZE) {
if (minHeightCache == -1) minHeightCache = recalculateMinHeight(width);
return minHeightCache;
} else if (override == USE_PREF_SIZE) {
return prefHeight(width);
}
return override;
}
/**
* Called during layout to determine the preferred width for this node.
* Returns the value from prefWidth(forHeight) unless
* the application overrode the preferred width by setting the prefWidth property.
*
* @param height the height
* @see #setPrefWidth
* @return the preferred width that this node should be resized to during layout
*/
public final double prefWidth(double height) {
double override = getPrefWidth();
if (override == USE_COMPUTED_SIZE) {
if (prefWidthCache == -1) prefWidthCache = recalculatePrefWidth(height);
return prefWidthCache;
} else if (override == USE_PREF_SIZE) {
return prefWidth(height);
}
return override;
}
/**
* Called during layout to determine the preferred height for this node.
* Returns the value from prefHeight(forWidth) unless
* the application overrode the preferred height by setting the prefHeight property.
*
* @param width the width
* @see #setPrefHeight
* @return the preferred height that this node should be resized to during layout
*/
public final double prefHeight(double width) {
double override = getPrefHeight();
if (override == USE_COMPUTED_SIZE) {
if (prefHeightCache == -1) prefHeightCache = recalculatePrefHeight(width);
return prefHeightCache;
} else if (override == USE_PREF_SIZE) {
return prefHeight(width);
}
return override;
}
/**
* Called during layout to determine the maximum width for this node.
* Returns the value from maxWidth(forHeight) unless
* the application overrode the maximum width by setting the maxWidth property.
*
* @param height the height
* @see #setMaxWidth
* @return the maximum width that this node should be resized to during layout
*/
public final double maxWidth(double height) {
double override = getMaxWidth();
if (override == USE_COMPUTED_SIZE) {
if (maxWidthCache == -1) maxWidthCache = recalculateMaxWidth(height);
return maxWidthCache;
} else if (override == USE_PREF_SIZE) {
return prefWidth(height);
}
return override;
}
/**
* Called during layout to determine the maximum height for this node.
* Returns the value from maxHeight(forWidth) unless
* the application overrode the maximum height by setting the maxHeight property.
*
* @param width the width
* @see #setMaxHeight
* @return the maximum height that this node should be resized to during layout
*/
public final double maxHeight(double width) {
double override = getMaxHeight();
if (override == USE_COMPUTED_SIZE) {
if (maxHeightCache == -1) maxHeightCache = recalculateMaxHeight(width);
return maxHeightCache;
} else if (override == USE_PREF_SIZE) {
return prefHeight(width);
}
return override;
}
// Implementation of the Resizable interface.
// Because only the skin can know the min, pref, and max sizes, these
// functions are implemented to delegate to skin. If there is no skin then
// we simply return 0 for all the values since a Control without a Skin
// doesn't render
private double recalculateMinWidth(double height) {
recomputeSkinSize();
return getSkinNode() == null ? 0 : getSkinNode().minWidth(height);
}
private double recalculateMinHeight(double width) {
recomputeSkinSize();
return getSkinNode() == null ? 0 : getSkinNode().minHeight(width);
}
private double recalculateMaxWidth(double height) {
recomputeSkinSize();
return getSkinNode() == null ? 0 : getSkinNode().maxWidth(height);
}
private double recalculateMaxHeight(double width) {
recomputeSkinSize();
return getSkinNode() == null ? 0 : getSkinNode().maxHeight(width);
}
private double recalculatePrefWidth(double height) {
recomputeSkinSize();
return getSkinNode() == null? 0 : getSkinNode().prefWidth(height);
}
private double recalculatePrefHeight(double width) {
recomputeSkinSize();
return getSkinNode() == null? 0 : getSkinNode().prefHeight(width);
}
private void recomputeSkinSize() {
if (!skinSizeComputed && getOwnerWindow() != null) { //getScene() != null && getScene().getRoot() != null) {
// RT-14094, RT-16754: We need the skins of the popup
// and it children before the stage is visible so we
// can calculate the popup position based on content
// size.
getScene().getRoot().impl_processCSS(true);
skinSizeComputed = true;
}
}
// public double getBaselineOffset() { return getSkinNode() == null? 0 : getSkinNode().getBaselineOffset(); }
/**
* Create a new instance of the default skin for this control. This is called to create a skin for the control if
* no skin is provided via CSS {@code -fx-skin} or set explicitly in a sub-class with {@code setSkin(...)}.
*
* @return new instance of default skin for this control. If null then the control will have no skin unless one
* is provided by css.
* @since JavaFX 8.0
*/
protected Skin createDefaultSkin() {
return null;
}
/***************************************************************************
* *
* StyleSheet Handling *
* *
**************************************************************************/
private static class StyleableProperties {
private static final CssMetaData SKIN =
new CssMetaData("-fx-skin",
StringConverter.getInstance()) {
@Override
public boolean isSettable(CSSBridge n) {
return n.skin == null || !n.skin.isBound();
}
@Override
public StyleableProperty getStyleableProperty(CSSBridge n) {
return (StyleableProperty)n.skinClassNameProperty();
}
};
private static final List> STYLEABLES;
static {
final List> styleables =
new ArrayList>();
Collections.addAll(styleables,
SKIN
);
STYLEABLES = Collections.unmodifiableList(styleables);
}
}
/**
* @return The CssMetaData associated with this class, which may include the
* CssMetaData of its super classes.
* @since JavaFX 8.0
*/
public static List> getClassCssMetaData() {
return StyleableProperties.STYLEABLES;
}
/**
* This method should delegate to {@link Node#getClassCssMetaData()} so that
* a Node's CssMetaData can be accessed without the need for reflection.
* @return The CssMetaData associated with this node, which may include the
* CssMetaData of its super classes.
* @since JavaFX 8.0
*/
public List> getCssMetaData() {
return getClassCssMetaData();
}
/**
* @see Node#pseudoClassStateChanged(javafx.css.PseudoClass, boolean)
* @since JavaFX 8.0
*/
public final void pseudoClassStateChanged(PseudoClass pseudoClass, boolean active) {
bridge.pseudoClassStateChanged(pseudoClass, active);
}
/**
* {@inheritDoc}
* @return "PopupControl"
* @since JavaFX 8.0
*/
@Override
public String getTypeSelector() {
return "PopupControl";
}
/**
* {@inheritDoc}
*
* A PopupControl's styles are based on the popup "owner" which is the
* {@link javafx.stage.PopupWindow#getOwnerNode() ownerNode} or,
* if the ownerNode is not set, the root of the {@link javafx.stage.PopupWindow#getOwnerWindow() ownerWindow's}
* scene. If the popup has not been shown, both ownerNode and ownerWindow will be null and {@code null} will be returned.
*
* Note that the PopupWindow's scene root is not returned because there is no way to guarantee that the
* PopupWindow's scene root would properly return the ownerNode or ownerWindow.
*
* @return {@link javafx.stage.PopupWindow#getOwnerNode()}, {@link javafx.stage.PopupWindow#getOwnerWindow()},
* or null.
* @since JavaFX 8.0
*/
@Override
public Styleable getStyleableParent() {
final Node ownerNode = getOwnerNode();
if (ownerNode != null) {
return ownerNode;
} else {
final Window ownerWindow = getOwnerWindow();
if (ownerWindow != null) {
final Scene ownerScene = ownerWindow.getScene();
if (ownerScene != null) {
return ownerScene.getRoot();
}
}
}
return null;
}
/**
* {@inheritDoc}
* @since JavaFX 8.0
*/
public final ObservableSet getPseudoClassStates() {
return FXCollections.emptyObservableSet();
}
/**
* @treatAsPrivate implementation detail
* @deprecated This is an internal API that is not intended for use and will be removed in the next version
*/
@Deprecated
// SB-dependency: RT-21094 has been filed to track this
public Node impl_styleableGetNode() {
return bridge;
}
/**
* @since JavaFX 2.1
*/
protected class CSSBridge extends Group {
private String currentSkinClassName = null;
/**
* {@inheritDoc}
* @since JavaFX 8.0
*/
public List> getCssMetaData() {
// see RT-19263
return PopupControl.this.getCssMetaData();
}
/**
* Requests a layout pass to be performed before the next scene is
* rendered. This is batched up asynchronously to happen once per
* "pulse", or frame of animation.
*
* If this parent is either a layout root or unmanaged, then it will be
* added directly to the scene's dirty layout list, otherwise requestLayout
* will be invoked on its parent.
*/
@Override public void requestLayout() {
prefWidthCache = -1;
prefHeightCache = -1;
minWidthCache = -1;
minHeightCache = -1;
maxWidthCache = -1;
maxHeightCache = -1;
skinSizeComputed = false;
super.requestLayout();
}
/**
* Skin is responsible for rendering this {@code PopupControl}. From the
* perspective of the {@code PopupControl}, the {@code Skin} is a black box.
* It listens and responds to changes in state in a {@code PopupControl}.
*
* There is a one-to-one relationship between a {@code PopupControl} and its
* {@code Skin}. Every {@code Skin} maintains a back reference to the
* {@code PopupControl}.
*
* A skin may be null.
*/
private ObjectProperty> skin = new ObjectPropertyBase>() {
// We store a reference to the oldValue so that we can handle
// changes in the skin properly in the case of binding. This is
// only needed because invalidated() does not currently take
// a reference to the old value.
private Skin oldValue;
@Override
public void set(Skin v) {
if (v == null
? oldValue == null
: oldValue != null && v.getClass().equals(oldValue.getClass()))
return;
super.set(v);
// Collect the name of the currently installed skin class. We do this
// so that subsequent updates from CSS to the same skin class will not
// result in reinstalling the skin
currentSkinClassName = v == null ? null : v.getClass().getName();
// if someone calls setSkin, we need to make it look like they
// called set on skinClassName in order to keep CSS from overwriting
// the skin.
skinClassNameProperty().set(currentSkinClassName);
}
@Override protected void invalidated() {
// Let CSS know that this property has been manually changed
// Dispose of the old skin
if (oldValue != null) oldValue.dispose();
// Get the new value, and save it off as the new oldValue
oldValue = getValue();
prefWidthCache = -1;
prefHeightCache = -1;
minWidthCache = -1;
minHeightCache = -1;
maxWidthCache = -1;
maxHeightCache = -1;
skinSizeComputed = false;
final Node n = getSkinNode();
if (n != null) bridge.getChildren().setAll(n);
else bridge.getChildren().clear();
// calling impl_reapplyCSS() as the styleable properties may now
// be different, as we will now be able to return styleable properties
// belonging to the skin. If impl_reapplyCSS() is not called, the
// getCssMetaData() method is never called, so the
// skin properties are never exposed.
impl_reapplyCSS();
// DEBUG: Log that we've changed the skin
final PlatformLogger logger = Logging.getControlsLogger();
if (logger.isLoggable(PlatformLogger.FINEST)) {
logger.finest("Stored skin[" + getValue() + "] on " + this);
}
}
@Override
public Object getBean() {
return PopupControl.CSSBridge.this;
}
@Override
public String getName() {
return "skin";
}
};
/**
* Keeps a reference to the name of the class currently acting as the skin.
*/
private StringProperty skinClassName = null;
private StringProperty skinClassNameProperty() {
if (skinClassName == null) {
skinClassName = new StyleableStringProperty() {
@Override
public void set(String v) {
// do not allow the skin to be set to null through CSS
if (v == null || v.isEmpty() || v.equals(get())) return;
super.set(v);
}
@Override
public void invalidated() {
//
// if the current skin is not null, then
// see if then check to see if the current skin's class name
// is the same as skinClassName. If it is, then there is
// no need to load the skin class. Note that the only time
// this would be the case is if someone called setSkin since
// the skin would be set ahead of the skinClassName
// (skinClassName is set from the skinProperty's invalidated
// method, so the skin would be set, then the skinClassName).
// If the skinClassName is set first (via CSS), then this
// invalidated method won't get called unless the value
// has changed (thus, we won't reload the same skin).
//
if (get() != null) {
if (!get().equals(currentSkinClassName)) {
Control.loadSkinClass(PopupControl.this, skinClassName.get());
}
// CSS should not set skin to null
// } else {
// setSkin(null);
}
}
@Override
public Object getBean() {
return PopupControl.CSSBridge.this;
}
@Override
public String getName() {
return "skinClassName";
}
@Override
public CssMetaData getCssMetaData() {
return StyleableProperties.SKIN;
}
};
}
return skinClassName;
}
protected void setSkinClassName(String skinClassName) {
skinClassNameProperty().set(skinClassName);
}
/**
* @treatAsPrivate implementation detail
* @deprecated This is an internal API that is not intended for use and will be removed in the next version
*/
@Deprecated
@Override protected void impl_processCSS() {
super.impl_processCSS();
if (getSkin() == null) {
// try to create default skin
final Skin defaultSkin = createDefaultSkin();
if (defaultSkin != null) {
skinProperty().set(defaultSkin);
// we have to reapply css again so that the newly set skin gets css applied as well.
super.impl_processCSS();
} else {
final String msg = "The -fx-skin property has not been defined in CSS for " + this +
" and createDefaultSkin() returned null.";
final List errors = StyleManager.getErrors();
if (errors != null) {
CssError error = new CssError(msg);
errors.add(error); // RT-19884
}
Logging.getControlsLogger().severe(msg);
}
}
}
@Override
public Styleable getStyleableParent() {
return PopupControl.this.getStyleableParent();
}
@Override public List impl_getAllParentStylesheets() {
Styleable styleable = getStyleableParent();
if (styleable instanceof Parent) {
return ((Parent)styleable).impl_getAllParentStylesheets();
}
return null;
}
}
}