sfx2/source/appl/imestatuswindow.hxx

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /*
   3  * This file is part of the LibreOffice project.
   4  *
   5  * This Source Code Form is subject to the terms of the Mozilla Public
   6  * License, v. 2.0. If a copy of the MPL was not distributed with this
   7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
   8  *
   9  * This file incorporates work covered by the following license notice:
  10  *
  11  *   Licensed to the Apache Software Foundation (ASF) under one or more
  12  *   contributor license agreements. See the NOTICE file distributed
  13  *   with this work for additional information regarding copyright
  14  *   ownership. The ASF licenses this file to you under the Apache
  15  *   License, Version 2.0 (the "License"); you may not use this file
  16  *   except in compliance with the License. You may obtain a copy of
  17  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
  18  */
  19
  20 #ifndef INCLUDED_SFX2_SOURCE_APPL_IMESTATUSWINDOW_HXX
  21 #define INCLUDED_SFX2_SOURCE_APPL_IMESTATUSWINDOW_HXX
  22
  23 #include <com/sun/star/beans/XPropertyChangeListener.hpp>
  24 #include <com/sun/star/uno/Reference.hxx>
  25 #include <cppuhelper/implbase1.hxx>
  26 #include <osl/mutex.hxx>
  27
  28 namespace com { namespace sun { namespace star {
  29     namespace beans { class XPropertySet; }
  30     namespace lang { class XMultiServiceFactory; }
  31     namespace uno { class XComponentContext; }
  32 } } }
  33
  34 namespace sfx2 { namespace appl {
  35
  36 // The MS compiler needs this typedef work-around to accept the using
  37 // declarations within ImeStatusWindow:
  38 typedef cppu::WeakImplHelper1< com::sun::star::beans::XPropertyChangeListener >
  39 ImeStatusWindow_Impl;
  40
  41 /** Control the behavior of any (platform-dependent) IME status windows.
  42
  43     The decision of whether a status window shall be displayed or not can be
  44     stored permanently in the configuration (under key
  45     org.openoffice.office.Common/I18N/InputMethod/ShowStatusWindow; if that
  46     entry is nil, VCL is asked for a default).
  47  */
  48 class ImeStatusWindow: private ImeStatusWindow_Impl
  49 {
  50 public:
  51     ImeStatusWindow( com::sun::star::uno::Reference< com::sun::star::uno::XComponentContext > const& rxContext );
  52
  53     /** Set up VCL according to the configuration.
  54
  55         Is it not strictly required that this method is called exactly once
  56         (though that will be the typical use).
  57
  58         Must only be called with the Solar mutex locked.
  59      */
  60     void init();
  61
  62     /** Return true if the status window is toggled on.
  63
  64         This is only meaningful when canToggle returns true.
  65
  66         Can be called without the Solar mutex locked.
  67      */
  68     bool isShowing();
  69
  70     /** Toggle the status window on or off.
  71
  72         This only works if canToggle returns true (otherwise, any calls of this
  73         method are ignored).
  74
  75         Must only be called with the Solar mutex locked.
  76      */
  77     void show(bool bShow);
  78
  79     /** Return true if the status window can be toggled on and off externally.
  80
  81         Must only be called with the Solar mutex locked.
  82      */
  83     static bool canToggle();
  84
  85     using ImeStatusWindow_Impl::acquire;
  86     using ImeStatusWindow_Impl::release;
  87     using ImeStatusWindow_Impl::operator new;
  88     using ImeStatusWindow_Impl::operator delete;
  89
  90 private:
  91     ImeStatusWindow(ImeStatusWindow &) SAL_DELETED_FUNCTION;
  92     void operator =(const ImeStatusWindow&) SAL_DELETED_FUNCTION;
  93
  94     virtual ~ImeStatusWindow();
  95
  96     virtual void SAL_CALL
  97     disposing(com::sun::star::lang::EventObject const & rSource)
  98         throw (com::sun::star::uno::RuntimeException, std::exception) SAL_OVERRIDE;
  99
 100     virtual void SAL_CALL
 101     propertyChange(com::sun::star::beans::PropertyChangeEvent const & rEvent)
 102         throw (com::sun::star::uno::RuntimeException, std::exception) SAL_OVERRIDE;
 103
 104     com::sun::star::uno::Reference< com::sun::star::beans::XPropertySet >
 105     getConfig();
 106
 107     com::sun::star::uno::Reference< com::sun::star::uno::XComponentContext >
 108         m_xContext;
 109
 110     osl::Mutex m_aMutex;
 111     com::sun::star::uno::Reference< com::sun::star::beans::XPropertySet >
 112         m_xConfig;
 113     com::sun::star::uno::Reference< com::sun::star::beans::XPropertyChangeListener >
 114         m_xConfigListener;
 115     bool m_bDisposed;
 116 };
 117
 118 } }
 119
 120 #endif // INCLUDED_SFX2_SOURCE_APPL_IMESTATUSWINDOW_HXX
 121
 122 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */