1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
|
/* This file is part of the KDE Project
Copyright (C) 2000 Klaas Freitag <freitag@suse.de>
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 DEVSELECTOR_H
#define DEVSELECTOR_H
#include <kdialogbase.h>
class QButtonGroup;
class QStrList;
class QStringList;
class QCheckBox;
/**
*@author Klaas Freitag
*/
/* Configuration-file definitions */
#define GROUP_STARTUP "Scan Settings"
#define STARTUP_SCANDEV "ScanDevice"
#define STARTUP_SKIP_ASK "SkipStartupAsk"
#define STARTUP_ONLY_LOCAL "QueryLocalOnly"
/**
* A utitlity class that lets the user select a scan device.
*
* This class provides functions to get the scan device to use for an
* application with scan support.
*
* Its main purpose is to display a selection dialog, but it also reads
* and writes config entries to store the users selection and handles
* a field 'do not ask me again'.
*
*/
class DeviceSelector: public KDialogBase
{
Q_OBJECT
public:
/**
* constructs the dialog class
* @param QWidget *parent - the parent
* @param QStrList backends - a list of device names retrieved from the scan device
* @param QStrList scannerNames - a list of corresponding human readable sanner names.
*/
DeviceSelector( QWidget *parent, QStrList&, const QStringList& );
~DeviceSelector();
/**
* returns the device the user selected.
* @return a CString containing the technical name of the selected device (taken from
* the backends-list from the constructor)
*/
QCString getSelectedDevice( void ) const;
/**
* returns the users selection if the dialog should be skipped in future.
* @return true for should be skipped.
*/
bool getShouldSkip( void ) const;
/**
* retrieval to get the device from the config file. The function reads the applications
* config file, cares for the 'do not ask me again'-settings and checks if the scandevice
* specified in the config file is present at the current configuration.
* If this function returns null, the DeviceSelector should be opened for a user selection.
* @return a string containing the device to open or null if no device is specified or the
* one specified is not valid.
*/
QCString getDeviceFromConfig( void ) const;
public slots:
void setScanSources( const QStrList&, const QStringList& );
private:
QButtonGroup *selectBox;
mutable QStrList devices;
QCheckBox *cbSkipDialog;
bool configDevValid;
class DeviceSelectorPrivate;
DeviceSelectorPrivate *d;
};
#endif
|
