Files
libreoffice/extensions/source/propctrlr/pushbuttonnavigation.cxx
Jens-Heiner Rechtien 3e7e62f1c1 INTEGRATION: CWS frmcontrols02 (1.1.2); FILE ADDED
2004/02/02 07:46:46 fs 1.1.2.1: initial checkin - helper for push buttons with form navigation functionality
2004-04-13 10:24:49 +00:00

333 lines
12 KiB
C++

/*************************************************************************
*
* $RCSfile: pushbuttonnavigation.cxx,v $
*
* $Revision: 1.2 $
*
* last change: $Author: hr $ $Date: 2004-04-13 11:24:49 $
*
* 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 EXPRESS 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 EXTENSIONS_PROPCTRLR_PUSHBUTTONNAVIGATION_HXX
#include "pushbuttonnavigation.hxx"
#endif
#ifndef _COM_SUN_STAR_FORM_FORMBUTTONTYPE_HPP_
#include <com/sun/star/form/FormButtonType.hpp>
#endif
#ifndef _COM_SUN_STAR_BEANS_XPROPERTYSTATE_HPP_
#include <com/sun/star/beans/XPropertyState.hpp>
#endif
#ifndef _EXTENSIONS_FORMSCTRLR_FORMSTRINGS_HXX_
#include "formstrings.hxx"
#endif
#ifndef _COMPHELPER_EXTRACT_HXX_
#include <cppuhelper/extract.hxx>
#endif
#ifndef _COMPHELPER_PROPERTY_HXX_
#include <comphelper/property.hxx>
#endif
#ifndef _OSL_DIAGNOSE_H_
#include <osl/diagnose.h>
#endif
//............................................................................
namespace pcr
{
//............................................................................
using namespace ::com::sun::star::uno;
using namespace ::com::sun::star::beans;
using namespace ::com::sun::star::form;
//------------------------------------------------------------------------
namespace
{
static const sal_Int32 s_nFirstVirtualButtonType = 1 + (sal_Int32)FormButtonType_URL;
static const sal_Char* pNavigationURLs[] =
{
".uno:FormController/moveToFirst",
".uno:FormController/moveToPrev",
".uno:FormController/moveToNext",
".uno:FormController/moveToLast",
".uno:FormController/saveRecord",
".uno:FormController/undoRecord",
".uno:FormController/moveToNew",
".uno:FormController/deleteRecord",
".uno:FormController/refreshForm",
NULL
};
static sal_Int32 lcl_getNavigationURLIndex( const ::rtl::OUString& _rNavURL )
{
const sal_Char** pLookup = pNavigationURLs;
while ( *pLookup )
{
if ( _rNavURL.equalsAscii( *pLookup ) )
return pLookup - pNavigationURLs;
++pLookup;
}
return -1;
}
static const sal_Char* lcl_getNavigationURL( sal_Int32 _nButtonTypeIndex )
{
const sal_Char** pLookup = pNavigationURLs;
while ( _nButtonTypeIndex-- && *pLookup++ )
;
OSL_ENSURE( *pLookup, "lcl_getNavigationURL: invalid index!" );
return *pLookup;
}
}
//========================================================================
//= PushButtonNavigation
//========================================================================
//------------------------------------------------------------------------
PushButtonNavigation::PushButtonNavigation( const Reference< XPropertySet >& _rxControlModel )
:m_xControlModel( _rxControlModel )
,m_bIsPushButton( sal_False )
{
OSL_ENSURE( m_xControlModel.is(), "PushButtonNavigation::PushButtonNavigation: invalid control model!" );
try
{
m_bIsPushButton = ::comphelper::hasProperty( PROPERTY_BUTTONTYPE, m_xControlModel );
}
catch( const Exception& )
{
OSL_ENSURE( sal_False, "PushButtonNavigation::PushButtonNavigation: caught an exception!" );
}
}
//------------------------------------------------------------------------
sal_Int32 PushButtonNavigation::implGetCurrentButtonType() const SAL_THROW((Exception))
{
sal_Int32 nButtonType = FormButtonType_PUSH;
if ( !m_xControlModel.is() )
return nButtonType;
OSL_VERIFY( ::cppu::enum2int( nButtonType, m_xControlModel->getPropertyValue( PROPERTY_BUTTONTYPE ) ) );
if ( nButtonType == FormButtonType_URL )
{
// there's a chance that this is a "virtual" button type
// (which are realized by special URLs)
::rtl::OUString sTargetURL;
m_xControlModel->getPropertyValue( PROPERTY_TARGET_URL ) >>= sTargetURL;
sal_Int32 nNavigationURLIndex = lcl_getNavigationURLIndex( sTargetURL );
if ( nNavigationURLIndex >= 0)
// it actually *is* a virtual button type
nButtonType = s_nFirstVirtualButtonType + nNavigationURLIndex;
}
return nButtonType;
}
//------------------------------------------------------------------------
Any PushButtonNavigation::getCurrentButtonType() const SAL_THROW(())
{
OSL_ENSURE( m_bIsPushButton, "PushButtonNavigation::getCurrentButtonType: not expected to be called for forms!" );
Any aReturn;
try
{
aReturn <<= implGetCurrentButtonType();
}
catch( const Exception& )
{
OSL_ENSURE( sal_False, "PushButtonNavigation::getCurrentButtonType: caught an exception!" );
}
return aReturn;
}
//------------------------------------------------------------------------
void PushButtonNavigation::setCurrentButtonType( const Any& _rValue ) const SAL_THROW(())
{
OSL_ENSURE( m_bIsPushButton, "PushButtonNavigation::setCurrentButtonType: not expected to be called for forms!" );
if ( !m_xControlModel.is() )
return;
try
{
sal_Int32 nButtonType = FormButtonType_PUSH;
OSL_VERIFY( ::cppu::enum2int( nButtonType, _rValue ) );
::rtl::OUString sTargetURL;
bool bIsVirtualButtonType = nButtonType >= s_nFirstVirtualButtonType;
if ( bIsVirtualButtonType )
{
const sal_Char* pURL = lcl_getNavigationURL( nButtonType - s_nFirstVirtualButtonType );
sTargetURL = ::rtl::OUString::createFromAscii( pURL );
nButtonType = FormButtonType_URL;
}
m_xControlModel->setPropertyValue( PROPERTY_BUTTONTYPE, makeAny( static_cast< FormButtonType >( nButtonType ) ) );
m_xControlModel->setPropertyValue( PROPERTY_TARGET_URL, makeAny( sTargetURL ) );
}
catch( const Exception& )
{
OSL_ENSURE( sal_False, "PushButtonNavigation::setCurrentButtonType: caught an exception!" );
}
}
//------------------------------------------------------------------------
PropertyState PushButtonNavigation::getCurrentButtonTypeState( ) const SAL_THROW(())
{
OSL_ENSURE( m_bIsPushButton, "PushButtonNavigation::getCurrentButtonTypeState: not expected to be called for forms!" );
PropertyState eState = PropertyState_DIRECT_VALUE;
try
{
Reference< XPropertyState > xStateAccess( m_xControlModel, UNO_QUERY );
if ( xStateAccess.is() )
{
// let's say what the model says about the ButtonType property
eState = xStateAccess->getPropertyState( PROPERTY_BUTTONTYPE );
if ( eState == PropertyState_DIRECT_VALUE )
{
sal_Int32 nRealButtonType = FormButtonType_PUSH;
OSL_VERIFY( ::cppu::enum2int( nRealButtonType, m_xControlModel->getPropertyValue( PROPERTY_BUTTONTYPE ) ) );
// perhaps it's one of the virtual button types?
if ( FormButtonType_URL == nRealButtonType )
{
// yes, it is -> rely on the state of the URL property
eState = xStateAccess->getPropertyState( PROPERTY_TARGET_URL );
}
}
}
}
catch( const Exception& )
{
OSL_ENSURE( sal_False, "PushButtonNavigation::getCurrentButtonTypeState: caught an exception!" );
}
return eState;
}
//------------------------------------------------------------------------
Any PushButtonNavigation::getCurrentTargetURL() const SAL_THROW(())
{
Any aReturn;
if ( !m_xControlModel.is() )
return aReturn;
try
{
aReturn = m_xControlModel->getPropertyValue( PROPERTY_TARGET_URL );
if ( m_bIsPushButton )
{
sal_Int32 nCurrentButtonType = implGetCurrentButtonType();
bool bIsVirtualButtonType = nCurrentButtonType >= s_nFirstVirtualButtonType;
if ( bIsVirtualButtonType )
{
// pretend (to the user) that there's no URL set - since
// virtual button types imply a special (technical) URL which
// the user should not see
aReturn <<= ::rtl::OUString();
}
}
}
catch( const Exception& )
{
OSL_ENSURE( sal_False, "PushButtonNavigation::getCurrentTargetURL: caught an exception!" );
}
return aReturn;
}
//------------------------------------------------------------------------
void PushButtonNavigation::setCurrentTargetURL( const Any& _rValue ) const SAL_THROW(())
{
if ( !m_xControlModel.is() )
return;
try
{
m_xControlModel->setPropertyValue( PROPERTY_TARGET_URL, _rValue );
}
catch( const Exception& )
{
OSL_ENSURE( sal_False, "PushButtonNavigation::setCurrentTargetURL: caught an exception!" );
}
}
//------------------------------------------------------------------------
PropertyState PushButtonNavigation::getCurrentTargetURLState( ) const SAL_THROW(())
{
PropertyState eState = PropertyState_DIRECT_VALUE;
try
{
Reference< XPropertyState > xStateAccess( m_xControlModel, UNO_QUERY );
if ( xStateAccess.is() )
{
eState = xStateAccess->getPropertyState( PROPERTY_TARGET_URL );
}
}
catch( const Exception& )
{
OSL_ENSURE( sal_False, "PushButtonNavigation::setCurrentTargetURL: caught an exception!" );
}
return eState;
}
//............................................................................
} // namespace pcr
//............................................................................