office-gobmx/desktop/source/app/configinit.hxx
2011-03-29 21:40:28 +01:00

74 lines
2.5 KiB
C++

/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
#ifndef _DESKTOP_CONFIGINIT_HXX_
#define _DESKTOP_CONFIGINIT_HXX_
#include <com/sun/star/lang/XMultiServiceFactory.hpp>
#include <rtl/ustring.hxx>
/** creates a ConfigurationProvider instance
Important: exceptions thrown from that method will contain a readily
displayable message.
@return
The default configuration provider for the application or<br/>
<NULL/>, if startup was canceled
@throw com::sun::star::configuration::CannotLoadConfigurationException
if the configuration provider can't be created
@throw com::sun::star::lang::ServiceNotRegisteredException
if the ConfigurationProvider service is unknwon
@throw com::sun::star::lang::WrappedTargetException
if the configuration backend could be created,
but incurred a failure later
*/
extern
com::sun::star::uno::Reference< com::sun::star::lang::XMultiServiceFactory >
CreateApplicationConfigurationProvider( );
//-----------------------------------------------------------------------------
#include <com/sun/star/task/XInteractionHandler.hpp>
/**
sets an InteractionHandler for configuration errors in the current context.
*/
class ConfigurationErrorHandler
{
public:
typedef com::sun::star::uno::Reference< com::sun::star::task::XInteractionHandler > InteractionHandler;
/// Constructor: Uses the default interaction handler
ConfigurationErrorHandler()
: m_pContext(0), m_xHandler()
{}
/// Constructor: Uses an externally provided interaction handler
ConfigurationErrorHandler(const InteractionHandler & xHandler)
: m_pContext(0), m_xHandler( xHandler )
{}
~ConfigurationErrorHandler();
static InteractionHandler getDefaultInteractionHandler();
/// installs the handler into the current context
void activate();
/// deinstalls the handler from the current context, restoring the previous context
void deactivate();
private:
class Context;
Context * m_pContext;
InteractionHandler m_xHandler;
private:
// not implemented - suppress copy
ConfigurationErrorHandler(const ConfigurationErrorHandler&);
void operator=(const ConfigurationErrorHandler&);
};
//-----------------------------------------------------------------------------
#endif
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */