wangxin/loongoffice
1
0
Fork 0
forked from amazingfate/loongoffice
Code Pull Requests Activity
Files
e4401ac1fa2c8dd42dcd61985ffebc8ea253b52b
loongoffice/framework/source/services/desktop.cxx
Rüdiger Timm 3ab7e8aff8 INTEGRATION: CWS binfilter (1.49.64); FILE MERGED 
2004/04/05 12:56:38 aw 1.49.64.3: RESYNC: (1.50-1.51); FILE MERGED
2004/02/05 13:05:27 aw 1.49.64.2: RESYNC: (1.49-1.50); FILE MERGED
2003/07/18 12:22:53 aw 1.49.64.1: #110897#
See the task. All changes to avoid usage of getProcessServiceManager().
2004-05-03 12:21:43 +00:00

2180 lines
108 KiB
C++
Raw Blame History

/*************************************************************************
*
* $RCSfile: desktop.cxx,v $
*
* $Revision: 1.52 $
*
* last change: $Author: rt $ $Date: 2004-05-03 13:21:43 $
*
* 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): _______________________________________
*
*
************************************************************************/
//_________________________________________________________________________________________________________________
// my own includes
//_________________________________________________________________________________________________________________
#ifndef __FRAMEWORK_LOADENV_LOADENV_HXX_
#include <loadenv/loadenv.hxx>
#endif
#ifndef __FRAMEWORK_LOADENV_TARGETHELPER_HXX_
#include <loadenv/targethelper.hxx>
#endif
#ifndef __FRAMEWORK_DESKTOP_HXX_
#include <services/desktop.hxx>
#endif
#ifndef __FRAMEWORK_HELPER_OCOMPONENTACCESS_HXX_
#include <helper/ocomponentaccess.hxx>
#endif
#ifndef __FRAMEWORK_DISPATCH_DISPATCHPROVIDER_HXX_
#include <dispatch/dispatchprovider.hxx>
#endif
#ifndef __FRAMEWORK_DISPATCH_INTERCEPTIONHELPER_HXX_
#include <dispatch/interceptionhelper.hxx>
#endif
#ifndef __FRAMEWORK_CLASSES_TASKCREATOR_HXX_
#include <classes/taskcreator.hxx>
#endif
#ifndef __FRAMEWORK_CLASSES_TARGETFINDER_HXX_
#include <classes/targetfinder.hxx>
#endif
#ifndef __FRAMEWORK_THREADHELP_TRANSACTIONGUARD_HXX_
#include <threadhelp/transactionguard.hxx>
#endif
#ifndef __FRAMEWORK_THREADHELP_WRITEGUARD_HXX_
#include <threadhelp/writeguard.hxx>
#endif
#ifndef __FRAMEWORK_THREADHELP_READGUARD_HXX_
#include <threadhelp/readguard.hxx>
#endif
#ifndef __FRAMEWORK_SERVICES_H_
#include <services.h>
#endif
#ifndef __FRAMEWORK_GENERAL_H_
#include <general.h>
#endif
#ifndef __FRAMEWORK_PROPERTIES_H_
#include <properties.h>
#endif
#include <services/documentlist.hxx>
//_________________________________________________________________________________________________________________
// interface includes
//_________________________________________________________________________________________________________________
#ifndef _COM_SUN_STAR_BEANS_PROPERTYATTRIBUTE_HPP_
#include <com/sun/star/beans/PropertyAttribute.hpp>
#endif
#ifndef _COM_SUN_STAR_FRAME_FRAMESEARCHFLAG_HPP_
#include <com/sun/star/frame/FrameSearchFlag.hpp>
#endif
#ifndef _COM_SUN_STAR_AWT_XTOOLKIT_HPP_
#include <com/sun/star/awt/XToolkit.hpp>
#endif
#ifndef _COM_SUN_STAR_AWT_XWINDOW_HPP_
#include <com/sun/star/awt/XWindow.hpp>
#endif
#ifndef _COM_SUN_STAR_AWT_XWINDOWPEER_HPP_
#include <com/sun/star/awt/XWindowPeer.hpp>
#endif
#ifndef _COM_SUN_STAR_AWT_WINDOWDESCRIPTOR_HPP_
#include <com/sun/star/awt/WindowDescriptor.hpp>
#endif
#ifndef _COM_SUN_STAR_AWT_WINDOWATTRIBUTE_HPP_
#include <com/sun/star/awt/WindowAttribute.hpp>
#endif
#ifndef _COM_SUN_STAR_AWT_POSSIZE_HPP_
#include <com/sun/star/awt/PosSize.hpp>
#endif
#ifndef _COM_SUN_STAR_UTIL_XURLTRANSFORMER_HPP_
#include <com/sun/star/util/XURLTransformer.hpp>
#endif
#ifndef _COM_SUN_STAR_TASK_XINTERACTIONABORT_HPP_
#include <com/sun/star/task/XInteractionAbort.hpp>
#endif
#ifndef _COM_SUN_STAR_TASK_XINTERACTIONAPPROVE_HPP_
#include <com/sun/star/task/XInteractionApprove.hpp>
#endif
#ifndef _COM_SUN_STAR_DOCUMENT_XINTERACTIONFILTERSELECT_HPP_
#include <com/sun/star/document/XInteractionFilterSelect.hpp>
#endif
#ifndef _COM_SUN_STAR_DOCUMENT_AMBIGOUSFILTERREQUEST_HPP_
#include <com/sun/star/document/AmbigousFilterRequest.hpp>
#endif
#ifndef _COM_SUN_STAR_TASK_ERRORCODEREQUEST_HPP_
#include <com/sun/star/task/ErrorCodeRequest.hpp>
#endif
#ifndef _COM_SUN_STAR_UCB_INTERACTIVEIOEXCEPTION_HPP_
#include <com/sun/star/ucb/InteractiveIOException.hpp>
#endif
#ifndef _COM_SUN_STAR_UCB_INTERACTIVEAUGMENTEDIOEXCEPTION_HPP_
#include <com/sun/star/ucb/InteractiveAugmentedIOException.hpp>
#endif
#ifndef _COM_SUN_STAR_FRAME_XNOTIFYINGDISPATCH_HPP_
#include <com/sun/star/frame/XNotifyingDispatch.hpp>
#endif
#ifndef _COM_SUN_STAR_FRAME_DISPATCHRESULTSTATE_HPP_
#include <com/sun/star/frame/DispatchResultState.hpp>
#endif
#ifndef _COM_SUN_STAR_LANG_ILLEGALARGUMENTEXCEPTION_HPP_
#include <com/sun/star/lang/IllegalArgumentException.hpp>
#endif
#ifndef _COM_SUN_STAR_UTIL_XCLOSEABLE_HPP_
#include <com/sun/star/util/XCloseable.hpp>
#endif
#ifndef _COM_SUN_STAR_DOCUMENT_MACROEXECMODE_HPP_
#include <com/sun/star/document/MacroExecMode.hpp>
#endif
#ifndef _COM_SUN_STAR_DOCUMENT_UPDATEDOCMODE_HPP_
#include <com/sun/star/document/UpdateDocMode.hpp>
#endif
//_________________________________________________________________________________________________________________
// includes of other projects
//_________________________________________________________________________________________________________________
#ifndef _CPPUHELPER_QUERYINTERFACE_HXX_
#include <cppuhelper/queryinterface.hxx>
#endif
#ifndef _CPPUHELPER_TYPEPROVIDER_HXX_
#include <cppuhelper/typeprovider.hxx>
#endif
#ifndef _CPPUHELPER_FACTORY_HXX_
#include <cppuhelper/factory.hxx>
#endif
#ifndef _CPPUHELPER_PROPTYPEHLP_HXX
#include <cppuhelper/proptypehlp.hxx>
#endif
#ifndef _RTL_USTRBUF_HXX_
#include <rtl/ustrbuf.hxx>
#endif
#ifndef _RTL_LOGFILE_HXX_
#include <rtl/logfile.hxx>
#endif
#ifndef _SV_SVAPP_HXX
#include <vcl/svapp.hxx>
#endif
#ifndef __RSC
#include <tools/errinf.hxx>
#endif
#ifndef _COMPHELPER_EXTRACT_HXX_
#include <comphelper/extract.hxx>
#endif
//_________________________________________________________________________________________________________________
// namespace
//_________________________________________________________________________________________________________________
namespace framework{
//_________________________________________________________________________________________________________________
// non exported const
//_________________________________________________________________________________________________________________
//_________________________________________________________________________________________________________________
// non exported definitions
//_________________________________________________________________________________________________________________
//_________________________________________________________________________________________________________________
// declarations
//_________________________________________________________________________________________________________________
//*****************************************************************************************************************
// XInterface, XTypeProvider, XServiceInfo
//*****************************************************************************************************************
DEFINE_XINTERFACE_14 ( Desktop ,
OWeakObject ,
DIRECT_INTERFACE( css::lang::XTypeProvider ),
DIRECT_INTERFACE( css::lang::XServiceInfo ),
DIRECT_INTERFACE( css::frame::XDesktop ),
DIRECT_INTERFACE( css::frame::XComponentLoader ),
DIRECT_INTERFACE( css::frame::XTasksSupplier ),
DIRECT_INTERFACE( css::frame::XDispatchProvider ),
DIRECT_INTERFACE( css::frame::XDispatchProviderInterception),
DIRECT_INTERFACE( css::frame::XFramesSupplier ),
DIRECT_INTERFACE( css::frame::XFrame ),
DIRECT_INTERFACE( css::lang::XComponent ),
DIRECT_INTERFACE( css::frame::XDispatchResultListener ),
DIRECT_INTERFACE( css::lang::XEventListener ),
DIRECT_INTERFACE( css::task::XInteractionHandler ),
DIRECT_INTERFACE( css::beans::XPropertySet )
)
DEFINE_XTYPEPROVIDER_14 ( Desktop ,
css::lang::XTypeProvider ,
css::lang::XServiceInfo ,
css::frame::XDesktop ,
css::frame::XComponentLoader ,
css::frame::XTasksSupplier ,
css::frame::XDispatchProvider ,
css::frame::XDispatchProviderInterception ,
css::frame::XFramesSupplier ,
css::frame::XFrame ,
css::lang::XComponent ,
css::frame::XDispatchResultListener ,
css::lang::XEventListener ,
css::task::XInteractionHandler ,
css::beans::XPropertySet
)
DEFINE_XSERVICEINFO_ONEINSTANCESERVICE ( Desktop ,
::cppu::OWeakObject ,
SERVICENAME_DESKTOP ,
IMPLEMENTATIONNAME_DESKTOP
)
DEFINE_INIT_SERVICE ( Desktop,
{
/*Attention
I think we don't need any mutex or lock here ... because we are called by our own static method impl_createInstance()
to create a new instance of this class by our own supported service factory.
see macro DEFINE_XSERVICEINFO_MULTISERVICE and "impl_initService()" for further informations!
*/
//-------------------------------------------------------------------------------------------------------------
// Initialize a new XFrames-helper-object to handle XIndexAccess and XElementAccess.
// We hold member as reference ... not as pointer too!
// Attention: We share our frame container with this helper. Container is threadsafe himself ... So I think we can do that.
// But look on dispose() for right order of deinitialization.
OFrames* pFramesHelper = new OFrames( m_xFactory, this, &m_aChildTaskContainer );
m_xFramesHelper = css::uno::Reference< css::frame::XFrames >( static_cast< ::cppu::OWeakObject* >(pFramesHelper), css::uno::UNO_QUERY );
//-------------------------------------------------------------------------------------------------------------
// Initialize a new dispatchhelper-object to handle dispatches.
// We use these helper as slave for our interceptor helper ... not directly!
// But he is event listener on THIS instance!
DispatchProvider* pDispatchHelper = new DispatchProvider( m_xFactory, this );
css::uno::Reference< css::frame::XDispatchProvider > xDispatchProvider( static_cast< ::cppu::OWeakObject* >(pDispatchHelper), css::uno::UNO_QUERY );
//-------------------------------------------------------------------------------------------------------------
// Initialize a new interception helper object to handle dispatches and implement an interceptor mechanism.
// Set created dispatch provider as slowest slave of it.
// Hold interception helper by reference only - not by pointer!
// So it's easiear to destroy it.
InterceptionHelper* pInterceptionHelper = new InterceptionHelper( this, xDispatchProvider );
m_xDispatchHelper = css::uno::Reference< css::frame::XDispatchProvider >( static_cast< ::cppu::OWeakObject* >(pInterceptionHelper), css::uno::UNO_QUERY );
//-------------------------------------------------------------------------------------------------------------
// I'am the desktop - and use my frame container in a special mode.
// If last child task is removed, I must die!
// My container should terminate me asynchronous by using a timer.
// Enable timer at container.
// (The timer will be initialized with right timeout value automaticly by himself. see class AsyncQuit for further informations!)
m_aChildTaskContainer.enableQuitTimer( this );
// Safe impossible cases
// We can't work without this helper!
LOG_ASSERT2( m_xFramesHelper.is ()==sal_False, "Desktop::Desktop()", "Frames helper is not valid. XFrames, XIndexAccess and XElementAcces are not supported!\n")
LOG_ASSERT2( m_xDispatchHelper.is()==sal_False, "Desktop::Desktop()", "Dispatch helper is not valid. XDispatch will not work correctly!\n" )
// Enable object for real working!
// Otherwise all calls will be rejected ...
m_aTransactionManager.setWorkingMode( E_WORK );
}
)
/*-************************************************************************************************************//**
@short standard constructor to create instance by factory
@descr This constructor initialize a new instance of this class by valid factory,
and will be set valid values on his member and baseclasses.
@attention a) Don't use your own reference during an UNO-Service-ctor! There is no guarantee, that you
will get over this. (e.g. using of your reference as parameter to initialize some member)
Do such things in DEFINE_INIT_SERVICE() method, which is called automaticly after your ctor!!!
b) Baseclass OBroadcastHelper is a typedef in namespace cppu!
The microsoft compiler has some problems to handle it right BY using namespace explicitly ::cppu::OBroadcastHelper.
If we write it without a namespace or expand the typedef to OBrodcastHelperVar<...> -> it will be OK!?
I don't know why! (other compiler not tested .. but it works!)
@seealso method DEFINE_INIT_SERVICE()
@param "xFactory" is the multi service manager, which create this instance.
The value must be different from NULL!
@return -
@onerror We throw an ASSERT in debug version or do nothing in relaese version.
*//*-*************************************************************************************************************/
Desktop::Desktop( const css::uno::Reference< css::lang::XMultiServiceFactory >& xFactory )
// Init baseclasses first
// Attention: Don't change order of initialization!
// ThreadHelpBase is a struct with a lock as member. We can't use a lock as direct member!
// We must garant right initialization and a valid value of this to initialize other baseclasses!
: ThreadHelpBase ( &Application::GetSolarMutex() )
, TransactionBase ( )
, ::cppu::OBroadcastHelperVar< ::cppu::OMultiTypeInterfaceContainerHelper, ::cppu::OMultiTypeInterfaceContainerHelper::keyType > ( m_aLock.getShareableOslMutex() )
, ::cppu::OPropertySetHelper ( *(static_cast< ::cppu::OBroadcastHelper* >(this)) )
, ::cppu::OWeakObject ( )
// Init member
, m_xFactory ( xFactory )
, m_aChildTaskContainer ( )
, m_aListenerContainer ( m_aLock.getShareableOslMutex() )
, m_eLoadState ( E_NOTSET )
, m_aInteractionRequest ( )
, m_bSuspendQuickstartVeto( sal_False )
#ifdef ENABLE_ASSERTIONS
, m_bIsTerminated ( sal_False ) // see dispose() for further informations!
#endif
{
// Safe impossible cases
// We don't accept all incoming parameter.
LOG_ASSERT2( implcp_ctor( xFactory ), "Desktop::Desktop()", "Invalid parameter detected!")
}
/*-************************************************************************************************************//**
@short standard destructor
@descr This one do NOTHING! Use dispose() instaed of this.
@seealso method dispose()
@param -
@return -
@onerror -
*//*-*************************************************************************************************************/
Desktop::~Desktop()
{
LOG_ASSERT2( m_bIsTerminated ==sal_False, "Desktop::~Desktop()", "Who forgot to terminate the desktop service?" )
LOG_ASSERT2( m_aTransactionManager.getWorkingMode()!=E_CLOSE , "Desktop::~Desktop()", "Who forgot to dispose this service?" )
}
/*-************************************************************************************************************//**
@interface XDesktop
@short ask desktop before terminate it
@descr The desktop ask his components and if all say "yes" it will destroy this components
and return "yes" to caller of this method. Otherwhise, desktop will not be destroied!
But a TerminateListener with a veto - will be the new owner of this service and MUST
call terminate again, if he stop using of it!
@seealso interface XTerminateListener
@param -
@return sal_True ,if all components say "yes" for terminate
sal_False ,otherwise
@onerror We return sal_False.
@threadsafe yes
*//*-*************************************************************************************************************/
sal_Bool SAL_CALL Desktop::terminate() throw( css::uno::RuntimeException )
{
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
/* SAFE AREA ----------------------------------------------------------------------------------------------- */
ReadGuard aReadLock( m_aLock );
// Attention, Our timer hold a reference to use ... and sometimes (e.g. for headless office mode)
// he forget this one insteandly during his own instantiation! So we can die during next call.
// That's why it's agood idea to hold use self alive.
css::uno::Reference< css::frame::XDesktop > xThis( static_cast< ::cppu::OWeakObject* >(this), css::uno::UNO_QUERY );
// Get other neccessary references.
css::uno::Reference< css::frame::XTerminateListener > xPipeTerminator = m_xPipeTerminator ;
css::uno::Reference< css::frame::XTerminateListener > xQuickLauncher = m_xQuickLauncher ;
css::lang::EventObject aEvent ( static_cast< ::cppu::OWeakObject* >(this) );
sal_Bool bAskQuickStart = !m_bSuspendQuickstartVeto ;
aReadLock.unlock();
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Set default. If a veto occure - break operation and
// return "not terminated". Otherwise termination was successfully.
sal_Bool bNormalListenerVeto = sal_False;
sal_Bool bQuickLaunchVeto = sal_False;
sal_Bool bPipeVeto = sal_False;
sal_Bool bTaskVeto = sal_False;
//-------------------------------------------------------------------------------------------------------------
// Disable our async quit timer ... we terminate ourself!
// But if termination fail ... don't forget to enable it again!
// Member is threadsafe himself!
m_aChildTaskContainer.disableQuitTimer();
//-------------------------------------------------------------------------------------------------------------
// Ask normal terminate listener. They could stop complete terminate AND closing of currently open documents!
try
{
impl_sendQueryTerminationEvent();
}
catch( css::frame::TerminationVetoException& )
{
bNormalListenerVeto = sal_True;
}
//-------------------------------------------------------------------------------------------------------------
// If no veto comes we should ask our quicklauncher.
// He stop termination of whole office .. but not closing of open tasks!!!
// We shouldn't ask quicklauncher if property "SuspendQuickstartVeto" is set to FALSE!!
if(
( bNormalListenerVeto == sal_False ) &&
( bAskQuickStart == sal_True ) &&
( xQuickLauncher.is() == sal_True )
)
{
try
{
xQuickLauncher->queryTermination( aEvent );
}
catch( css::frame::TerminationVetoException& )
{
bQuickLaunchVeto = sal_True;
}
}
//-------------------------------------------------------------------------------------------------------------
// If no veto comes from quick launcher ... we should ask our pipe terminator too.
// He close pipe if no external requests are pending.
// Otherwise he throw the veto exception and we don't terminate AND don't close open tasks!
// Attention: If quick launcher exist - ask him before pipe terminator. Otherwise pipe will be closed
// quick launcher stop real termination ... but pipe will not reopened! So no further external requests
// could come in!!!
if(
( bNormalListenerVeto == sal_False ) &&
( bQuickLaunchVeto == sal_False ) &&
( xPipeTerminator.is() == sal_True )
)
{
try
{
xPipeTerminator->queryTermination( aEvent );
}
catch( css::frame::TerminationVetoException& )
{
bPipeVeto = sal_True;
}
}
//-------------------------------------------------------------------------------------------------------------
// Close tasks only, if no veto exist ... but if veto comes from our quick launcher ...
// DO IT! He stop termination - not closing tasks. => It doesn't matter, if bQuickLaunchVeto is true or false.
// We close tasks for both cases!
if(
( bNormalListenerVeto == sal_False ) &&
( bPipeVeto == sal_False )
)
{
// #110897#
// ModifiedDocumentsWindow::Remove();
ModifiedDocumentsWindow::Remove( m_xFactory );
// Step over all child tasks and ask they "WOULD YOU DIE?"
css::uno::Sequence< css::uno::Reference< css::frame::XFrame > > lTasks = m_aChildTaskContainer.getAllElements();
sal_Int32 nCount = lTasks.getLength() ;
for( sal_Int32 nPosition=0; !bTaskVeto && nPosition<nCount; ++nPosition )
{
// Get an element from container and cast it to task.
css::uno::Reference< css::frame::XFrame > xTask( lTasks[nPosition], css::uno::UNO_QUERY );
css::uno::Reference< css::util::XCloseable > xCloseable( xTask, css::uno::UNO_QUERY );
// Ask task for terminating. If anyone say "NO" ...
// ... we must reset our default return value to "NO" too!
try
{
// Don't deliver ownershipt of this task to any other one! => means call close(sal_False).
if ( !xTask->getController().is() || xTask->getController()->suspend(TRUE) )
xCloseable->close(sal_False);
else
// Controller didn't give permission to close
bTaskVeto = sal_True;
// Don't remove the task from our child container!
// A task do it by itself inside close
}
catch( css::util::CloseVetoException& )
{
// Any internal process of this task disagree with our request.
// Safe this state and break this loop. Following task willn't be asked!
bTaskVeto = sal_True;
}
catch( css::lang::DisposedException& )
{
// Task already closed by another thread or user ...
// It doesn't matter! Because dead is dead is dead ...!
// Do nothing and try to close next one.
// But may it's agood idea to release this task from our container
m_aChildTaskContainer.remove( lTasks[nPosition] );
}
}
}
//-------------------------------------------------------------------------------------------------------------
// All listener has no problem with our termination!
// Send NotifyTermination event to all and return with true.
sal_Bool bTerminated = (
( bNormalListenerVeto == sal_False ) &&
( bQuickLaunchVeto == sal_False ) &&
( bPipeVeto == sal_False ) &&
( bTaskVeto == sal_False )
);
#ifdef ENABLE_ASSERTIONS
// "Protect" us against dispose before terminate calls!
// see dispose() for further informations.
// Follow notify will start shutdown of office and somewhere call dispose() at us ...
// Set debug variable BEFORE notify!
/* SAFE AREA --------------------------------------------------------------------------------------- */
WriteGuard aWriteLock( m_aLock );
m_bIsTerminated = bTerminated;
aWriteLock.unlock();
/* UNSAFE AREA ------------------------------------------------------------------------------------- */
#endif
if( bTerminated == sal_True )
{
// Send event to normal listener ...
impl_sendNotifyTerminationEvent();
// ... but don't forget to send it to our special terminat listener too!
if( xPipeTerminator.is() == sal_True )
{
xPipeTerminator->notifyTermination( aEvent );
}
if( xQuickLauncher.is() == sal_True )
{
xQuickLauncher->notifyTermination( aEvent );
}
}
// If somewhere break this terminate operation and we must return FALSE ...
// we must reactivate our quit timer!
// Otherwise we live for ever.
else
{
m_aChildTaskContainer.enableQuitTimer( xThis );
}
// Return result of this question.
return bTerminated;
}
/*-************************************************************************************************************//**
@interface XDesktop
@short add/remove a listener for terminate events
@descr You can add a listener, if you wish to get an event, if desktop will be terminate.
Then it's possible to say "NO" by using a TerminateVetoException!
@attention a) We know a special terminate listener - the pipe terminator. He is called as last of all terminate
listeners. If no request stands in our office pipe - he has no veto. Otherwise
he close the pipe and external requests are rejected.
b) Another special listener is our quick launcher. He throw a veto exception, if tray-icon
is still active. But he doesn't block closing of tasks! So we must call him after closing of these ones!
c) May be we dispose our listener during our own dispose methode ... after closing object for
real working. They call us back to remove her interfaces from our listener container.
So we should allow that by using E_SOFTEXCEPTIONS and suppress rejection of this calls!
@seealso method terminate()
@param "xListener" is a reference to the listener. His value must be valid!
@return -
@onerror We do nothing.
@threadsafe yes
*//*-*************************************************************************************************************/
void SAL_CALL Desktop::addTerminateListener( const css::uno::Reference< css::frame::XTerminateListener >& xListener ) throw( css::uno::RuntimeException )
{
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Safe impossible cases
// Method not defined for all incoming parameter.
LOG_ASSERT2( implcp_addTerminateListener( xListener ), "Desktop::addTerminateListener()", "Invalid parameter detected!" )
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
sal_Bool bSpecialListener = sal_False ;
css::uno::Reference< css::lang::XServiceInfo > xInfo ( xListener, css::uno::UNO_QUERY );
if( xInfo.is() == sal_True )
{
::rtl::OUString sImplementationName = xInfo->getImplementationName();
/* SAFE AREA ------------------------------------------------------------------------------------------- */
WriteGuard aWriteLock( m_aLock );
if( sImplementationName == IMPLEMENTATIONNAME_PIPETERMINATOR )
{
m_xPipeTerminator = xListener;
bSpecialListener = sal_True ;
}
else
if( sImplementationName == IMPLEMENTATIONNAME_QUICKLAUNCHER )
{
m_xQuickLauncher = xListener;
bSpecialListener = sal_True ;
}
aWriteLock.unlock();
/* UNSAFE AREA ----------------------------------------------------------------------------------------- */
}
if( bSpecialListener == sal_False )
{
m_aListenerContainer.addInterface( ::getCppuType( ( const css::uno::Reference< css::frame::XTerminateListener >*) NULL ), xListener );
}
}
//*****************************************************************************************************************
void SAL_CALL Desktop::removeTerminateListener( const css::uno::Reference< css::frame::XTerminateListener >& xListener ) throw( css::uno::RuntimeException )
{
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Safe impossible cases
// Method not defined for all incoming parameter.
LOG_ASSERT2( implcp_removeTerminateListener( xListener ), "Desktop::removeTerminateListener()", "Invalid parameter detected!" )
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_SOFTEXCEPTIONS );
sal_Bool bSpecialListener = sal_False ;
css::uno::Reference< css::lang::XServiceInfo > xInfo ( xListener, css::uno::UNO_QUERY );
if( xInfo.is() == sal_True )
{
::rtl::OUString sImplementationName = xInfo->getImplementationName();
/* SAFE AREA ------------------------------------------------------------------------------------------- */
WriteGuard aWriteLock( m_aLock );
if( sImplementationName == IMPLEMENTATIONNAME_PIPETERMINATOR )
{
m_xPipeTerminator = css::uno::Reference< css::frame::XTerminateListener >();
bSpecialListener = sal_True;
}
else
if( sImplementationName == IMPLEMENTATIONNAME_QUICKLAUNCHER )
{
m_xQuickLauncher = css::uno::Reference< css::frame::XTerminateListener >();
bSpecialListener = sal_True;
}
aWriteLock.unlock();
/* UNSAFE AREA ----------------------------------------------------------------------------------------- */
}
if( bSpecialListener == sal_False )
{
m_aListenerContainer.removeInterface( ::getCppuType( ( const css::uno::Reference< css::frame::XTerminateListener >*) NULL ), xListener );
}
}
/*-************************************************************************************************************//**
@interface XDesktop
@short get access to create enumerations of all current components
@descr You will be the owner of the returned object and must delete it if you don't use it again.
@seealso class TasksAccess
@seealso class TasksEnumeration
@param -
@return A reference to an XEnumerationAccess-object.
@onerror We return a null-reference.
@threadsafe yes
*//*-*************************************************************************************************************/
css::uno::Reference< css::container::XEnumerationAccess > SAL_CALL Desktop::getComponents() throw( css::uno::RuntimeException )
{
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
// We use a helper class OComponentAccess to have access on all child components.
// Create it on demand and return it as a reference.
OComponentAccess* pAccess = new OComponentAccess( this );
css::uno::Reference< css::container::XEnumerationAccess > xAccess( static_cast< ::cppu::OWeakObject* >(pAccess), css::uno::UNO_QUERY );
return xAccess;
}
/*-************************************************************************************************************//**
@interface XDesktop
@short return the current active component
@descr The most current component is the window, model or the controller of the current active frame.
@seealso method getCurrentFrame()
@seealso method impl_getFrameComponent()
@param -
@return A reference to the component.
@onerror We return a null-reference.
@threadsafe yes
*//*-*************************************************************************************************************/
css::uno::Reference< css::lang::XComponent > SAL_CALL Desktop::getCurrentComponent() throw( css::uno::RuntimeException )
{
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
// Set return value if method failed.
css::uno::Reference< css::lang::XComponent > xComponent;
// Get reference to current frame ...
// ... get component of this frame ... (It can be the window, the model or the controller.)
// ... and return the result.
css::uno::Reference< css::frame::XFrame > xCurrentFrame = getCurrentFrame();
if( xCurrentFrame.is() == sal_True )
{
xComponent = impl_getFrameComponent( xCurrentFrame );
}
return xComponent;
}
/*-************************************************************************************************************//**
@interface XDesktop
@short return the current active frame in hierarchy
@descr There can be more then one different active pathes in our frame hierarchy. But only one of them
could be the most active frame (normal he has the focus).
Don't mix it with getActiveFrame()! That will return our current active frame, which must be
a direct child of us and should be a part(!) of an active path.
@seealso method getActiveFrame()
@param -
@return A valid reference, if there is an active frame.
A null reference , otherwise.
@onerror We return a null reference.
@threadsafe yes
*//*-*************************************************************************************************************/
css::uno::Reference< css::frame::XFrame > SAL_CALL Desktop::getCurrentFrame() throw( css::uno::RuntimeException )
{
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
// Start search with ouer direct active frame (if it exist!).
// Search on his children for other active frames too.
// Stop if no one could be found and return last of found ones.
css::uno::Reference< css::frame::XFramesSupplier > xLast = css::uno::Reference< css::frame::XFramesSupplier >( getActiveFrame(), css::uno::UNO_QUERY );
if( xLast.is() == sal_True )
{
css::uno::Reference< css::frame::XFramesSupplier > xNext = css::uno::Reference< css::frame::XFramesSupplier >( xLast->getActiveFrame(), css::uno::UNO_QUERY );
while( xNext.is() == sal_True )
{
xLast = xNext;
xNext = css::uno::Reference< css::frame::XFramesSupplier >( xNext->getActiveFrame(), css::uno::UNO_QUERY );
}
}
return css::uno::Reference< css::frame::XFrame >( xLast, css::uno::UNO_QUERY );
}
/*-************************************************************************************************************//**
@interface XComponentLoader
@short try to load given URL into a task
@descr You can give us some informations about the content, which you will load into a frame.
We search or create this target for you, make a type detection of given URL and try to load it.
As result of this operation we return the new created component or nothing, if loading failed.
@seealso -
@param "sURL" , URL, which represant the content
@param "sTargetFrameName" , name of target frame or special value like "_self", "_blank" ...
@param "nSearchFlags" , optional arguments for frame search, if target isn't a special one
@param "lArguments" , optional arguments for loading
@return A valid component reference, if loading was successfully.
A null reference otherwise.
@onerror We return a null reference.
@threadsafe yes
*//*-*************************************************************************************************************/
css::uno::Reference< css::lang::XComponent > SAL_CALL Desktop::loadComponentFromURL( const ::rtl::OUString& sURL ,
const ::rtl::OUString& sTargetFrameName,
sal_Int32 nSearchFlags ,
const css::uno::Sequence< css::beans::PropertyValue >& lArguments ) throw( css::io::IOException ,
css::lang::IllegalArgumentException ,
css::uno::RuntimeException )
{
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
RTL_LOGFILE_CONTEXT( aLog, "framework (as96863) ::Desktop::loadComponentFromURL" );
ReadGuard aReadLock(m_aLock);
css::uno::Reference< css::frame::XComponentLoader > xThis(static_cast< css::frame::XComponentLoader* >(this), css::uno::UNO_QUERY);
css::uno::Reference< css::lang::XMultiServiceFactory > xSMGR = m_xFactory;
aReadLock.unlock();
return LoadEnv::loadComponentFromURL(xThis, xSMGR, sURL, sTargetFrameName, nSearchFlags, lArguments);
}
/*-************************************************************************************************************//**
@interface XTasksSupplier
@short get access to create enumerations of ouer taskchilds
@descr Direct childs of desktop are tasks everytime.
Call these method to could create enumerations of it.
But; Don't forget - you will be the owner of returned object and must release it!
We use a helper class to implement the access interface. They hold a weakreference to us.
It can be, that the desktop is dead - but not your tasksaccess-object! Then they will do nothing!
You can't create enumerations then.
@attention Normaly we don't need any lock here. We don't work on internal member!
@seealso class TasksAccess
@param -
@return A reference to an accessobject, which can create enumerations of ouer childtasks.
@onerror A null reference is returned.
@threadsafe yes
*//*-*************************************************************************************************************/
css::uno::Reference< css::container::XEnumerationAccess > SAL_CALL Desktop::getTasks() throw( css::uno::RuntimeException )
{
LOG_WARNING("Desktop::getTasks()", "Use of obsolete interface XTaskSupplier")
return NULL;
/*
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
OTasksAccess* pTasksAccess = new OTasksAccess( this, &m_aChildTaskContainer );
css::uno::Reference< css::container::XEnumerationAccess > xAccess( static_cast< ::cppu::OWeakObject* >(pTasksAccess), css::uno::UNO_QUERY );
return xAccess;
*/
}
/*-************************************************************************************************************//**
@interface XTasksSupplier
@short return current active task of ouer direct childs
@descr Desktop childs are tasks only ! If we have an active path from desktop
as top to any frame on bottom, we must have an active direct child. His reference is returned here.
@attention a) Do not confuse it with getCurrentFrame()! The current frame don't must one of ouer direct childs.
It can be every frame in subtree and must have the focus (Is the last one of an active path!).
b) We don't need any lock here. Our container is threadsafe himself and live, if we live!
@seealso method getCurrentFrame()
@param -
@return A reference to ouer current active taskchild.
@onerror A null reference is returned.
@threadsafe yes
*//*-*************************************************************************************************************/
css::uno::Reference< css::frame::XTask > SAL_CALL Desktop::getActiveTask() throw( css::uno::RuntimeException )
{
/*
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
return css::uno::Reference< css::frame::XTask >( m_aChildTaskContainer.getActive(), css::uno::UNO_QUERY );
*/
LOG_WARNING("Desktop::getActiveTask()", "Use of obsolete interface XTaskSupplier")
return NULL;
}
/*-************************************************************************************************************//**
@interface XDispatchProvider
@short search a dispatcher for given URL
@descr We use a helper implementation (class DispatchProvider) to do so.
So we don't must implement this algorithm twice!
@attention We don't need any lock here. Our helper is threadsafe himself and live, if we live!
@seealso class DispatchProvider
@param "aURL" , URL to dispatch
@param "sTargetFrameName" , name of target frame, who should dispatch these URL
@param "nSearchFlags" , flags to regulate the search
@param "lQueries" , list of queryDispatch() calls!
@return A reference or list of founded dispatch objects for these URL.
@onerror A null reference is returned.
@threadsafe yes
*//*-*************************************************************************************************************/
css::uno::Reference< css::frame::XDispatch > SAL_CALL Desktop::queryDispatch( const css::util::URL& aURL ,
const ::rtl::OUString& sTargetFrameName ,
sal_Int32 nSearchFlags ) throw( css::uno::RuntimeException )
{
const char UNO_PROTOCOL[] = ".uno:";
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
// Remove uno and cmd protocol part as we want to support both of them. We store only the command part
// in our hash map. All other protocols are stored with the protocol part.
String aCommand( aURL.Main );
if ( aURL.Protocol.equalsIgnoreAsciiCaseAsciiL( UNO_PROTOCOL, sizeof( UNO_PROTOCOL )-1 ))
aCommand = aURL.Path;
// Make hash_map lookup if the current URL is in the disabled list
if ( m_aCommandOptions.Lookup( SvtCommandOptions::CMDOPTION_DISABLED, aCommand ) )
return css::uno::Reference< css::frame::XDispatch >();
else
{
// We use a helper to support these interface and an interceptor mechanism.
// Our helper is threadsafe by himself!
return m_xDispatchHelper->queryDispatch( aURL, sTargetFrameName, nSearchFlags );
}
}
//*****************************************************************************************************************
css::uno::Sequence< css::uno::Reference< css::frame::XDispatch > > SAL_CALL Desktop::queryDispatches( const css::uno::Sequence< css::frame::DispatchDescriptor >& lQueries ) throw( css::uno::RuntimeException )
{
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
return m_xDispatchHelper->queryDispatches( lQueries );
}
/*-************************************************************************************************************//**
@interface XDipsatchProviderInterception
@short supports registration/deregistration of interception objects, which
are interested on special dispatches.
@descr Its realy provided by an internal helper, which is used inside the dispatch api too.
@param xInterceptor
the interceptor object, which wish to be (de)registered.
@threadsafe yes
*//*-*************************************************************************************************************/
void SAL_CALL Desktop::registerDispatchProviderInterceptor( const css::uno::Reference< css::frame::XDispatchProviderInterceptor >& xInterceptor)
throw( css::uno::RuntimeException)
{
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
css::uno::Reference< css::frame::XDispatchProviderInterception > xInterceptionHelper( m_xDispatchHelper, css::uno::UNO_QUERY );
xInterceptionHelper->registerDispatchProviderInterceptor( xInterceptor );
}
//*****************************************************************************************************************
void SAL_CALL Desktop::releaseDispatchProviderInterceptor ( const css::uno::Reference< css::frame::XDispatchProviderInterceptor >& xInterceptor)
throw( css::uno::RuntimeException)
{
TransactionGuard aTransaction( m_aTransactionManager, E_SOFTEXCEPTIONS );
css::uno::Reference< css::frame::XDispatchProviderInterception > xInterceptionHelper( m_xDispatchHelper, css::uno::UNO_QUERY );
xInterceptionHelper->releaseDispatchProviderInterceptor( xInterceptor );
}
/*-************************************************************************************************************//**
@interface XFramesSupplier
@short return access to append or remove childs on desktop
@descr We don't implement these interface directly. We use a helper class to do this.
If you wish to add or delete childs to/from the container, call these method to get
a reference to the helper.
@attention Helper is threadsafe himself. So we don't need any lock here.
@seealso class OFrames
@param -
@return A reference to the helper.
@onerror A null reference is returned.
@threadsafe yes
*//*-*************************************************************************************************************/
css::uno::Reference< css::frame::XFrames > SAL_CALL Desktop::getFrames() throw( css::uno::RuntimeException )
{
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
return m_xFramesHelper;
}
/*-************************************************************************************************************//**
@interface XFramesSupplier
@short set/get the current active child frame
@descr It must be a task. Direct childs of desktop are tasks only! No frames are accepted.
We don't save this information directly in this class. We use ouer container-helper
to do that.
@attention Helper is threadsafe himself. So we don't need any lock here.
@seealso class OFrameContainer
@param "xFrame", new active frame (must be valid!)
@return A reference to ouer current active childtask, if anyone exist.
@onerror A null reference is returned.
@threadsafe yes
*//*-*************************************************************************************************************/
void SAL_CALL Desktop::setActiveFrame( const css::uno::Reference< css::frame::XFrame >& xFrame ) throw( css::uno::RuntimeException )
{
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
// Get old active frame first.
// If nothing will change - do nothing!
// Otherwise set new active frame ...
// and deactivate last frame.
// It's neccessary for our FrameActionEvent listener on a frame!
css::uno::Reference< css::frame::XFrame > xLastActiveChild = m_aChildTaskContainer.getActive();
if( xLastActiveChild != xFrame )
{
m_aChildTaskContainer.setActive( xFrame );
if( xLastActiveChild.is() == sal_True )
{
xLastActiveChild->deactivate();
}
}
}
//*****************************************************************************************************************
css::uno::Reference< css::frame::XFrame > SAL_CALL Desktop::getActiveFrame() throw( css::uno::RuntimeException )
{
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
return m_aChildTaskContainer.getActive();
}
/*-************************************************************************************************************//**
@interface XFrame
@short non implemented methods!
@descr Some method make no sense for our desktop! He has no window or parent or ...
So we should implement it empty and warn programmer, if he use it!
@seealso -
@param -
@return -
@onerror -
@threadsafe -
*//*-*************************************************************************************************************/
void SAL_CALL Desktop::initialize( const css::uno::Reference< css::awt::XWindow >& xWindow ) throw( css::uno::RuntimeException )
{
}
//*****************************************************************************************************************
css::uno::Reference< css::awt::XWindow > SAL_CALL Desktop::getContainerWindow() throw( css::uno::RuntimeException )
{
return css::uno::Reference< css::awt::XWindow >();
}
//*****************************************************************************************************************
void SAL_CALL Desktop::setCreator( const css::uno::Reference< css::frame::XFramesSupplier >& xCreator ) throw( css::uno::RuntimeException )
{
}
//*****************************************************************************************************************
css::uno::Reference< css::frame::XFramesSupplier > SAL_CALL Desktop::getCreator() throw( css::uno::RuntimeException )
{
return css::uno::Reference< css::frame::XFramesSupplier >();
}
//*****************************************************************************************************************
::rtl::OUString SAL_CALL Desktop::getName() throw( css::uno::RuntimeException )
{
/* SAFE { */
ReadGuard aReadLock( m_aLock );
return m_sName;
/* } SAFE */
}
//*****************************************************************************************************************
void SAL_CALL Desktop::setName( const ::rtl::OUString& sName ) throw( css::uno::RuntimeException )
{
/* SAFE { */
WriteGuard aWriteLock( m_aLock );
m_sName = sName;
aWriteLock.unlock();
/* } SAFE */
}
//*****************************************************************************************************************
sal_Bool SAL_CALL Desktop::isTop() throw( css::uno::RuntimeException )
{
return sal_True;
}
//*****************************************************************************************************************
void SAL_CALL Desktop::activate() throw( css::uno::RuntimeException )
{
// Desktop is activae always ... but sometimes our frames try to activate
// the complete path from bottom to top ... And our desktop is the topest frame :-(
// So - please don't show any assertions here. Do nothing!
}
//*****************************************************************************************************************
void SAL_CALL Desktop::deactivate() throw( css::uno::RuntimeException )
{
// Desktop is activae always ... but sometimes our frames try to deactivate
// the complete path from bottom to top ... And our desktop is the topest frame :-(
// So - please don't show any assertions here. Do nothing!
}
//*****************************************************************************************************************
sal_Bool SAL_CALL Desktop::isActive() throw( css::uno::RuntimeException )
{
return sal_True;
}
//*****************************************************************************************************************
sal_Bool SAL_CALL Desktop::setComponent( const css::uno::Reference< css::awt::XWindow >& xComponentWindow ,
const css::uno::Reference< css::frame::XController >& xController ) throw( css::uno::RuntimeException )
{
return sal_False;
}
//*****************************************************************************************************************
css::uno::Reference< css::awt::XWindow > SAL_CALL Desktop::getComponentWindow() throw( css::uno::RuntimeException )
{
return css::uno::Reference< css::awt::XWindow >();
}
//*****************************************************************************************************************
css::uno::Reference< css::frame::XController > SAL_CALL Desktop::getController() throw( css::uno::RuntimeException )
{
return css::uno::Reference< css::frame::XController >();
}
//*****************************************************************************************************************
void SAL_CALL Desktop::contextChanged() throw( css::uno::RuntimeException )
{
}
//*****************************************************************************************************************
void SAL_CALL Desktop::addFrameActionListener( const css::uno::Reference< css::frame::XFrameActionListener >& xListener ) throw( css::uno::RuntimeException )
{
}
//*****************************************************************************************************************
// css::frame::XFrame
//*****************************************************************************************************************
void SAL_CALL Desktop::removeFrameActionListener( const css::uno::Reference< css::frame::XFrameActionListener >& xListener ) throw( css::uno::RuntimeException )
{
}
/*-************************************************************************************************************//**
@interface XFrame
@short try to find a frame with special parameters
@descr This method searches for a frame with the specified name.
Frames may contain other frames (e.g. a frameset) and may
be contained in other frames. This hierarchie ist searched by
this method.
First some special names are taken into account, i.e. "",
"_self", "_top", "_parent" etc. The FrameSearchFlags are ignored
when comparing these names with aTargetFrameName, further steps are
controlled by the FrameSearchFlags. If allowed, the name of the frame
itself is compared with the desired one, then ( again if allowed )
the method findFrame is called for all children of the frame.
If no Frame with the given name is found until the top frames container,
a new top Frame is created, if this is allowed by a special
FrameSearchFlag. The new Frame also gets the desired name.
We use a helper to get right search direction and react in a right manner.
@seealso class TargetFinder
@param "sTargetFrameName" , name of searched frame
@param "nSearchFlags" , flags to regulate search
@return A reference to an existing frame in hierarchy, if it exist.
@onerror A null reference is returned.
@threadsafe yes
*//*-*************************************************************************************************************/
css::uno::Reference< css::frame::XFrame > SAL_CALL Desktop::findFrame( const ::rtl::OUString& sTargetFrameName ,
sal_Int32 nSearchFlags ) throw( css::uno::RuntimeException )
{
css::uno::Reference< css::frame::XFrame > xTarget;
//-----------------------------------------------------------------------------------------------------
// 0) Ignore wrong parameter!
// We doesn't support search for following special targets.
// If we reject this requests - we mustnt check for such names
// in following code again and again. If we do not so -wrong
// search results can occure!
//-----------------------------------------------------------------------------------------------------
if (
(sTargetFrameName==SPECIALTARGET_DEFAULT ) || // valid for dispatches - not for findFrame()!
(sTargetFrameName==SPECIALTARGET_MENUBAR ) || // valid for dispatches - not for findFrame()!
(sTargetFrameName==SPECIALTARGET_HELPAGENT) || // valid for dispatches - not for findFrame()!
(sTargetFrameName==SPECIALTARGET_PARENT ) || // we have no parent by definition
(sTargetFrameName==SPECIALTARGET_BEAMER ) // beamer frames are allowed as child of tasks only -
// and they exist more then ones. We have no idea which our sub tasks is the right one
)
{
return NULL;
}
//-----------------------------------------------------------------------------------------------------
// I) check for special defined targets first which must be handled exclusive.
// force using of "if() else if() ..."
//-----------------------------------------------------------------------------------------------------
// get threadsafe some neccessary member which are neccessary for following functionality
/* SAFE { */
ReadGuard aReadLock( m_aLock );
css::uno::Reference< css::lang::XMultiServiceFactory > xFactory = m_xFactory;
aReadLock.unlock();
/* } SAFE */
//-----------------------------------------------------------------------------------------------------
// I.I) "_blank"
// create a new task as child of this desktop instance
// Note: Used helper TaskCreator use us automaticly ...
//-----------------------------------------------------------------------------------------------------
if ( sTargetFrameName==SPECIALTARGET_BLANK )
{
TaskCreator aCreator(xFactory);
xTarget = aCreator.createTask(::rtl::OUString(),sal_False);
}
//-----------------------------------------------------------------------------------------------------
// I.II) "_top"
// We are top by definition
//-----------------------------------------------------------------------------------------------------
else
if ( sTargetFrameName==SPECIALTARGET_TOP )
{
xTarget = this;
}
//-----------------------------------------------------------------------------------------------------
// I.III) "_self", ""
// This mean this "frame" in every case.
//-----------------------------------------------------------------------------------------------------
else
if (
( sTargetFrameName==SPECIALTARGET_SELF ) ||
( sTargetFrameName.getLength()<1 )
)
{
xTarget = this;
}
else
{
//-------------------------------------------------------------------------------------------------
// II) otherwhise use optional given search flags
// force using of combinations of such flags. means no "else" part of use if() statements.
// But we ust break further searches if target was already found.
// Order of using flags is fix: SELF - CHILDREN - SIBLINGS - PARENT
// TASK and CREATE are handled special.
// But note: Such flags are not valid for the desktop - especialy SIBLINGS or PARENT.
//-------------------------------------------------------------------------------------------------
// get threadsafe some neccessary member which are neccessary for following functionality
/* SAFE { */
aReadLock.lock();
::rtl::OUString sOwnName = m_sName;
aReadLock.unlock();
/* } SAFE */
//-------------------------------------------------------------------------------------------------
// II.I) SELF
// Check for right name. If it's the searched one return ourself - otherwhise
// ignore this flag.
//-------------------------------------------------------------------------------------------------
if (
(nSearchFlags & css::frame::FrameSearchFlag::SELF) &&
(sOwnName == sTargetFrameName )
)
{
xTarget = this;
}
//-------------------------------------------------------------------------------------------------
// II.II) TASKS
// This is a special flag. Normaly it regulate search inside tasks and forbid access to parent trees.
// But the desktop exists outside such task trees. They are our sub trees. So the desktop implement
// a special feature: We use it to start search on our direct childrens only. That means we supress
// search on ALL child frames. May that can be usefull to get access on opened document tasks
// only without filter out all non realy required sub frames ...
// Used helper method on our container doesn't create any frame - its a search only.
//-------------------------------------------------------------------------------------------------
if (
( ! xTarget.is() ) &&
(nSearchFlags & css::frame::FrameSearchFlag::TASKS)
)
{
xTarget = m_aChildTaskContainer.searchOnDirectChildrens(sTargetFrameName);
}
//-------------------------------------------------------------------------------------------------
// II.III) CHILDREN
// Search on all children for the given target name.
// An empty name value can't occure here - because it must be already handled as "_self"
// before. Used helper function of container doesn't create any frame.
// It makes a deep search only.
//-------------------------------------------------------------------------------------------------
if (
( ! xTarget.is() ) &&
(nSearchFlags & css::frame::FrameSearchFlag::CHILDREN)
)
{
xTarget = m_aChildTaskContainer.searchOnAllChildrens(sTargetFrameName);
}
//-------------------------------------------------------------------------------------------------
// II.IV) CREATE
// If we haven't found any valid target frame by using normal flags - but user allowed us to create
// a new one ... we should do that. Used TaskCreator use us automaticly as parent!
//-------------------------------------------------------------------------------------------------
if (
( ! xTarget.is() ) &&
(nSearchFlags & css::frame::FrameSearchFlag::CREATE)
)
{
TaskCreator aCreator(xFactory);
xTarget = aCreator.createTask(sTargetFrameName,sal_False);
}
}
return xTarget;
}
/*-************************************************************************************************************//**
@interface XComponent
@short release all reference
@descr The owner of this object calles the dispose method if the object
should be destroyed. All other objects and components, that are registered
as an EventListener are forced to release their references to this object.
The reference attributes are disposed and released also.
@seealso -
@param -
@return -
@onerror -
@threadsafe yes
*//*-*************************************************************************************************************/
void SAL_CALL Desktop::dispose() throw( css::uno::RuntimeException )
{
// Safe impossible cases
// It's an programming error if dispose is called before terminate!
LOG_ASSERT2( m_bIsTerminated==sal_False, "Desktop::dispose()", "It's not allowed to dispose the desktop before terminate() is called!" )
/*ATTENTION
Make it threadsafe ... but this method is a special one!
We must close objet for working BEFORE we dispose it realy ...
After successful closing all interface calls are rejected by our
transaction manager automaticly.
*/
/* SAFE AREA ----------------------------------------------------------------------------------------------- */
// Create an exclusiv access!
// It's neccessary for follow transaction check ...
// Another reason: We can recylce these write lock at later time ..
// and it's superflous to create read- and write- locks in combination.
WriteGuard aWriteLock( m_aLock );
// Look for multiple calls of this method!
// If somewhere call dispose() twice - he will be stopped here realy!!!
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
// Now - we are alone and its the first call of this method ...
// otherwise call before must throw a DisposedException!
// Don't forget to release this registered transaction here ...
// because next "setWorkingMode()" call blocks till all current existing one
// are finished!
aTransaction.stop();
// Disable this instance for further work.
// This will wait for all current running ones ...
// and reject all further requests!
m_aTransactionManager.setWorkingMode( E_BEFORECLOSE );
// We should hold a reference to ourself ...
// because our owner dispose us and release our reference ...
// May be we will die before we could finish this method ...
// Make snapshot of other neecessary member too.
css::uno::Reference< css::uno::XInterface > xThis( static_cast< ::cppu::OWeakObject* >(this), css::uno::UNO_QUERY );
// We don't need this lock any longer ... this method couldn't be called twice ... it was disabled for working!
aWriteLock.unlock();
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// We must disable the special quit timer of our frame container.
// Because it will call terminate at THESE instance if last task will be removed!.
m_aChildTaskContainer.disableQuitTimer();
// We must send the dispose message to all listener.
// Otherwise our child tasks are disposed and try to remove it by himself at our container ...
css::lang::EventObject aDisposeEvent( xThis );
m_aListenerContainer.disposeAndClear( aDisposeEvent );
// Clear our child task container and forget all task references.
m_aChildTaskContainer.clear();
// Dispose our helper too.
css::uno::Reference< css::lang::XEventListener > xFramesHelper ( m_xFramesHelper , css::uno::UNO_QUERY );
if( xFramesHelper.is() == sal_True )
{
xFramesHelper->disposing( aDisposeEvent );
}
// Release all member references.
m_xDispatchHelper = css::uno::Reference< css::frame::XDispatchProvider >();
m_xFramesHelper = css::uno::Reference< css::frame::XFrames >();
m_xLastFrame = css::uno::Reference< css::frame::XFrame >();
m_xFactory = css::uno::Reference< css::lang::XMultiServiceFactory >();
m_xPipeTerminator = css::uno::Reference< css::frame::XTerminateListener >();
m_xQuickLauncher = css::uno::Reference< css::frame::XTerminateListener >();
// Disable object for further working.
m_aTransactionManager.setWorkingMode( E_CLOSE );
}
/*-************************************************************************************************************//**
@interface XComponent
@short add/remove listener for dispose events
@descr Add an event listener to this object, if you whish to get informations
about our dieing!
You must releas ethis listener reference during your own disposing() method.
@attention Our container is threadsafe himeslf. So we doesn't need any lock here.
@seealso -
@param "xListener", reference to valid listener. We don't accept invalid values!
@return -
@onerror -
@threadsafe yes
*//*-*************************************************************************************************************/
void SAL_CALL Desktop::addEventListener( const css::uno::Reference< css::lang::XEventListener >& xListener ) throw( css::uno::RuntimeException )
{
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Safe impossible cases
// Method not defined for all incoming parameter.
LOG_ASSERT2( implcp_addEventListener( xListener ), "Desktop::addEventListener()", "Invalid parameter detected!" )
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
m_aListenerContainer.addInterface( ::getCppuType( ( const css::uno::Reference< css::lang::XEventListener >*) NULL ), xListener );
}
//*****************************************************************************************************************
void SAL_CALL Desktop::removeEventListener( const css::uno::Reference< css::lang::XEventListener >& xListener ) throw( css::uno::RuntimeException )
{
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Safe impossible cases
// Method not defined for all incoming parameter.
LOG_ASSERT2( implcp_removeEventListener( xListener ), "Desktop::removeEventListener()", "Invalid parameter detected!" )
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_SOFTEXCEPTIONS );
m_aListenerContainer.removeInterface( ::getCppuType( ( const css::uno::Reference< css::lang::XEventListener >*) NULL ), xListener );
}
/*-************************************************************************************************************//**
@interface XDispatchResultListener
@short callback for dispatches
@descr To support our method "loadComponentFromURL()" we are listener on temp. created dispatcher.
They call us back in this method "statusChanged()". As source of given state event, they give us a
reference to the target frame, in which dispatch was loaded! So we can use it to return his component
to caller! If no target exist ... ??!!
@seealso method loadComponentFromURL()
@param "aEvent", state event which (hopefully) valid informations
@return -
@onerror -
@threadsafe yes
*//*-*************************************************************************************************************/
void SAL_CALL Desktop::dispatchFinished( const css::frame::DispatchResultEvent& aEvent ) throw( css::uno::RuntimeException )
{
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
/* SAFE AREA ------------------------------------------------------------------------------------------- */
WriteGuard aWriteLock( m_aLock );
if( m_eLoadState != E_INTERACTION )
{
m_xLastFrame = css::uno::Reference< css::frame::XFrame >();
m_eLoadState = E_FAILED ;
if( aEvent.State == css::frame::DispatchResultState::SUCCESS )
{
css::uno::Reference < css::frame::XFrame > xFrame;
if ( aEvent.Result >>= m_xLastFrame )
m_eLoadState = E_SUCCESSFUL;
}
}
/* UNSAFE AREA ----------------------------------------------------------------------------------------- */
}
/*-************************************************************************************************************//**
@interface XEventListener
@short not implemented!
@descr We are a status listener ... and so we must be an event listener too ... But we doesn't need it realy!
We are a temp. listener only and our lifetime isn't smaller then of our temp. used dispatcher.
@seealso method loadComponentFromURL()
@param -
@return -
@onerror -
@threadsafe -
*//*-*************************************************************************************************************/
void SAL_CALL Desktop::disposing( const css::lang::EventObject& aSource ) throw( css::uno::RuntimeException )
{
LOG_ERROR( "Desktop::disposing()", "Algorithm error! Normaly desktop is temp. listener ... not all the time. So this method shouldn't be called." )
}
/*-************************************************************************************************************//**
@interface XInteractionHandler
@short callback for loadComponentFromURL for detected exceptions during load proccess
@descr In this case we must cancel loading and throw these detected exception again as result
of our own called method.
@attention a)
Normal loop in loadComponentFromURL() breaks on setted member m_eLoadState during callback statusChanged().
But these interaction feature implements second way to do so! So we must look on different callbacks
for same operation ... and live with it.
b)
Search for given continuations too. If any XInteractionAbort exist ... use it to abort further operations
for currently running operation!
@seealso method loadComponentFromURL()
@seealso member m_eLoadState
@param "xRequest", request for interaction - normal a wrapped target exception from bottom services
@return -
@onerror -
@threadsafe yes
*//*-*************************************************************************************************************/
void SAL_CALL Desktop::handle( const css::uno::Reference< css::task::XInteractionRequest >& xRequest ) throw( css::uno::RuntimeException )
{
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
// Don't check incoming request!
// If somewhere starts interaction without right parameter - he maked something wrong.
// loadComponentFromURL() waits for thjese event - otherwise it yield for ever!
// get packed request and work on it first
// Attention: Don't set it on internal member BEFORE interaction is finished - because
// "loadComponentFromURL()" yield tills this member is changed. If we do it before
// interaction finish we can't guarantee right functionality. May be we cancel load process to erliear ...
css::uno::Any aRequest = xRequest->getRequest();
// extract continuations from request
css::uno::Sequence< css::uno::Reference< css::task::XInteractionContinuation > > lContinuations = xRequest->getContinuations();
css::uno::Reference< css::task::XInteractionAbort > xAbort ;
css::uno::Reference< css::task::XInteractionApprove > xApprove ;
css::uno::Reference< css::document::XInteractionFilterSelect > xFilterSelect ;
sal_Bool bAbort = sal_False;
sal_Int32 nCount=lContinuations.getLength();
for( sal_Int32 nStep=0; nStep<nCount; ++nStep )
{
if( ! xAbort.is() )
xAbort = css::uno::Reference< css::task::XInteractionAbort >( lContinuations[nStep], css::uno::UNO_QUERY );
if( ! xApprove.is() )
xApprove = css::uno::Reference< css::task::XInteractionApprove >( lContinuations[nStep], css::uno::UNO_QUERY );
if( ! xFilterSelect.is() )
xFilterSelect = css::uno::Reference< css::document::XInteractionFilterSelect >( lContinuations[nStep], css::uno::UNO_QUERY );
}
// differ between abortable interactions (error, unknown filter ...)
// and other ones (ambigous but not unknown filter ...)
css::task::ErrorCodeRequest aErrorCodeRequest ;
css::document::AmbigousFilterRequest aAmbigousFilterRequest;
if( aRequest >>= aAmbigousFilterRequest )
{
if( xFilterSelect.is() )
{
xFilterSelect->setFilter( aAmbigousFilterRequest.SelectedFilter ); // user selected filter wins!
xFilterSelect->select();
}
}
else
if( aRequest >>= aErrorCodeRequest )
{
sal_Bool bWarning = ((aErrorCodeRequest.ErrCode & ERRCODE_WARNING_MASK) == ERRCODE_WARNING_MASK);
if (xApprove.is() && bWarning)
xApprove->select();
else
if (xAbort.is())
{
xAbort->select();
bAbort = sal_True;
}
}
else
if( xAbort.is() )
{
xAbort->select();
bAbort = sal_True;
}
/* SAFE AREA ------------------------------------------------------------------------------------------- */
// Ok now it's time to break yield loop of loadComponentFromURL().
// But only for realy aborted requests!
// For example warnings will be approved and we wait for any success story ...
if (bAbort)
{
WriteGuard aWriteLock( m_aLock );
m_eLoadState = E_INTERACTION;
m_aInteractionRequest = aRequest ;
aWriteLock.unlock();
}
/* UNSAFE AREA ----------------------------------------------------------------------------------------- */
}
/*-************************************************************************************************************//**
@short try to convert a property value
@descr This method is called from helperclass "OPropertySetHelper".
Don't use this directly!
You must try to convert the value of given DESKTOP_PROPHANDLE and
return results of this operation. This will be used to ask vetoable
listener. If no listener has a veto, we will change value realy!
( in method setFastPropertyValue_NoBroadcast(...) )
@attention Methods of OPropertySethelper are safed by using our shared osl mutex! (see ctor!)
So we must use different locks to make our implementation threadsafe.
@seealso class OPropertySetHelper
@seealso method setFastPropertyValue_NoBroadcast()
@param "aConvertedValue" new converted value of property
@param "aOldValue" old value of property
@param "nHandle" handle of property
@param "aValue" new value of property
@return sal_True if value will be changed, sal_FALSE otherway
@onerror IllegalArgumentException, if you call this with an invalid argument
@threadsafe yes
*//*-*************************************************************************************************************/
sal_Bool SAL_CALL Desktop::convertFastPropertyValue( css::uno::Any& aConvertedValue ,
css::uno::Any& aOldValue ,
sal_Int32 nHandle ,
const css::uno::Any& aValue ) throw( css::lang::IllegalArgumentException )
{
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
// Initialize state with FALSE !!!
// (Handle can be invalid)
sal_Bool bReturn = sal_False;
switch( nHandle )
{
case DESKTOP_PROPHANDLE_SUSPENDQUICKSTARTVETO:
bReturn = PropHelper::willPropertyBeChanged(
css::uno::makeAny(m_bSuspendQuickstartVeto),
aValue,
aOldValue,
aConvertedValue);
break;
case DESKTOP_PROPHANDLE_DISPATCHRECORDERSUPPLIER :
bReturn = PropHelper::willPropertyBeChanged(
css::uno::makeAny(m_xDispatchRecorderSupplier),
aValue,
aOldValue,
aConvertedValue);
break;
case DESKTOP_PROPHANDLE_TITLE :
bReturn = PropHelper::willPropertyBeChanged(
css::uno::makeAny(m_sTitle),
aValue,
aOldValue,
aConvertedValue);
break;
}
// Return state of operation.
return bReturn ;
}
/*-************************************************************************************************************//**
@short set value of a transient property
@descr This method is calling from helperclass "OPropertySetHelper".
Don't use this directly!
Handle and value are valid everyway! You must set the new value only.
After this, baseclass send messages to all listener automaticly.
@seealso class OPropertySetHelper
@param "nHandle" handle of property to change
@param "aValue" new value of property
@return -
@onerror An exception is thrown.
@threadsafe yes
*//*-*************************************************************************************************************/
void SAL_CALL Desktop::setFastPropertyValue_NoBroadcast( sal_Int32 nHandle ,
const css::uno::Any& aValue ) throw( css::uno::Exception )
{
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
switch( nHandle )
{
case DESKTOP_PROPHANDLE_SUSPENDQUICKSTARTVETO: aValue >>= m_bSuspendQuickstartVeto;
break;
case DESKTOP_PROPHANDLE_DISPATCHRECORDERSUPPLIER: aValue >>= m_xDispatchRecorderSupplier;
break;
case DESKTOP_PROPHANDLE_TITLE: aValue >>= m_sTitle;
break;
}
}
/*-************************************************************************************************************//**
@short get value of a transient property
@descr This method is calling from helperclass "OPropertySetHelper".
Don't use this directly!
@attention We don't need any mutex or lock here ... We use threadsafe container or methods here only!
@seealso class OPropertySetHelper
@param "nHandle" handle of property to change
@param "aValue" current value of property
@return -
@onerror -
@threadsafe yes
*//*-*************************************************************************************************************/
void SAL_CALL Desktop::getFastPropertyValue( css::uno::Any& aValue ,
sal_Int32 nHandle ) const
{
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
switch( nHandle )
{
case DESKTOP_PROPHANDLE_ACTIVEFRAME : aValue <<= m_aChildTaskContainer.getActive();
break;
case DESKTOP_PROPHANDLE_ISPLUGGED : aValue <<= sal_False;
break;
case DESKTOP_PROPHANDLE_SUSPENDQUICKSTARTVETO: aValue <<= m_bSuspendQuickstartVeto;
break;
case DESKTOP_PROPHANDLE_DISPATCHRECORDERSUPPLIER: aValue <<= m_xDispatchRecorderSupplier;
break;
case DESKTOP_PROPHANDLE_TITLE: aValue <<= m_sTitle;
break;
}
}
/*-************************************************************************************************************//**
@short return structure and information about transient properties
@descr This method is calling from helperclass "OPropertySetHelper".
Don't use this directly!
@attention You must use global lock (method use static variable) ... and it must be the shareable osl mutex of it.
Because; our baseclass use this mutex to make his code threadsafe. We use our lock!
So we could have two different mutex/lock mechanism at the same object.
@seealso class OPropertySetHelper
@param -
@return structure with property-informations
@onerror -
@threadsafe yes
*//*-*************************************************************************************************************/
::cppu::IPropertyArrayHelper& SAL_CALL Desktop::getInfoHelper()
{
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
// Optimize this method !
// We initialize a static variable only one time. And we don't must use a mutex at every call!
// For the first call; pInfoHelper is NULL - for the second call pInfoHelper is different from NULL!
static ::cppu::OPropertyArrayHelper* pInfoHelper = NULL;
if( pInfoHelper == NULL )
{
// Ready for multithreading
::osl::MutexGuard aGuard( LockHelper::getGlobalLock().getShareableOslMutex() );
// Control this pointer again, another instance can be faster then these!
if( pInfoHelper == NULL )
{
// Define static member to give structure of properties to baseclass "OPropertySetHelper".
// "impl_getStaticPropertyDescriptor" is a non exported and static funtion, who will define a static propertytable.
// "sal_True" say: Table is sorted by name.
static ::cppu::OPropertyArrayHelper aInfoHelper( impl_getStaticPropertyDescriptor(), sal_True );
pInfoHelper = &aInfoHelper;
}
}
return(*pInfoHelper);
}
/*-************************************************************************************************************//**
@short return propertysetinfo
@descr You can call this method to get information about transient properties
of this object.
@attention You must use global lock (method use static variable) ... and it must be the shareable osl mutex of it.
Because; our baseclass use this mutex to make his code threadsafe. We use our lock!
So we could have two different mutex/lock mechanism at the same object.
@seealso class OPropertySetHelper
@seealso interface XPropertySet
@seealso interface XMultiPropertySet
@param -
@return reference to object with information [XPropertySetInfo]
@onerror -
@threadsafe yes
*//*-*************************************************************************************************************/
css::uno::Reference< css::beans::XPropertySetInfo > SAL_CALL Desktop::getPropertySetInfo() throw (::com::sun::star::uno::RuntimeException)
{
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
// Optimize this method !
// We initialize a static variable only one time. And we don't must use a mutex at every call!
// For the first call; pInfo is NULL - for the second call pInfo is different from NULL!
static css::uno::Reference< css::beans::XPropertySetInfo >* pInfo = NULL;
if( pInfo == NULL )
{
// Ready for multithreading
::osl::MutexGuard aGuard( LockHelper::getGlobalLock().getShareableOslMutex() );
// Control this pointer again, another instance can be faster then these!
if( pInfo == NULL )
{
// Create structure of propertysetinfo for baseclass "OPropertySetHelper".
// (Use method "getInfoHelper()".)
static css::uno::Reference< css::beans::XPropertySetInfo > xInfo( createPropertySetInfo( getInfoHelper() ) );
pInfo = &xInfo;
}
}
return (*pInfo);
}
/*-************************************************************************************************************//**
@short return current component of current frame
@descr The desktop himself has no component. But every frame in subtree.
If somewhere call getCurrentComponent() at this class, we try to find the right frame and
then we try to become his component. It can be a VCL-component, the model or the controller
of founded frame.
@attention We don't work on internal member ... so we doesn't need any lock here.
@seealso method getCurrentComponent();
@param "xFrame", reference to valid frame in hierarchy. Method is not defined for invalid values.
But we don't check these. Its an IMPL-method and caller must use it right!
@return A reference to found component.
@onerror A null reference is returned.
@threadsafe yes
*//*-*************************************************************************************************************/
css::uno::Reference< css::lang::XComponent > Desktop::impl_getFrameComponent( const css::uno::Reference< css::frame::XFrame >& xFrame ) const
{
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
// Set default return value, if method failed.
css::uno::Reference< css::lang::XComponent > xComponent;
// Does no controller exists?
css::uno::Reference< css::frame::XController > xController = xFrame->getController();
if( xController.is() == sal_False )
{
// Controller not exist - use the VCL-component.
xComponent = css::uno::Reference< css::lang::XComponent >( xFrame->getComponentWindow(), css::uno::UNO_QUERY );
}
else
{
// Does no model exists?
css::uno::Reference< css::frame::XModel > xModel( xController->getModel(), css::uno::UNO_QUERY );
if( xModel.is() == sal_True )
{
// Model exist - use the model as component.
xComponent = css::uno::Reference< css::lang::XComponent >( xModel, css::uno::UNO_QUERY );
}
else
{
// Model not exist - use the controller as component.
xComponent = css::uno::Reference< css::lang::XComponent >( xController, css::uno::UNO_QUERY );
}
}
return xComponent;
}
/*-************************************************************************************************************//**
@short create table with information about properties
@descr We use a helper class to support properties. These class need some information about this.
These method create a new static description table with name, type, r/w-flags and so on ...
@seealso class OPropertySetHelper
@seealso method getInfoHelper()
@param -
@return Static table with information about properties.
@onerror -
@threadsafe yes
*//*-*************************************************************************************************************/
const css::uno::Sequence< css::beans::Property > Desktop::impl_getStaticPropertyDescriptor()
{
// Create a new static property array to initialize sequence!
// Table of all predefined properties of this class. Its used from OPropertySetHelper-class!
// Don't forget to change the defines (see begin of this file), if you add, change or delete a property in this list!!!
// It's necessary for methods of OPropertySetHelper.
// ATTENTION:
// YOU MUST SORT FOLLOW TABLE BY NAME ALPHABETICAL !!!
static const css::beans::Property pProperties[] =
{
css::beans::Property( DESKTOP_PROPNAME_ACTIVEFRAME , DESKTOP_PROPHANDLE_ACTIVEFRAME , ::getCppuType((const css::uno::Reference< css::lang::XComponent >*)NULL) , css::beans::PropertyAttribute::TRANSIENT | css::beans::PropertyAttribute::READONLY ),
css::beans::Property( DESKTOP_PROPNAME_DISPATCHRECORDERSUPPLIER , DESKTOP_PROPHANDLE_DISPATCHRECORDERSUPPLIER, ::getCppuType((const css::uno::Reference< css::frame::XDispatchRecorderSupplier >*)NULL), css::beans::PropertyAttribute::TRANSIENT ),
css::beans::Property( DESKTOP_PROPNAME_ISPLUGGED , DESKTOP_PROPHANDLE_ISPLUGGED , ::getBooleanCppuType() , css::beans::PropertyAttribute::TRANSIENT | css::beans::PropertyAttribute::READONLY ),
css::beans::Property( DESKTOP_PROPNAME_SUSPENDQUICKSTARTVETO , DESKTOP_PROPHANDLE_SUSPENDQUICKSTARTVETO , ::getBooleanCppuType() , css::beans::PropertyAttribute::TRANSIENT ),
css::beans::Property( DESKTOP_PROPNAME_TITLE , DESKTOP_PROPHANDLE_TITLE , ::getCppuType((const ::rtl::OUString*)NULL) , css::beans::PropertyAttribute::TRANSIENT ),
};
// Use it to initialize sequence!
static const css::uno::Sequence< css::beans::Property > lPropertyDescriptor( pProperties, DESKTOP_PROPCOUNT );
// Return static "PropertyDescriptor"
return lPropertyDescriptor;
}
/*-************************************************************************************************************//**
@short work with our terminate listener
@descr If somewhere call terminate on this object, we must notify our listener. They could throw a veto exception
to break it or accept it by doing nothing. These two helper methods send right events to all registered
listener.
@attention We don't need any lock here - our container is threadsafe himself!
@seealso method terminate()
@param -
@return -
@onerror -
@threadsafe yes
*//*-*************************************************************************************************************/
void Desktop::impl_sendQueryTerminationEvent() throw( css::frame::TerminationVetoException )
{
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
// Send QueryTermination event to all listener.
// Get container for right listener.
::cppu::OInterfaceContainerHelper* pContainer = m_aListenerContainer.getContainer( ::getCppuType( ( const css::uno::Reference< css::frame::XTerminateListener >*) NULL ) );
if( pContainer != NULL )
{
// Build QueryTermination event.
css::lang::EventObject aEvent( static_cast< ::cppu::OWeakObject* >(this) );
// Get iterator for access to listener.
::cppu::OInterfaceIteratorHelper aIterator( *pContainer );
// Send message to all listener.
// Somewhere can throw a TerminationVetoException.
// We don't look for that(!) ... caller of this method will catch these.
while( aIterator.hasMoreElements() == sal_True )
{
try
{
((css::frame::XTerminateListener*)aIterator.next())->queryTermination( aEvent );
}
catch( css::uno::RuntimeException& )
{
aIterator.remove();
}
}
}
}
//*****************************************************************************************************************
void Desktop::impl_sendNotifyTerminationEvent()
{
/* UNSAFE AREA --------------------------------------------------------------------------------------------- */
// Register transaction and reject wrong calls.
TransactionGuard aTransaction( m_aTransactionManager, E_HARDEXCEPTIONS );
// Send NotifyTermination event to all listener.
// Get container for right listener.
::cppu::OInterfaceContainerHelper* pContainer = m_aListenerContainer.getContainer( ::getCppuType( ( const css::uno::Reference< css::frame::XTerminateListener >*) NULL ) );
if( pContainer != NULL )
{
// Build QueryTermination event.
css::lang::EventObject aEvent( static_cast< ::cppu::OWeakObject* >(this) );
// Get iterator for access to listener.
::cppu::OInterfaceIteratorHelper aIterator( *pContainer );
// Send message to all listener.
while( aIterator.hasMoreElements() == sal_True )
{
try
{
((css::frame::XTerminateListener*)aIterator.next())->notifyTermination( aEvent );
}
catch( css::uno::RuntimeException& )
{
aIterator.remove();
}
}
}
}
//_________________________________________________________________________________________________________________
// debug methods
//_________________________________________________________________________________________________________________
/*-----------------------------------------------------------------------------------------------------------------
The follow methods checks the parameter for other functions. If a parameter or his value is non valid,
we return "sal_True". (otherwise sal_False) This mechanism is used to throw an ASSERT!
-----------------------------------------------------------------------------------------------------------------*/
#ifdef ENABLE_ASSERTIONS
//*****************************************************************************************************************
// We work with valid servicemanager only.
sal_Bool Desktop::implcp_ctor( const css::uno::Reference< css::lang::XMultiServiceFactory >& xFactory )
{
return(
( &xFactory == NULL ) ||
( xFactory.is() == sal_False )
);
}
//*****************************************************************************************************************
// We work with valid listener only.
sal_Bool Desktop::implcp_addTerminateListener( const css::uno::Reference< css::frame::XTerminateListener >& xListener )
{
return(
( &xListener == NULL ) ||
( xListener.is() == sal_False )
);
}
//*****************************************************************************************************************
// We work with valid listener only.
sal_Bool Desktop::implcp_removeTerminateListener( const css::uno::Reference< css::frame::XTerminateListener >& xListener )
{
return(
( &xListener == NULL ) ||
( xListener.is() == sal_False )
);
}
//*****************************************************************************************************************
// The target frame could be ""(!), but flags must be in range of right enum.
sal_Bool Desktop::implcp_findFrame( const ::rtl::OUString& sTargetFrameName,
sal_Int32 nSearchFlags )
{
return(
( &sTargetFrameName == NULL ) ||
(
( nSearchFlags != css::frame::FrameSearchFlag::AUTO ) &&
( !( nSearchFlags & css::frame::FrameSearchFlag::PARENT ) ) &&
( !( nSearchFlags & css::frame::FrameSearchFlag::SELF ) ) &&
( !( nSearchFlags & css::frame::FrameSearchFlag::CHILDREN ) ) &&
( !( nSearchFlags & css::frame::FrameSearchFlag::CREATE ) ) &&
( !( nSearchFlags & css::frame::FrameSearchFlag::SIBLINGS ) ) &&
( !( nSearchFlags & css::frame::FrameSearchFlag::TASKS ) ) &&
( !( nSearchFlags & css::frame::FrameSearchFlag::ALL ) ) &&
( !( nSearchFlags & css::frame::FrameSearchFlag::GLOBAL ) )
)
);
}
//*****************************************************************************************************************
// We work with valid listener only.
sal_Bool Desktop::implcp_addEventListener( const css::uno::Reference< css::lang::XEventListener >& xListener )
{
return(
( &xListener == NULL ) ||
( xListener.is() == sal_False )
);
}
//*****************************************************************************************************************
// We work with valid listener only.
sal_Bool Desktop::implcp_removeEventListener( const css::uno::Reference< css::lang::XEventListener >& xListener )
{
return(
( &xListener == NULL ) ||
( xListener.is() == sal_False )
);
}
//*****************************************************************************************************************
sal_Bool Desktop::implcp_statusChanged( const css::frame::FeatureStateEvent& aEvent )
{
return(
( &aEvent == NULL ) ||
( aEvent.FeatureDescriptor.getLength() < 1 )
);
}
#endif // #ifdef ENABLE_ASSERTIONS
} // namespace framework
View Git Blame Copy Permalink