You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
104 lines
3.2 KiB
104 lines
3.2 KiB
/* This file is part of the KDE project
|
|
Copyright (C) 2005-2006 Jaroslaw Staniek <js@iidea.pl>
|
|
|
|
This library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Library General Public
|
|
License as published by the Free Software Foundation; either
|
|
version 2 of the License, or (at your option) any later version.
|
|
|
|
This library 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
|
|
Library General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Library General Public License
|
|
along with this library; see the file COPYING.LIB. If not, write to
|
|
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
* Boston, MA 02110-1301, USA.
|
|
*/
|
|
|
|
#ifndef KEXIDBDRIVERCOMBOBOX_H
|
|
#define KEXIDBDRIVERCOMBOBOX_H
|
|
|
|
#include <tqwidget.h>
|
|
#include <tqmap.h>
|
|
|
|
#include <kcombobox.h>
|
|
|
|
#include <kexidb/driver.h>
|
|
|
|
//! \brief Combo box widget for selecting a database driver
|
|
/*! This widget provides a combobox for selecting a database driver.
|
|
|
|
|
|
\b Usage: \n
|
|
\code
|
|
KexiDB::DriverManager manager;
|
|
KexiDB::Driver::InfoMap drvs = manager.driversInfo();
|
|
|
|
KexiDBDriverComboBox* combo = new KexiDBDriverComboBox(drvs, true, 0);
|
|
\endcode
|
|
|
|
A more complete example can be found in
|
|
<a href="http://websvn.kde.org/trunk/koffice/kexi/tests/widgets/kexidbdrivercombotest.cpp?&view=auto">koffice/kexi/tests/widgets/</a>.
|
|
|
|
*/
|
|
|
|
class KEXIEXTWIDGETS_EXPORT KexiDBDriverComboBox : public KComboBox
|
|
{
|
|
TQ_OBJECT
|
|
|
|
|
|
public:
|
|
enum Options {
|
|
ShowFileDrivers = 1,
|
|
ShowServerDrivers = 2,
|
|
ShowAll = ShowFileDrivers|ShowServerDrivers
|
|
};
|
|
|
|
/*! Constructs a KexiDBDriverComboBox object.
|
|
|
|
The combobox is populated with the names of the drivers in
|
|
\a driversInfo. A suitable value for \a driversInfo can be obtained
|
|
from KexiDB::DriverManager::driversInfo().
|
|
|
|
If \a includeFileBasedDrivers is set to false, then only those drivers
|
|
that are for database servers (those which have X-Kexi-DriverType=Network
|
|
in their .desktop file) are shown. */
|
|
KexiDBDriverComboBox(TQWidget* parent, const KexiDB::Driver::InfoMap& driversInfo,
|
|
Options options = ShowAll );
|
|
|
|
~KexiDBDriverComboBox();
|
|
|
|
/*! Gets a list of the names of all drivers.
|
|
|
|
Note that this returns just the names of those drivers that are in the
|
|
combobox: if the includeFileBasedDrivers argument to the constructor
|
|
was false, this won't include the file based drivers either.
|
|
|
|
\return a list of names of drivers that were found */
|
|
TQStringList driverNames() const { return m_driverNames; }
|
|
|
|
/*! Get the name of the currrently selected driver. If the combobox is empty,
|
|
TQString() will be returned.
|
|
|
|
\return the name of the currently selected driver */
|
|
TQString selectedDriverName() const;
|
|
|
|
/*! Set the currrently selected driver.
|
|
|
|
The combobox entry for \a driverName is selected. If \a driverName
|
|
is not listed in the combobox then there is no change. The search
|
|
is case insensitive.
|
|
|
|
*/
|
|
void setDriverName(const TQString& driverName);
|
|
|
|
protected:
|
|
TQMap<TQString,TQString> m_driversMap;
|
|
TQStringList m_driverNames;
|
|
};
|
|
|
|
#endif
|
|
|