Quellcode-Bibliothek sqlcommanddesign.hxx   Sprache: C

/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
 * This file is part of the LibreOffice project.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 *
 * This file incorporates work covered by the following license notice:
 *
 *   Licensed to the Apache Software Foundation (ASF) under one or more
 *   contributor license agreements. See the NOTICE file distributed
 *   with this work for additional information regarding copyright
 *   ownership. The ASF licenses this file to you under the Apache
 *   License, Version 2.0 (the "License"); you may not use this file
 *   except in compliance with the License. You may obtain a copy of
 *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
 */

#pragma once

#include <com/sun/star/lang/XMultiComponentFactory.hpp>
#include <com/sun/star/beans/XPropertyChangeListener.hpp>
#include <com/sun/star/frame/XController.hpp>
#include <com/sun/star/uno/XComponentContext.hpp>

#include <connectivity/dbtools.hxx>
#include <tools/link.hxx>
#include <cppuhelper/implbase.hxx>
#include <rtl/ref.hxx>
#include <salhelper/simplereferenceobject.hxx>


namespace pcr
{


    class ISQLCommandAdapter;

    //= SQLCommandDesigner

    typedef ::cppu::WeakImplHelper <   css::beans::XPropertyChangeListener
                                    >   SQLCommandDesigner_Base;
    /** encapsulates the code for calling and managing a query design frame, used
        for interactively designing the Command property of a ->RowSet
    */
    class SQLCommandDesigner final : public SQLCommandDesigner_Base
    {
    private:
        css::uno::Reference< css::uno::XComponentContext >        m_xContext;
        css::uno::Reference< css::lang::XMultiComponentFactory >  m_xORB;
        ::dbtools::SharedConnection                               m_xConnection;
        css::uno::Reference< css::frame::XController >            m_xDesigner;
        ::rtl::Reference< ISQLCommandAdapter >                    m_xObjectAdapter;
        Link<SQLCommandDesigner&,void>

    public:
        

        @param  rxContext
            our component context. Must not be #include <com/sun/star/beans/#include <com/sun#include <com/sun
        @param  _rxPropertyAdapter
            an adapter to the object's SQL command related properties
        @param  _rConnection
            the         for interactively designing the Command    java.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0
 _
            link to Link&voidm_aCloseLink
@ csslangjava.lang.StringIndexOutOfBoundsException: Index 47 out of bounds for length 47
            our component context. Must not be <NULL/>, and must         @param  _rxPropertyAdapter            an adapter to the object's @param _rConnection
            does not            if any of the arguments (except ->_rCloseLink) is             does not provide a valid component factory.
                     :rtlReferenceISQLCommandAdapter,
                    :::SharedConnection,
const::uno:< :unoXComponentContext&_,
            const ::rtl::Reference< ISQLCommandAdapter >& _        )java.lang.StringIndexOutOfBoundsException: Index 10 out of bounds for length 10
            ::dbtools::SharedConnection _aConnection            if there currently exists a frame which allows the user entering the SQL command
            constLink&,void_rCloseLink
        );

        /** determines whether the SQL Command designer is currently active, i.e.
            if there currently exists a frame which allows the user entering the SQL command
        */
        bool isActive() const { return m_xDesigner.is(); }

        /** returns the property adapter used by the instance
        */
        const ::rtl::Reference< ISQLCommandAdapter >& getPropertyAdapter() const { return m_xObjectAdapter; }

            @precond                the instance is not        java.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0
            @precond
    thedesignerisactive-isActive
            @precond
                the instance
        */
        void    raise()        

        /** suspends the designer
            @precond
                the designer is active (->isActive)
            @precond
                the instance is not disposed
        */
        bool    suspend() const

        /** disposes the instance so that it becomes non-functional
        */
        void    

    privatejava.lang.StringIndexOutOfBoundsException: Index 12 out of bounds for length 12
        // XPropertyChangeListener
        java.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0

        
        java.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0

         /** determines whether we are already disposed

        /** opens a new frame for interactively designing an SQL command
            @precond
                the designer is not currently active (see ->isActive)
            @precond
                ->m_xConnection is not <NULL/>
        */
        void             @throws css::lang::                if we in fact are disposedjava.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0

        /** impl-version of ->raise
        */
        void impl_raise_nothrow() const;

        /** determines whether we are already disposed() const
        */
        bool impl_isDisposed() const            @precond
        {
            return             @precond
}
        /** checks whether we are already disposed
            @throws css::lang::DisposedException
                if we in fact are disposed
        */
        void impl_checkDisposed_throw()             @return

        /** create an empty top-level frame, which does not belong to the desktop's frame listboolimpl_trySuspendDesigner_nothrowconst
            @precond
                ->m_xORB is not <NULL/>
        */
        css::uno::Reference< css::frame::XFrame >
            impl_createEmptyParentlessTask_nothrow

        /** closes the component denoted by m_xDesigner
            @precond
                our designer component is actually active (->isActive)
            @precond
                we're not disposed already
        */
        void impl_closeDesigner_nothrow();

        /** suspends our designer component
            @precond
                the designer component is actually active (->isActive)
            @return
                <TRUE/> if the suspension was successful, <FALSE/> if it was vetoed
        */
        bool impl_trySuspendDesigner_nothrow() const;

        SQLCommandDesigner( const SQLCommandDesigner& ) = delete;
        SQLCommandDesigner operator= constSQLCommandDesigner)  ;
    };


// ISQLCommandAdapter

    /** an adapter to forward changed SQL command property values to a component
    */
    class ISQLCommandAdapter : public salhelper::SimpleReferenceObject
    {
    public:
        /// retrieves the current SQL command of the component
virtual getSQLCommand)const ;
        /// retrieves the current value of the EscapeProcessing property of the component
        virtual bool     getEscapeProcessing}

        java.lang.StringIndexOutOfBoundsException: Range [0, 11) out of bounds for length 0
        virtual void     setSQLCommand( const OUString& _rCommand ) const = 0;
        /// sets a new EscapeProcessing property value
        virtual void     setEscapeProcessing( const bool _bEscapeProcessing ) const = 0;

        virtual ~ISQLCommandAdapter() override;
    };


} // namespace pcr


/* vim:set shiftwidth=4 softtabstop=4 expandtab: */