Files
libreoffice/extensions/source/propctrlr/buttonnavigationhandler.cxx
Vladimir Glazounov e3c976a4d6 INTEGRATION: CWS pbrwuno (1.3.130); FILE MERGED
2006/02/15 07:25:51 fs 1.3.130.12: don't access &(*foo.begin()) of empty STL containers
2005/11/02 11:43:36 fs 1.3.130.11: #i10000# exception specifications
2005/10/25 11:52:39 fs 1.3.130.10: #i53095# some exception specifications, and some conceptual changes for multiple handlers supporting the same property
2005/10/25 07:13:05 fs 1.3.130.9: #i53095# knitting lose ends (amongst others, make the handlers available as service)
2005/10/17 08:58:14 fs 1.3.130.8: some mutex locking
2005/10/13 13:00:57 fs 1.3.130.7: #i53095# introduce an XObjectInspector/Model
2005/10/11 13:28:48 fs 1.3.130.6: #i53095# phase 3:
introduced XPropertyHandler and XObjectInspectorUI
same open issues as in previous phase
(plus probably some more, since not everything is tested, yet :-\)
2005/10/05 06:50:45 fs 1.3.130.5: RESYNC: (1.3-1.4); FILE MERGED
2005/08/18 12:44:26 fs 1.3.130.4: #i53095#, phase 2

moved (nearly) all property handling to dedicated handlers, the controller is
now simply managing a set of handlers

open issues for making the property browser completely generic:
- target page for a property - at the moment, the pbrw uses form-specific
  knowledge
- relative position of properties. Again, the pbrw uses the OPropertyInfoService
  which is not generic
- isComposeable for a given property. Also OPropertyInfoService-dependent ATM
- help ids of pages and the pbrw as a whole. They're hard-coded at the moment

other open issues:
everything in the code which is tagged with TOD/UNOize. Those are items which
do not immediately hinder phase 3 (real UNOization, i.e. definition of new
UNO interfaces for the handlers, the controller, and so on), but need to be
addressed in phase 4 (knit lose ends)
2005/08/16 05:38:55 fs 1.3.130.3: #i53095# completely moved the handling of actuating properties into dedicated handlers
2005/08/10 15:41:43 fs 1.3.130.2: #i53095#
get rid of nearly all [1] the implementations in OPropertyBrowserController::Clicked,
and move them to a FormComponentHandler

[1] still to migrate:
- browsing for events (needs a dedicated event property handler)
- handling for clicking the button of the Command property - this
  is kind of asynchronous, and IPropertyHandler is not yet prepared for this
2005/08/09 13:59:55 fs 1.3.130.1: #i53095# phase 1:
- don't use strings to transver values between controls and introspectee, but Anys
- first version of a dedicated property handler for form-component-related properties
  (not yet completed)
known regressions over previous phase:
- handlers for events not yet implemented, thus some assertions
- click handlers for form-component-related properties do not yet work,
  thus the browse buttons mostly do not work
2006-03-14 10:18:38 +00:00

227 lines
8.1 KiB
C++

