com.alee.extended.inspector.InterfaceTreeNode Maven / Gradle / Ivy
/*
* This file is part of WebLookAndFeel library.
*
* WebLookAndFeel library is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* WebLookAndFeel library 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 for more details.
*
* You should have received a copy of the GNU General Public License
* along with WebLookAndFeel library. If not, see
implements IconBridge>,
TextBridge>
{
/**
* todo 1. These nodes keep hard reference to components
*/
/**
* Identifier of the root node or basically {@code null} inspected {@link Component}.
*/
public static final String ALL_WINDOWS_ID = "all.windows";
/**
* Windows root icon.
*/
protected static final ImageIcon windowsIcon = new ImageIcon ( ComponentPreview.class.getResource ( "icons/windows.png" ) );
/**
* {@link ComponentPreview} for extended components.
*/
protected static final ComponentPreview wComponentPreview = new WComponentPreview ();
/**
* {@link ComponentPreview} for {@link JComponent}s.
*/
protected static final ComponentPreview jComponentPreview = new JComponentPreview ();
/**
* {@link ComponentPreview} for {@link Component}s.
*/
protected static final ComponentPreview awtComponentPreview = new AWTComponentPreview ();
/**
* {@link InterfaceTree} this node is used for.
*/
@NotNull
protected transient InterfaceTree tree;
/**
* Component state listeners.
*/
protected transient ComponentAdapter componentAdapter;
protected transient ContainerAdapter containerAdapter;
protected transient StyleListener styleListener;
protected transient VisibleWindowListener visibleWindowListener;
/**
* Constructs new {@link InterfaceTreeNode}.
*
* @param tree {@link InterfaceTree}
* @param component {@link Component} this node references
*/
public InterfaceTreeNode ( @NotNull final InterfaceTree tree, @Nullable final Component component )
{
super ( id ( component ), component );
this.tree = tree;
install ();
}
@Nullable
@Override
public Icon getIcon ( @NotNull final TreeNodeParameters parameters )
{
final Component component = getUserObject ();
return component != null ? getPreview ().getIcon ( component ) : windowsIcon;
}
@Nullable
@Override
public String getText ( @NotNull final TreeNodeParameters parameters )
{
final Component component = getUserObject ();
return component != null ? getPreview ().getText ( component ) : LM.get ( "weblaf.ex.inspector.windows" );
}
/**
* Installs component listeners.
*/
protected void install ()
{
// Ensure this is invoked on EDT
WebLookAndFeel.checkEventDispatchThread ();
// Adding listeners depending on the node type
final Component component = getUserObject ();
if ( component == null )
{
/**
* Visible windows listener.
*/
visibleWindowListener = new VisibleWindowListener ()
{
@Override
public void windowDisplayed ( @NotNull final Window window )
{
if ( window.isShowing () )
{
final InterfaceTreeNode childNode = new InterfaceTreeNode ( tree, window );
tree.addChildNode ( InterfaceTreeNode.this, childNode );
}
}
@Override
public void windowHidden ( @NotNull final Window window )
{
for ( int i = 0; i < InterfaceTreeNode.this.getChildCount (); i++ )
{
final InterfaceTreeNode child = InterfaceTreeNode.this.getChildAt ( i );
if ( child.getUserObject () == window )
{
child.uninstall ();
tree.removeNode ( child );
break;
}
}
}
};
WebLookAndFeel.addVisibleWindowListener ( tree, visibleWindowListener );
}
else
{
/**
* Node component listener.
*/
componentAdapter = new ComponentAdapter ()
{
@Override
public void componentResized ( @NotNull final ComponentEvent e )
{
/**
* We don't need to react to size changes.
* Also call to {@link InterfaceTreeNode#updateNodeLater(InterfaceTree)} causes UI flickering so this is disabled.
*/
}
@Override
public void componentMoved ( @NotNull final ComponentEvent e )
{
/**
* We don't need to react to location changes.
* Also call to {@link InterfaceTreeNode#updateNodeLater(InterfaceTree)} causes UI flickering so this is disabled.
*/
}
@Override
public void componentShown ( @NotNull final ComponentEvent e )
{
updateNodeLater ( tree );
}
@Override
public void componentHidden ( @NotNull final ComponentEvent e )
{
updateNodeLater ( tree );
}
};
component.addComponentListener ( componentAdapter );
/**
* It is important to avoid listening to {@link CellRendererPane}.
* It can generates hundreds of events and will clutter us with unnecessary updates.
* This will basically workaround any issues with {@link CellRendererPane} in {@link JTree}, {@link JList} and {@link JTable}.
*/
if ( !( component instanceof CellRendererPane ) )
{
/**
* Additional container listeners.
*/
if ( component instanceof Container )
{
containerAdapter = new ContainerAdapter ()
{
@Override
public void componentAdded ( @NotNull final ContainerEvent e )
{
final Component child = e.getChild ();
if ( tree.accept ( child ) )
{
final InterfaceTreeNode childNode = new InterfaceTreeNode ( tree, child );
tree.addChildNode ( InterfaceTreeNode.this, childNode );
}
}
@Override
public void componentRemoved ( @NotNull final ContainerEvent e )
{
final Component child = e.getChild ();
if ( tree.accept ( child ) )
{
final String nodeId = id ( child );
final InterfaceTreeNode childNode = tree.getNode ( nodeId );
childNode.uninstall ();
tree.removeNode ( childNode );
}
}
};
( ( Container ) component ).addContainerListener ( containerAdapter );
}
/**
* Additional listeners for components using WebLaF-based UI.
* This is checked instead of styling support to avoid issues when WebLaF is not installed as LaF.
*/
if ( component instanceof JComponent )
{
final JComponent jComponent = ( JComponent ) component;
if ( LafUtils.hasWebLafUI ( jComponent ) )
{
styleListener = new StyleAdapter ()
{
@Override
public void skinUpdated ( @NotNull final JComponent component, @NotNull final StyleId styleId )
{
updateNodeLater ( tree );
}
};
StyleManager.addStyleListener ( jComponent, styleListener );
}
}
}
}
}
/**
* Uninstalls component listeners.
*/
protected void uninstall ()
{
// Ensure this is invoked on EDT
WebLookAndFeel.checkEventDispatchThread ();
// Destroying all child nodes first
// We access raw children directly to ensure we don't miss out any if they are currently filtered
final ExTreeModel model = tree.getModel ();
if ( model != null )
{
for ( final InterfaceTreeNode child : model.getRawChildren ( InterfaceTreeNode.this ) )
{
child.uninstall ();
}
}
// Removing all active listeners
final Component component = getUserObject ();
if ( component != null )
{
component.removeComponentListener ( componentAdapter );
if ( containerAdapter != null )
{
( ( Container ) component ).removeContainerListener ( containerAdapter );
}
if ( styleListener != null )
{
StyleManager.removeStyleListener ( ( JComponent ) component, styleListener );
}
componentAdapter = null;
containerAdapter = null;
styleListener = null;
}
else
{
WebLookAndFeel.removeVisibleWindowListener ( tree, visibleWindowListener );
visibleWindowListener = null;
}
}
/**
* Returns component descriptor.
*
* @return component descriptor
*/
@NotNull
protected ComponentPreview getPreview ()
{
final ComponentPreview preview;
final Component component = getUserObject ();
if ( component != null )
{
if ( component instanceof JComponent )
{
if ( StyleManager.isSupported ( ( JComponent ) component ) )
{
preview = wComponentPreview;
}
else
{
preview = jComponentPreview;
}
}
else
{
preview = awtComponentPreview;
}
}
else
{
throw new RuntimeException ( "ComponentPreview is not available for null Component" );
}
return preview;
}
/**
* Performs delayed {@link InterfaceTreeNode} update.
*
* @param tree {@link InterfaceTree}
*/
protected void updateNodeLater ( @NotNull final InterfaceTree tree )
{
CoreSwingUtils.invokeLater ( new Runnable ()
{
@Override
public void run ()
{
tree.updateNode ( InterfaceTreeNode.this );
}
} );
}
/**
* Returns proper node text representation.
* Used to filter nodes in tree and to display its name.
*
* @return proper node text representation
*/
@NotNull
@Override
public String toString ()
{
final Component component = getUserObject ();
return component != null ? getPreview ().getText ( component ) : LM.get ( "weblaf.ex.inspector.windows" );
}
/**
* Returns {@link InterfaceTreeNode} identifier based on the specified {@link Component}.
*
* @param component {@link Component} to return {@link InterfaceTreeNode} identifier for
* @return {@link InterfaceTreeNode} identifier based on the specified {@link Component}
*/
@NotNull
protected static String id ( @Nullable final Component component )
{
return component != null ? Integer.toString ( component.hashCode () ) : ALL_WINDOWS_ID;
}
} © 2015 - 2025 Weber Informatics LLC | Privacy Policy