summaryrefslogtreecommitdiffstats
path: root/part/kxenewfilesettings.h
blob: b1203ec8b1ee73cef454e524c147601469cedbe1 (plain)
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
105
106
107
108
109
110
111
/***************************************************************************
                           kxenewfilesettings.h
                           --------------------
    begin                : Tue Dec 02 2003
    copyright            : (C) 2003 by The KXMLEditor Team
    email                : [email protected]
 ***************************************************************************/

/***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/

#ifndef KXENEWFILESETTINGS_H
#define KXENEWFILESETTINGS_H

#include "kxesettings.h"

class KXENewFileSettingsPage;

/**
 * This class represents the group of configuration settings for
 * new files.
 *
 * @author Olaf Hartig
 */
class KXENewFileSettings : public KXESettings
{
	public:

		enum NewFileCreationBehaviour
		{
			CreateEmptyFile,
			CreateWithAssistance,
			UseDefaults
		};

		KXENewFileSettings( QObject * pParent = 0, const char * pszName = 0 );

		// The following functions can be used to access this object's settings.
		QString dfltVersion() const { return m_strDfltVersion; }
		QString dfltEncoding() const { return m_strDfltEncoding; }
		NewFileCreationBehaviour newFileCreaBehav() const { return m_enmNewFileCreaBehav; }

		/**
		 * Returns a list of all possible encodings.
		 */
		static QStringList encodings();

		/**
		 * Sets this object's new file creation behavior to the given one,
		 * updates the corresponding widget (in the config.dialog page
		 * @ref m_pDialogPage), stores this value to the given config.file
		 * and emits the signal @ref KXESettings::sigChanged.
		 */
		void setNewFileCreaBehav( NewFileCreationBehaviour, KConfig * );

		/**
		 * Derived from @ref KXESettings
		 */
		virtual QString dialogPageName() const;
		/**
		 * Derived from @ref KXESettings
		 */
		virtual QString dialogPageHeader() const;
		/**
		 * Derived from @ref KXESettings
		 */
		virtual QString dialogPageIcon() const;
		/**
		 * Derived from @ref KXESettings
		 */
		virtual QWidget * dialogPage( QFrame * pParent );

	protected:

		/**
		 * Derived from @ref KXESettings
		 */
		virtual void write( KConfig * ) const;
		/**
		 * Derived from @ref KXESettings
		 */
		virtual void read( const KConfig * );
		/**
		 * Derived from @ref KXESettings
		 */
		virtual void setFromPage();
		/**
		 * Derived from @ref KXESettings
		 */
		virtual void updatePage() const;

		// the settings itself
		QString m_strDfltVersion;
		QString m_strDfltEncoding;
		NewFileCreationBehaviour m_enmNewFileCreaBehav;

		/**
		 * the corresponding configuration dialog page
		 * It is created on demand by @ref dialogPage.
		 */
		KXENewFileSettingsPage * m_pDialogPage;

};

#endif