/*************************************************************************
*
* OpenOffice.org - a multi-platform office productivity suite
*
* $RCSfile: buttonnavigationhandler.cxx,v $
*
* $Revision: 1.5 $
*
* last change: $Author: vg $ $Date: 2006-03-14 11:18:38 $
*
* The Contents of this file are made available subject to
* the terms of GNU Lesser General Public License Version 2.1.
*
*
* GNU Lesser General Public License Version 2.1
* =============================================
* Copyright 2005 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
*
************************************************************************/
#ifndef EXTENSIONS_SOURCE_PROPCTRLR_BUTTONNAVIGATIONHANDLER_HXX
#include "buttonnavigationhandler.hxx"
#endif
#ifndef _EXTENSIONS_FORMSCTRLR_FORMSTRINGS_HXX_
#include "formstrings.hxx"
#endif
#ifndef _EXTENSIONS_PROPCTRLR_FORMMETADATA_HXX_
#include "formmetadata.hxx"
#endif
#ifndef EXTENSIONS_PROPCTRLR_PUSHBUTTONNAVIGATION_HXX
#include "pushbuttonnavigation.hxx"
#endif
/** === begin UNO includes === **/
#ifndef _COM_SUN_STAR_FORM_FORMBUTTONTYPE_HPP_
#include <com/sun/star/form/FormButtonType.hpp>
#endif
/** === end UNO includes === **/
#ifndef _TOOLS_DEBUG_HXX
#include <tools/debug.hxx>
#endif
//------------------------------------------------------------------------
extern "C" void SAL_CALL createRegistryInfo_ButtonNavigationHandler()
{
::pcr::ButtonNavigationHandler::registerImplementation();
}
//........................................................................
namespace pcr
{
//........................................................................
using namespace ::com::sun::star::uno;
using namespace ::com::sun::star::lang;
using namespace ::com::sun::star::beans;
using namespace ::com::sun::star::script;
using namespace ::com::sun::star::form;
using namespace ::com::sun::star::frame;
//====================================================================
//= ButtonNavigationHandler
//====================================================================
DBG_NAME( ButtonNavigationHandler )
//--------------------------------------------------------------------
ButtonNavigationHandler::ButtonNavigationHandler( const Reference< XComponentContext >& _rxContext )
:ButtonNavigationHandler_Base( _rxContext )
{
DBG_CTOR( ButtonNavigationHandler, NULL );
}
//--------------------------------------------------------------------
ButtonNavigationHandler::~ButtonNavigationHandler( )
{
DBG_DTOR( ButtonNavigationHandler, NULL );
}
//--------------------------------------------------------------------
::rtl::OUString SAL_CALL ButtonNavigationHandler::getImplementationName_static( ) throw (RuntimeException)
{
return ::rtl::OUString( RTL_CONSTASCII_USTRINGPARAM( "com.sun.star.comp.extensions.ButtonNavigationHandler" ) );
}
//--------------------------------------------------------------------
Sequence< ::rtl::OUString > SAL_CALL ButtonNavigationHandler::getSupportedServiceNames_static( ) throw (RuntimeException)
{
Sequence< ::rtl::OUString > aSupported( 1 );
aSupported[0] = ::rtl::OUString( RTL_CONSTASCII_USTRINGPARAM( "com.sun.star.form.inspection.ButtonNavigationHandler" ) );
return aSupported;
}
//--------------------------------------------------------------------
PropertyState SAL_CALL ButtonNavigationHandler::getPropertyState( const ::rtl::OUString& _rPropertyName ) throw (UnknownPropertyException, RuntimeException)
{
::osl::MutexGuard aGuard( m_aMutex );
PropertyId nPropId( impl_getPropertyId_throw( _rPropertyName ) );
PropertyState eState = PropertyState_DIRECT_VALUE;
switch ( nPropId )
{
case PROPERTY_ID_BUTTONTYPE:
{
PushButtonNavigation aHelper( m_xComponent );
eState = aHelper.getCurrentButtonTypeState();
}
break;
case PROPERTY_ID_TARGET_URL:
{
PushButtonNavigation aHelper( m_xComponent );
eState = aHelper.getCurrentTargetURLState();
}
break;
default:
DBG_ERROR( "ButtonNavigationHandler::getPropertyState: cannot handle this property!" );
break;
}
return eState;
}
//--------------------------------------------------------------------
Any SAL_CALL ButtonNavigationHandler::getPropertyValue( const ::rtl::OUString& _rPropertyName ) throw (UnknownPropertyException, RuntimeException)
{
::osl::MutexGuard aGuard( m_aMutex );
PropertyId nPropId( impl_getPropertyId_throw( _rPropertyName ) );
Any aReturn;
switch ( nPropId )
{
case PROPERTY_ID_BUTTONTYPE:
{
PushButtonNavigation aHelper( m_xComponent );
aReturn = aHelper.getCurrentButtonType();
}
break;
case PROPERTY_ID_TARGET_URL:
{
PushButtonNavigation aHelper( m_xComponent );
aReturn = aHelper.getCurrentTargetURL();
}
break;
default:
DBG_ERROR( "ButtonNavigationHandler::getPropertyValue: cannot handle this property!" );
break;
}
return aReturn;
}
//--------------------------------------------------------------------
void SAL_CALL ButtonNavigationHandler::setPropertyValue( const ::rtl::OUString& _rPropertyName, const Any& _rValue ) throw (UnknownPropertyException, RuntimeException)
{
::osl::MutexGuard aGuard( m_aMutex );
PropertyId nPropId( impl_getPropertyId_throw( _rPropertyName ) );
switch ( nPropId )
{
case PROPERTY_ID_BUTTONTYPE:
{
PushButtonNavigation aHelper( m_xComponent );
aHelper.setCurrentButtonType( _rValue );
}
break;
case PROPERTY_ID_TARGET_URL:
{
PushButtonNavigation aHelper( m_xComponent );
aHelper.setCurrentTargetURL( _rValue );
}
break;
default:
OSL_ENSURE( sal_False, "ButtonNavigationHandler::setPropertyValue: cannot handle this id!" );
}
}
//--------------------------------------------------------------------
bool ButtonNavigationHandler::isNavigationCapableButton( const Reference< XPropertySet >& _rxComponent )
{
Reference< XPropertySetInfo > xPSI;
if ( _rxComponent.is() )
xPSI = _rxComponent->getPropertySetInfo();
return xPSI.is()
&& xPSI->hasPropertyByName( PROPERTY_TARGET_URL )
&& xPSI->hasPropertyByName( PROPERTY_BUTTONTYPE );
}
//--------------------------------------------------------------------
Sequence< Property > SAL_CALL ButtonNavigationHandler::doDescribeSupportedProperties() const
{
::std::vector< Property > aProperties;
if ( isNavigationCapableButton( m_xComponent ) )
{
addStringPropertyDescription( aProperties, PROPERTY_TARGET_URL );
implAddPropertyDescription( aProperties, PROPERTY_BUTTONTYPE, ::getCppuType( static_cast< FormButtonType* >( NULL ) ) );
}
if ( aProperties.empty() )
return Sequence< Property >();
return Sequence< Property >( &(*aProperties.begin()), aProperties.size() );
}
//........................................................................
} // namespace pcr
//........................................................................