c5a06a3914
2008/04/01 15:18:19 thb 1.3.318.3: #i85898# Stripping all external header guards 2008/04/01 10:57:49 thb 1.3.318.2: #i85898# Stripping all external header guards 2008/03/28 15:34:40 rt 1.3.318.1: #i87441# Change license header to LPGL v3.
167 lines
6.7 KiB
C++
167 lines
6.7 KiB
C++
/*************************************************************************
|
||
*
|
||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||
*
|
||
* Copyright 2008 by Sun Microsystems, Inc.
|
||
*
|
||
* OpenOffice.org - a multi-platform office productivity suite
|
||
*
|
||
* $RCSfile: stillinteraction.hxx,v $
|
||
* $Revision: 1.4 $
|
||
*
|
||
* This file is part of OpenOffice.org.
|
||
*
|
||
* OpenOffice.org is free software: you can redistribute it and/or modify
|
||
* it under the terms of the GNU Lesser General Public License version 3
|
||
* only, as published by the Free Software Foundation.
|
||
*
|
||
* OpenOffice.org 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 version 3 for more details
|
||
* (a copy is included in the LICENSE file that accompanied this code).
|
||
*
|
||
* You should have received a copy of the GNU Lesser General Public License
|
||
* version 3 along with OpenOffice.org. If not, see
|
||
* <http://www.openoffice.org/license.html>
|
||
* for a copy of the LGPLv3 License.
|
||
*
|
||
************************************************************************/
|
||
|
||
#ifndef __FRAMEWORK_INTERACTION_STILLINTERACTION_HXX_
|
||
#define __FRAMEWORK_INTERACTION_STILLINTERACTION_HXX_
|
||
|
||
//_________________________________________________________________________________________________________________
|
||
// my own includes
|
||
//_________________________________________________________________________________________________________________
|
||
|
||
#include <threadhelp/threadhelpbase.hxx>
|
||
#include <macros/xinterface.hxx>
|
||
#include <macros/xtypeprovider.hxx>
|
||
#include <general.h>
|
||
|
||
//_________________________________________________________________________________________________________________
|
||
// interface includes
|
||
//_________________________________________________________________________________________________________________
|
||
#include <com/sun/star/task/XInteractionHandler.hpp>
|
||
#include <com/sun/star/task/XInteractionRequest.hpp>
|
||
|
||
//_________________________________________________________________________________________________________________
|
||
// other includes
|
||
//_________________________________________________________________________________________________________________
|
||
#include <cppuhelper/weak.hxx>
|
||
|
||
//_________________________________________________________________________________________________________________
|
||
// namespace
|
||
//_________________________________________________________________________________________________________________
|
||
|
||
namespace framework{
|
||
|
||
//_________________________________________________________________________________________________________________
|
||
// exported const
|
||
//_________________________________________________________________________________________________________________
|
||
|
||
//_________________________________________________________________________________________________________________
|
||
// exported definitions
|
||
//_________________________________________________________________________________________________________________
|
||
|
||
/**
|
||
@short handle interactions non visible
|
||
@descr Sometimes it's neccessary to use a non visible interaction handler.
|
||
He can't do anything, which a visible one can handle.
|
||
But it can be used to intercept problems e.g. during loading of documents.
|
||
|
||
In current implementation we solve conflicts for following situations only:
|
||
- AmbigousFilterRequest
|
||
- InteractiveIOException
|
||
- InteractiveAugmentedIOException
|
||
All other requests will be aborted.
|
||
|
||
@modified 12.07.2002 14:06
|
||
@by Andreas Schl<68>ns
|
||
*/
|
||
class StillInteraction : public css::lang::XTypeProvider
|
||
, public css::task::XInteractionHandler
|
||
, private ThreadHelpBase
|
||
, public ::cppu::OWeakObject
|
||
{
|
||
//_____________________________________
|
||
// member
|
||
private:
|
||
|
||
/// in case an unknown interaction was aborted - we save it for our external user!
|
||
css::uno::Any m_aRequest;
|
||
|
||
//_____________________________________
|
||
// uno interface
|
||
public:
|
||
|
||
// XInterface, XTypeProvider
|
||
FWK_DECLARE_XINTERFACE
|
||
FWK_DECLARE_XTYPEPROVIDER
|
||
|
||
//_________________________________
|
||
/**
|
||
@interface XInteractionHandler
|
||
@short called from outside to handle a problem
|
||
@descr The only interaction we can handle here is to
|
||
decide which of two ambigous filters should be realy used.
|
||
We use the user selected one every time.
|
||
All other request will be aborted and can break the code,
|
||
which use this interaction handler.
|
||
|
||
But you can use another method of this class to check for
|
||
some special interactions too: IO Exceptions
|
||
May a ComponentLoader needs that to throw suitable exception
|
||
on his own interface.
|
||
|
||
@threadsafe yes
|
||
*/
|
||
virtual void SAL_CALL handle( const css::uno::Reference< css::task::XInteractionRequest >& xRequest ) throw( css::uno::RuntimeException );
|
||
|
||
//_____________________________________
|
||
// c++ interface
|
||
public:
|
||
|
||
//_________________________________
|
||
/**
|
||
@short ctor to guarantee right initialized instances of this class
|
||
@descr -
|
||
|
||
@threadsafe not neccessary
|
||
*/
|
||
StillInteraction();
|
||
|
||
//_________________________________
|
||
/**
|
||
@short return the handled interaction request
|
||
@descr We saved any getted interaction request internaly.
|
||
May the outside user of this class is interessted
|
||
on that. Especialy we gotted an unknown interaction
|
||
and aborted it hard.
|
||
|
||
@return [com.sun.star.uno.Any]
|
||
the packed interaction request
|
||
Can be empty if no interaction was used!
|
||
|
||
@threadsafe yes
|
||
*/
|
||
css::uno::Any getRequest() const;
|
||
|
||
//_________________________________
|
||
/**
|
||
@short returns information if interaction was used
|
||
@descr It can be usefully to know the reason for a failed operation.
|
||
|
||
@return [boolean]
|
||
<TRUE/> for used interaction
|
||
<FALSE/> otherwhise
|
||
|
||
@threadsafe yes
|
||
*/
|
||
sal_Bool wasUsed() const;
|
||
};
|
||
|
||
} // namespace framework
|
||
|
||
#endif // #ifndef __FRAMEWORK_INTERACTION_STILLINTERACTION_HXX_
|