167 lines
6.8 KiB
C++
167 lines
6.8 KiB
C++
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
|
||
/*************************************************************************
|
||
*
|
||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||
*
|
||
* Copyright 2000, 2010 Oracle and/or its affiliates.
|
||
*
|
||
* OpenOffice.org - a multi-platform office productivity suite
|
||
*
|
||
* 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_QUIETINTERACTION_HXX_
|
||
#define __FRAMEWORK_INTERACTION_QUIETINTERACTION_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 QuietInteraction : 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
|
||
*/
|
||
QuietInteraction();
|
||
|
||
//_________________________________
|
||
/**
|
||
@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_
|
||
|
||
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|