com.alee.extended.window.WebPopOver Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of weblaf-ui Show documentation
Show all versions of weblaf-ui Show documentation
WebLaf is a Java Swing Look and Feel and extended components library for cross-platform applications
/*
* 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 ()
{
@Override
public Rectangle provide ()
{
return bounds;
}
}, direction, alignment );
}
/**
* Displays WebPopOver attached to the invoker component area and faced to specified direction.
* It will also be aligned using the specified alignment type when possible.
* WebPopOver opened in this way will always auto-follow invoker's ancestor window.
*
* @param invoker invoker component
* @param boundsProvider source area provider
* @return displayed WebPopOver
*/
public WebPopOver show ( final Component invoker, final DataProvider boundsProvider )
{
return show ( invoker, boundsProvider, PopOverDirection.down );
}
/**
* Displays WebPopOver attached to the invoker component area and faced to specified direction.
* It will also be aligned using the specified alignment type when possible.
* WebPopOver opened in this way will always auto-follow invoker's ancestor window.
*
* @param invoker invoker component
* @param boundsProvider source area provider
* @param direction preferred display direction
* @return displayed WebPopOver
*/
public WebPopOver show ( final Component invoker, final DataProvider boundsProvider, final PopOverDirection direction )
{
return show ( invoker, boundsProvider, direction, PopOverAlignment.centered );
}
/**
* Displays WebPopOver attached to the invoker component area and faced to specified direction.
* It will also be aligned using the specified alignment type when possible.
* WebPopOver opened in this way will always auto-follow invoker's ancestor window.
*
* @param invoker invoker component
* @param boundsProvider source area provider
* @param direction preferred display direction
* @param alignment preferred display alignment
* @return displayed WebPopOver
*/
public WebPopOver show ( final Component invoker, final DataProvider boundsProvider, final PopOverDirection direction,
final PopOverAlignment alignment )
{
// Performing pre-open operations
preOpen ();
// Configuring popover position
final IPopOverPainter painter = getPainter ();
if ( painter != null )
{
painter.configure ( this, invoker, boundsProvider, direction, alignment );
}
// Displaying popover
setVisible ( true );
// Performing post-open operations
postOpen ();
return this;
}
/**
* Returns popover painter.
*
* @return popover painter
*/
protected IPopOverPainter getPainter ()
{
final Painter painter = getWebUI ().getPainter ();
return painter instanceof IPopOverPainter ? ( IPopOverPainter ) painter : null;
}
/**
* Performs popover pre-open operations.
*/
protected void preOpen ()
{
// Fire opening event
fireOpening ();
// Fire reopened event
// This event is fired before any show operation repeated
if ( isShowing () )
{
fireReopened ();
}
}
/**
* Performs popover post-open operations.
*/
protected void postOpen ()
{
// Fire opened event
// Note that if this pop-over is modal this event will be fired only after it is closed
// Unfortunately there is no good way to provide this event after dialog is opened but before it is closed in that case
fireOpened ();
}
/**
* Adds pop-over listener.
*
* @param listener pop-over listener
*/
public void addPopOverListener ( final PopOverListener listener )
{
listenerList.add ( PopOverListener.class, listener );
}
/**
* Removes pop-over listener.
*
* @param listener pop-over listener
*/
public void removePopOverListener ( final PopOverListener listener )
{
listenerList.remove ( PopOverListener.class, listener );
}
/**
* Informs that WebPopOver is being opened.
*/
public void fireOpening ()
{
for ( final PopOverListener listener : listenerList.getListeners ( PopOverListener.class ) )
{
listener.opening ( this );
}
}
/**
* Informs that WebPopOver was opened.
*/
public void fireOpened ()
{
for ( final PopOverListener listener : listenerList.getListeners ( PopOverListener.class ) )
{
listener.opened ( this );
}
}
/**
* Informs that WebPopOver.show was called while it was opened forcing it to update location.
*/
public void fireReopened ()
{
for ( final PopOverListener listener : listenerList.getListeners ( PopOverListener.class ) )
{
listener.reopened ( this );
}
}
/**
* Informs that user dragged WebPopOver so that it became unattached from invoker component.
*/
public void fireDetached ()
{
for ( final PopOverListener listener : listenerList.getListeners ( PopOverListener.class ) )
{
listener.detached ( this );
}
}
/**
* Informs that WebPopOver was closed due to losing focus or some other cause.
*/
public void fireClosed ()
{
for ( final PopOverListener listener : listenerList.getListeners ( PopOverListener.class ) )
{
listener.closed ( this );
}
}
@Override
public PopOverAdapter onOpen ( final PopOverEventRunnable runnable )
{
return EventUtils.onOpen ( this, runnable );
}
@Override
public PopOverAdapter onReopen ( final PopOverEventRunnable runnable )
{
return EventUtils.onReopen ( this, runnable );
}
@Override
public PopOverAdapter onDetach ( final PopOverEventRunnable runnable )
{
return EventUtils.onDetach ( this, runnable );
}
@Override
public PopOverAdapter onClose ( final PopOverEventRunnable runnable )
{
return EventUtils.onClose ( this, runnable );
}
}