include/comphelper/simplefileaccessinteraction.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
  10 #ifndef INCLUDED_COMPHELPER_SIMPLEFILEACCESSINTERACTION_HXX
  11 #define INCLUDED_COMPHELPER_SIMPLEFILEACCESSINTERACTION_HXX
  12
  13 #include <sal/config.h>
  14 #include <ucbhelper/interceptedinteraction.hxx>
  15 #include <comphelper/comphelperdllapi.h>
  16
  17 namespace com::sun::star::task { class XInteractionHandler; }
  18
  19 namespace comphelper {
  20 /** An interaction handler wrapper for simple file access.
  21
  22     This wrapper is to be used together with XSimpleFileAccess when
  23     you want to avoid the error messages displayed when accessing a file (the messages activated
  24     by ucphelper::cancelCommandExecution).
  25
  26     This wrapper is especially useful when you need to access a Web/DAV connection
  27     enabling https certificate validation and optionally enabling the authentication
  28     dialog that may be needed in these operations.
  29
  30     @param xHandler
  31     Used handler, always needed.
  32     It will be used for Certificate Validation dialog or authentication dialog.
  33     The authentication is used in Web/DAV access when the server requests credentials to be accessed.
  34 */
  35 class COMPHELPER_DLLPUBLIC SimpleFileAccessInteraction final : public ::ucbhelper::InterceptedInteraction
  36 {
  37
  38 public:
  39     SimpleFileAccessInteraction(const css::uno::Reference< css::task::XInteractionHandler >& xHandler);
  40     virtual ~SimpleFileAccessInteraction() override;
  41
  42 private:
  43
  44     virtual ucbhelper::InterceptedInteraction::EInterceptionState intercepted(const ::ucbhelper::InterceptedInteraction::InterceptedRequest& aRequest,
  45         const css::uno::Reference< css::task::XInteractionRequest >& xRequest) override;
  46
  47 };
  48 }
  49 #endif
  50
  51 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */