Swing JLayeredPane.getLayer() - 文档错误或实际副作用？

Question

我试图弄清楚 JLayeredPane 在 Swing 中。 如果有人使用过这个类，反馈将不胜感激。

getLayer(JComponent c) 的文档指出：

获取图层属性 JComponent，它不会引起任何方面 类似 setLayer() 的效果。 （绘画， 添加/删除等）通常你应该 使用实例方法 getLayer()。

显然，这里存在一些错误，因为这是实例方法 getLayer() （没有重载版本）

实际上是否应该在此处进行不同的调用，或者是否有人太急于从 putLayer() 进行复制：

设置图层属性 JComponent。 该方法不会导致 任何副作用，如 setLayer() （绘画、添加/删除等）。 通常情况下 你应该使用实例方法 setLayer()，为了得到 期望的副作用（例如 重新绘制）。

Answer 1

就像 Swing 中的许多事情一样，您的问题的答案在 swing 源代码中揭示。 来自 JLayeredPane.java：

public static int getLayer(JComponent c) {
    Integer i;
    if((i = (Integer)c.getClientProperty(LAYER_PROPERTY)) != null)
        return i.intValue();
    return DEFAULT_LAYER.intValue();
}

public int getLayer(Component c) {
    Integer i;
    if(c instanceof JComponent)
        i = (Integer)((JComponent)c).getClientProperty(LAYER_PROPERTY);
    else
        i = (Integer)getComponentToLayer().get((Component)c);

    if(i == null)
        return DEFAULT_LAYER.intValue();
    return i.intValue();
}

看起来您在这里看到一些差异的原因是 JComponent 实例的层存储为 JComponent 实例的属性，但 Component 实例的层存储在 JLayeredPane 的哈希表中。 因此， getLayer(JComponent c) 可以是静态的，而 getLayer(Component c) 则不能。

正如您可能想象的那样，这只是这个类的奇怪之处的开始。 验证和绘制 JLayeredPane 和内容可能很快就会变得复杂。