2004/11/29 11:24:28 oj 1.2.278.2: RESYNC: (1.2-1.3); FILE MERGED 2004/11/19 15:12:04 fs 1.2.278.1: #i37434# canColorBorder: also take into account the type of the control
486 lines
19 KiB
C++
486 lines
19 KiB
C++
/*************************************************************************
|
|
*
|
|
* $RCSfile: fmcontrolbordermanager.cxx,v $
|
|
*
|
|
* $Revision: 1.4 $
|
|
*
|
|
* last change: $Author: obo $ $Date: 2005-01-05 12:19:59 $
|
|
*
|
|
* The Contents of this file are made available subject to the terms of
|
|
* either of the following licenses
|
|
*
|
|
* - GNU Lesser General Public License Version 2.1
|
|
* - Sun Industry Standards Source License Version 1.1
|
|
*
|
|
* Sun Microsystems Inc., October, 2000
|
|
*
|
|
* GNU Lesser General Public License Version 2.1
|
|
* =============================================
|
|
* Copyright 2000 by Sun Microsystems, Inc.
|
|
* 901 San Antonio Road, Palo Alto, CA 94303, USA
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License version 2.1, as published by the Free Software Foundation.
|
|
*
|
|
* This 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
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the Free Software
|
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston,
|
|
* MA 02111-1307 USA
|
|
*
|
|
*
|
|
* Sun Industry Standards Source License Version 1.1
|
|
* =================================================
|
|
* The contents of this file are subject to the Sun Industry Standards
|
|
* Source License Version 1.1 (the "License"); You may not use this file
|
|
* except in compliance with the License. You may obtain a copy of the
|
|
* License at http://www.openoffice.org/license.html.
|
|
*
|
|
* Software provided under this License is provided on an "AS IS" basis,
|
|
* WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,
|
|
* WITHOUT LIMITATION, WARRANTIES THAT THE SOFTWARE IS FREE OF DEFECTS,
|
|
* MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE, OR NON-INFRINGING.
|
|
* See the License for the specific provisions governing your rights and
|
|
* obligations concerning the Software.
|
|
*
|
|
* The Initial Developer of the Original Code is: Sun Microsystems, Inc.
|
|
*
|
|
* Copyright: 2000 by Sun Microsystems, Inc.
|
|
*
|
|
* All Rights Reserved.
|
|
*
|
|
* Contributor(s): _______________________________________
|
|
*
|
|
*
|
|
************************************************************************/
|
|
|
|
#ifndef SVX_SOURCE_FORM_FMCONTROLBORDERMANAGER_HXX
|
|
#include "fmcontrolbordermanager.hxx"
|
|
#endif
|
|
|
|
#ifndef _SVX_FMPROP_HRC
|
|
#include "fmprop.hrc"
|
|
#endif
|
|
|
|
/** === begin UNO includes === **/
|
|
#ifndef _COM_SUN_STAR_FORM_VALIDATION_XVALIDATABLEFORMCOMPONENT_HPP_
|
|
#include <com/sun/star/form/validation/XValidatableFormComponent.hpp>
|
|
#endif
|
|
#ifndef _COM_SUN_STAR_AWT_XTEXTCOMPONENT_HPP_
|
|
#include <com/sun/star/awt/XTextComponent.hpp>
|
|
#endif
|
|
#ifndef _COM_SUN_STAR_AWT_XLISTBOX_HPP_
|
|
#include <com/sun/star/awt/XListBox.hpp>
|
|
#endif
|
|
/** === end UNO includes === **/
|
|
|
|
#ifndef _TOOLS_DEBUG_HXX
|
|
#include <tools/debug.hxx>
|
|
#endif
|
|
|
|
//........................................................................
|
|
namespace svxform
|
|
{
|
|
//........................................................................
|
|
|
|
using namespace ::com::sun::star::uno;
|
|
using namespace ::com::sun::star::awt;
|
|
using namespace ::com::sun::star::form::validation;
|
|
|
|
//====================================================================
|
|
//= helper
|
|
//====================================================================
|
|
//--------------------------------------------------------------------
|
|
static void setUnderline( const Reference< XVclWindowPeer >& _rxPeer, const UnderlineDescriptor& _rUnderline )
|
|
{
|
|
OSL_ENSURE( _rxPeer.is(), "setUnderline: invalid peer!" );
|
|
|
|
// the underline type is an aspect of the font
|
|
FontDescriptor aFont;
|
|
OSL_VERIFY( _rxPeer->getProperty( FM_PROP_FONT ) >>= aFont );
|
|
aFont.Underline = _rUnderline.nUnderlineType;
|
|
_rxPeer->setProperty( FM_PROP_FONT, makeAny( aFont ) );
|
|
// the underline color is a separate property
|
|
_rxPeer->setProperty( FM_PROP_TEXTLINECOLOR, makeAny( _rUnderline.nUnderlineColor ) );
|
|
}
|
|
|
|
//--------------------------------------------------------------------
|
|
static void getUnderline( const Reference< XVclWindowPeer >& _rxPeer, UnderlineDescriptor& _rUnderline )
|
|
{
|
|
OSL_ENSURE( _rxPeer.is(), "getUnderline: invalid peer!" );
|
|
|
|
FontDescriptor aFont;
|
|
OSL_VERIFY( _rxPeer->getProperty( FM_PROP_FONT ) >>= aFont );
|
|
_rUnderline.nUnderlineType = aFont.Underline;
|
|
|
|
OSL_VERIFY( _rxPeer->getProperty( FM_PROP_TEXTLINECOLOR ) >>= _rUnderline.nUnderlineColor );
|
|
}
|
|
|
|
//--------------------------------------------------------------------
|
|
static void getBorder( const Reference< XVclWindowPeer >& _rxPeer, BorderDescriptor& _rBoder )
|
|
{
|
|
OSL_ENSURE( _rxPeer.is(), "getBorder: invalid peer!" );
|
|
|
|
OSL_VERIFY( _rxPeer->getProperty( FM_PROP_BORDER ) >>= _rBoder.nBorderType );
|
|
OSL_VERIFY( _rxPeer->getProperty( FM_PROP_BORDERCOLOR ) >>= _rBoder.nBorderColor );
|
|
}
|
|
|
|
//--------------------------------------------------------------------
|
|
static void setBorder( const Reference< XVclWindowPeer >& _rxPeer, const BorderDescriptor& _rBoder )
|
|
{
|
|
OSL_ENSURE( _rxPeer.is(), "setBorder: invalid peer!" );
|
|
|
|
_rxPeer->setProperty( FM_PROP_BORDER, makeAny( _rBoder.nBorderType ) );
|
|
_rxPeer->setProperty( FM_PROP_BORDERCOLOR, makeAny( _rBoder.nBorderColor ) );
|
|
}
|
|
|
|
//====================================================================
|
|
//= ControlBorderManager
|
|
//====================================================================
|
|
//--------------------------------------------------------------------
|
|
ControlBorderManager::ControlBorderManager()
|
|
:m_bDynamicBorderColors( false )
|
|
,m_nFocusColor ( 0x000000FF )
|
|
,m_nMouseHoveColor( 0x007098BE )
|
|
,m_nInvalidColor ( 0x00FF0000 )
|
|
{
|
|
}
|
|
|
|
//--------------------------------------------------------------------
|
|
ControlBorderManager::~ControlBorderManager()
|
|
{
|
|
}
|
|
|
|
//--------------------------------------------------------------------
|
|
bool ControlBorderManager::canColorBorder( const Reference< XVclWindowPeer >& _rxPeer )
|
|
{
|
|
OSL_PRECOND( _rxPeer.is(), "ControlBorderManager::canColorBorder: invalid peer!" );
|
|
|
|
PeerBag::const_iterator aPos = m_aColorableControls.find( _rxPeer );
|
|
if ( aPos != m_aColorableControls.end() )
|
|
return true;
|
|
|
|
aPos = m_aNonColorableControls.find( _rxPeer );
|
|
if ( aPos != m_aNonColorableControls.end() )
|
|
return false;
|
|
|
|
// this peer is not yet known
|
|
|
|
// no border coloring for controls which are not for text input
|
|
// #i37434# / 2004-11-19 / frank.schoenheit@sun.com
|
|
Reference< XTextComponent > xText( _rxPeer, UNO_QUERY );
|
|
Reference< XListBox > xListBox( _rxPeer, UNO_QUERY );
|
|
if ( xText.is() || xListBox.is() )
|
|
{
|
|
sal_Int16 nBorderStyle = VisualEffect::NONE;
|
|
OSL_VERIFY( _rxPeer->getProperty( FM_PROP_BORDER ) >>= nBorderStyle );
|
|
if ( nBorderStyle == VisualEffect::FLAT )
|
|
// if you change this to also accept LOOK3D, then this would also work, but look ugly
|
|
{
|
|
m_aColorableControls.insert( _rxPeer );
|
|
return true;
|
|
}
|
|
}
|
|
|
|
m_aNonColorableControls.insert( _rxPeer );
|
|
return false;
|
|
}
|
|
|
|
//--------------------------------------------------------------------
|
|
ControlStatus ControlBorderManager::getControlStatus( const Reference< XControl >& _rxControl ) SAL_THROW(())
|
|
{
|
|
ControlStatus nStatus = CONTROL_STATUS_NONE;
|
|
|
|
if ( _rxControl.get() == m_aFocusControl.xControl.get() )
|
|
nStatus |= CONTROL_STATUS_FOCUSED;
|
|
|
|
if ( _rxControl.get() == m_aMouseHoverControl.xControl.get() )
|
|
nStatus |= CONTROL_STATUS_MOUSE_HOVER;
|
|
|
|
if ( m_aInvalidControls.find( ControlData( _rxControl ) ) != m_aInvalidControls.end() )
|
|
nStatus |= CONTROL_STATUS_INVALID;
|
|
|
|
return nStatus;
|
|
}
|
|
|
|
//--------------------------------------------------------------------
|
|
sal_Int32 ControlBorderManager::getControlColorByStatus( ControlStatus _nStatus )
|
|
{
|
|
// "invalid" is ranked highest
|
|
if ( _nStatus & CONTROL_STATUS_INVALID )
|
|
return m_nInvalidColor;
|
|
|
|
// then, "focused" is more important than ...
|
|
if ( _nStatus & CONTROL_STATUS_FOCUSED )
|
|
return m_nFocusColor;
|
|
|
|
// ... "mouse over"
|
|
if ( _nStatus & CONTROL_STATUS_MOUSE_HOVER )
|
|
return m_nMouseHoveColor;
|
|
|
|
OSL_ENSURE( sal_False, "ControlBorderManager::getControlColorByStatus: invalid status!" );
|
|
return 0x00000000;
|
|
}
|
|
|
|
//--------------------------------------------------------------------
|
|
void ControlBorderManager::updateBorderStyle( const Reference< XControl >& _rxControl, const Reference< XVclWindowPeer >& _rxPeer, const BorderDescriptor& _rFallback ) SAL_THROW(())
|
|
{
|
|
OSL_PRECOND( _rxControl.is() && _rxPeer.is(), "ControlBorderManager::updateBorderStyle: invalid parameters!" );
|
|
|
|
ControlStatus nStatus = getControlStatus( _rxControl );
|
|
BorderDescriptor aBorder;
|
|
aBorder.nBorderType = ( nStatus == CONTROL_STATUS_NONE )
|
|
? _rFallback.nBorderType
|
|
: VisualEffect::FLAT;
|
|
aBorder.nBorderColor = ( nStatus == CONTROL_STATUS_NONE )
|
|
? _rFallback.nBorderColor
|
|
: getControlColorByStatus( nStatus );
|
|
setBorder( _rxPeer, aBorder );
|
|
}
|
|
|
|
//--------------------------------------------------------------------
|
|
void ControlBorderManager::determineOriginalBorderStyle( const Reference< XControl >& _rxControl, BorderDescriptor& _rData ) const
|
|
{
|
|
_rData = ControlData();
|
|
if ( m_aFocusControl.xControl.get() == _rxControl.get() )
|
|
{
|
|
_rData = m_aFocusControl;
|
|
}
|
|
else if ( m_aMouseHoverControl.xControl.get() == _rxControl.get() )
|
|
{
|
|
_rData = m_aMouseHoverControl;
|
|
}
|
|
else
|
|
{
|
|
ControlBag::const_iterator aPos = m_aInvalidControls.find( _rxControl );
|
|
if ( aPos != m_aInvalidControls.end() )
|
|
{
|
|
_rData = *aPos;
|
|
}
|
|
else
|
|
{
|
|
Reference< XVclWindowPeer > xPeer( _rxControl->getPeer(), UNO_QUERY );
|
|
getBorder( xPeer, _rData );
|
|
}
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------
|
|
void ControlBorderManager::controlStatusGained( const Reference< XInterface >& _rxControl, ControlData& _rControlData ) SAL_THROW(())
|
|
{
|
|
if ( _rxControl == _rControlData.xControl )
|
|
// nothing to do - though suspicious
|
|
return;
|
|
|
|
Reference< XControl > xAsControl( _rxControl, UNO_QUERY );
|
|
DBG_ASSERT( xAsControl.is(), "ControlBorderManager::controlStatusGained: invalid control!" );
|
|
if ( !xAsControl.is() )
|
|
return;
|
|
|
|
try
|
|
{
|
|
Reference< XVclWindowPeer > xPeer( xAsControl->getPeer(), UNO_QUERY );
|
|
if ( xPeer.is() && canColorBorder( xPeer ) )
|
|
{
|
|
// remember the control and it's current border color
|
|
_rControlData.xControl.clear(); // so determineOriginalBorderStyle doesn't get confused
|
|
|
|
determineOriginalBorderStyle( xAsControl, _rControlData );
|
|
|
|
_rControlData.xControl = xAsControl;
|
|
|
|
updateBorderStyle( xAsControl, xPeer, _rControlData );
|
|
}
|
|
}
|
|
catch( const Exception& )
|
|
{
|
|
OSL_ENSURE( sal_False, "ControlBorderManager::controlStatusGained: caught an exception!" );
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------
|
|
void ControlBorderManager::controlStatusLost( const Reference< XInterface >& _rxControl, ControlData& _rControlData ) SAL_THROW(())
|
|
{
|
|
if ( _rxControl != _rControlData.xControl )
|
|
// nothing to do
|
|
return;
|
|
|
|
OSL_PRECOND( _rControlData.xControl.is(), "ControlBorderManager::controlStatusLost: invalid control data - this will crash!" );
|
|
try
|
|
{
|
|
Reference< XVclWindowPeer > xPeer( _rControlData.xControl->getPeer(), UNO_QUERY );
|
|
if ( xPeer.is() && canColorBorder( xPeer ) )
|
|
{
|
|
ControlData aPreviousStatus( _rControlData );
|
|
_rControlData = ControlData();
|
|
updateBorderStyle( aPreviousStatus.xControl, xPeer, aPreviousStatus );
|
|
}
|
|
}
|
|
catch( const Exception& )
|
|
{
|
|
OSL_ENSURE( sal_False, "ControlBorderManager::controlStatusLost: caught an exception!" );
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------
|
|
void ControlBorderManager::enableDynamicBorderColor( )
|
|
{
|
|
m_bDynamicBorderColors = true;
|
|
}
|
|
|
|
//--------------------------------------------------------------------
|
|
void ControlBorderManager::disableDynamicBorderColor( )
|
|
{
|
|
m_bDynamicBorderColors = false;
|
|
restoreAll();
|
|
}
|
|
|
|
//--------------------------------------------------------------------
|
|
void ControlBorderManager::setStatusColor( ControlStatus _nStatus, sal_Int32 _nColor )
|
|
{
|
|
switch ( _nStatus )
|
|
{
|
|
case CONTROL_STATUS_FOCUSED:
|
|
m_nFocusColor = _nColor;
|
|
break;
|
|
case CONTROL_STATUS_MOUSE_HOVER:
|
|
m_nMouseHoveColor = _nColor;
|
|
break;
|
|
case CONTROL_STATUS_INVALID:
|
|
m_nInvalidColor = _nColor;
|
|
break;
|
|
default:
|
|
OSL_ENSURE( sal_False, "ControlBorderManager::setStatusColor: invalid status!" );
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------
|
|
void ControlBorderManager::restoreAll()
|
|
{
|
|
if ( m_aFocusControl.xControl.is() )
|
|
controlStatusLost( m_aFocusControl.xControl, m_aFocusControl );
|
|
if ( m_aMouseHoverControl.xControl.is() )
|
|
controlStatusLost( m_aMouseHoverControl.xControl, m_aMouseHoverControl );
|
|
|
|
ControlBag aInvalidControls;
|
|
m_aInvalidControls.swap( aInvalidControls );
|
|
|
|
for ( ControlBag::const_iterator loop = aInvalidControls.begin();
|
|
loop != aInvalidControls.end();
|
|
++loop
|
|
)
|
|
{
|
|
Reference< XVclWindowPeer > xPeer( loop->xControl->getPeer(), UNO_QUERY );
|
|
if ( xPeer.is() )
|
|
{
|
|
updateBorderStyle( loop->xControl, xPeer, *loop );
|
|
xPeer->setProperty( FM_PROP_HELPTEXT, makeAny( loop->sOriginalHelpText ) );
|
|
setUnderline( xPeer, *loop );
|
|
}
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------
|
|
void ControlBorderManager::focusGained( const Reference< XInterface >& _rxControl ) SAL_THROW(())
|
|
{
|
|
if ( m_bDynamicBorderColors )
|
|
controlStatusGained( _rxControl, m_aFocusControl );
|
|
}
|
|
|
|
//--------------------------------------------------------------------
|
|
void ControlBorderManager::focusLost( const Reference< XInterface >& _rxControl ) SAL_THROW(())
|
|
{
|
|
if ( m_bDynamicBorderColors )
|
|
controlStatusLost( _rxControl, m_aFocusControl );
|
|
}
|
|
|
|
//--------------------------------------------------------------------
|
|
void ControlBorderManager::mouseEntered( const Reference< XInterface >& _rxControl ) SAL_THROW(())
|
|
{
|
|
if ( m_bDynamicBorderColors )
|
|
controlStatusGained( _rxControl, m_aMouseHoverControl );
|
|
}
|
|
|
|
//--------------------------------------------------------------------
|
|
void ControlBorderManager::mouseExited( const Reference< XInterface >& _rxControl ) SAL_THROW(())
|
|
{
|
|
if ( m_bDynamicBorderColors )
|
|
controlStatusLost( _rxControl, m_aMouseHoverControl );
|
|
}
|
|
|
|
//--------------------------------------------------------------------
|
|
void ControlBorderManager::validityChanged( const Reference< XControl >& _rxControl, const Reference< XValidatableFormComponent >& _rxValidatable ) SAL_THROW(())
|
|
{
|
|
try
|
|
{
|
|
Reference< XVclWindowPeer > xPeer( _rxControl.is() ? _rxControl->getPeer() : Reference< XWindowPeer >(), UNO_QUERY );
|
|
OSL_ENSURE( xPeer.is(), "ControlBorderManager::validityChanged: invalid control/peer!" );
|
|
OSL_ENSURE( _rxValidatable.is(), "ControlBorderManager::validityChanged: invalid validatable!" );
|
|
|
|
if ( !xPeer.is() || !_rxValidatable.is() )
|
|
return;
|
|
|
|
ControlData aData( _rxControl );
|
|
|
|
if ( _rxValidatable->isValid() )
|
|
{
|
|
ControlBag::iterator aPos = m_aInvalidControls.find( aData );
|
|
if ( aPos != m_aInvalidControls.end() )
|
|
{ // invalid before, valid now
|
|
ControlData aOriginalLayout( *aPos );
|
|
m_aInvalidControls.erase( aPos );
|
|
|
|
// restore all the things we used to indicate invalidity
|
|
if ( m_bDynamicBorderColors )
|
|
updateBorderStyle( _rxControl, xPeer, aOriginalLayout );
|
|
xPeer->setProperty( FM_PROP_HELPTEXT, makeAny( aOriginalLayout.sOriginalHelpText ) );
|
|
setUnderline( xPeer, aOriginalLayout );
|
|
}
|
|
return;
|
|
}
|
|
|
|
// we're here in the INVALID case
|
|
if ( m_aInvalidControls.find( _rxControl ) == m_aInvalidControls.end() )
|
|
{ // valid before, invalid now
|
|
|
|
// remember the current border
|
|
determineOriginalBorderStyle( _rxControl, aData );
|
|
// and tool tip
|
|
xPeer->getProperty( FM_PROP_HELPTEXT ) >>= aData.sOriginalHelpText;
|
|
// and font
|
|
getUnderline( xPeer, aData );
|
|
|
|
m_aInvalidControls.insert( aData );
|
|
|
|
// update the border to the new invalidity
|
|
if ( m_bDynamicBorderColors && canColorBorder( xPeer ) )
|
|
updateBorderStyle( _rxControl, xPeer, aData );
|
|
else
|
|
{
|
|
// and also the new font
|
|
setUnderline( xPeer, UnderlineDescriptor( FontUnderline::WAVE, m_nInvalidColor ) );
|
|
}
|
|
}
|
|
|
|
// update the explanation for invalidity (this is always done, even if the validity did not change)
|
|
Reference< XValidator > xValidator = _rxValidatable->getValidator();
|
|
OSL_ENSURE( xValidator.is(), "ControlBorderManager::validityChanged: invalid, but no validator?" );
|
|
::rtl::OUString sExplainInvalidity = xValidator.is() ? xValidator->explainInvalid( _rxValidatable->getCurrentValue() ) : ::rtl::OUString();
|
|
xPeer->setProperty( FM_PROP_HELPTEXT, makeAny( sExplainInvalidity ) );
|
|
}
|
|
catch( const Exception& )
|
|
{
|
|
OSL_ENSURE( sal_False, "ControlBorderManager::validityChanged: caught an exception!" );
|
|
}
|
|
}
|
|
|
|
//........................................................................
|
|
} // namespace svxform
|
|
//........................................................................
|
|
|