1 /* |
|
2 * Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). |
|
3 * All rights reserved. |
|
4 * This component and the accompanying materials are made available |
|
5 * under the terms of "Eclipse Public License v1.0"" |
|
6 * which accompanies this distribution, and is available |
|
7 * at the URL "http://www.eclipse.org/legal/epl-v10.html". |
|
8 * |
|
9 * Initial Contributors: |
|
10 * Nokia Corporation - initial contribution. |
|
11 * |
|
12 * Contributors: |
|
13 * |
|
14 * Description: |
|
15 * |
|
16 */ |
|
17 #include "cpsettingformentryitemdata.h" |
|
18 #include "cpsettingformentryitemdata_p.h" |
|
19 #include "cpviewlauncher.h" |
|
20 #include <cpbasesettingview.h> |
|
21 |
|
22 |
|
23 /*! |
|
24 \class CpSettingFormEntryItemData |
|
25 \brief The CpSettingFormEntryItemData can be used to control panel plugin which appears as a setting item. And after clicking |
|
26 it, a new setting view will open. |
|
27 */ |
|
28 |
|
29 /* |
|
30 \fn CpSettingFormEntryItemData::createSettingView |
|
31 |
|
32 Create a new setting view. |
|
33 |
|
34 createSettingView will be called automatically when user click a setting item represented by a CpSettingFormEntryItemData. |
|
35 |
|
36 In most cases, you do not need to write a derived class from CpSettingFormEntryItemData, instead, you can simply use template class CpSettingFormEntryItemDataImpl. |
|
37 */ |
|
38 |
|
39 |
|
40 /*! |
|
41 Construct a new CpSettingFormEntryItemData with the given parent. |
|
42 */ |
|
43 CpSettingFormEntryItemData::CpSettingFormEntryItemData(const HbDataFormModelItem *parent /* = 0*/) |
|
44 : CpSettingFormItemData(parent), d_ptr(new CpSettingFormEntryItemDataPrivate()) |
|
45 { |
|
46 d_ptr->init(this); |
|
47 } |
|
48 |
|
49 |
|
50 /*! |
|
51 Construct a new CpSettingFormEntryItemData with the given text,description and parent. |
|
52 */ |
|
53 |
|
54 CpSettingFormEntryItemData::CpSettingFormEntryItemData(CpItemDataHelper &itemDataHelper, |
|
55 const QString &text /* = QString()*/, |
|
56 const QString &description /* = QString()*/, |
|
57 const HbIcon &icon, |
|
58 const HbDataFormModelItem *parent /*= 0*/) : |
|
59 CpSettingFormItemData(HbDataFormModelItem::CustomItemBase,QString(),parent), |
|
60 d_ptr(new CpSettingFormEntryItemDataPrivate(&itemDataHelper)) |
|
61 { |
|
62 setType ( static_cast<HbDataFormModelItem::DataItemType> (CpSettingFormEntryItemData::ListEntryItem) ); |
|
63 |
|
64 d_ptr->init(this); |
|
65 |
|
66 setText(text); |
|
67 setDescription(description); |
|
68 setIcon(icon.iconName()); |
|
69 } |
|
70 |
|
71 /*! |
|
72 Construct a new CpSettingFormEntryItemData with the given text,description and parent. |
|
73 */ |
|
74 |
|
75 CpSettingFormEntryItemData::CpSettingFormEntryItemData(HbDataForm *dataForm, |
|
76 const QString &text /*= QString()*/, |
|
77 const QString &description /*= QString()*/, |
|
78 const HbIcon &icon /*= HbIcon()*/, |
|
79 const HbDataFormModelItem *parent/* = 0*/) : |
|
80 CpSettingFormItemData(HbDataFormModelItem::CustomItemBase,QString(),parent), |
|
81 d_ptr(new CpSettingFormEntryItemDataPrivate(dataForm)) |
|
82 { |
|
83 setType ( static_cast<HbDataFormModelItem::DataItemType> (CpSettingFormEntryItemData::ListEntryItem) ); |
|
84 |
|
85 d_ptr->init(this); |
|
86 |
|
87 setText(text); |
|
88 setDescription(description); |
|
89 setIcon(icon.iconName()); |
|
90 } |
|
91 |
|
92 /*! |
|
93 Construct a new CpSettingFormEntryItemData with the given type, text, description, icon name, and parent. |
|
94 */ |
|
95 CpSettingFormEntryItemData::CpSettingFormEntryItemData( |
|
96 EntryItemType type, |
|
97 CpItemDataHelper &itemDataHelper, |
|
98 const QString &text /*= QString()*/, |
|
99 const QString &description /*= QString()*/, |
|
100 const QString &iconName /*= QString()*/, |
|
101 const HbDataFormModelItem *parent /*= 0*/) : |
|
102 CpSettingFormItemData(HbDataFormModelItem::CustomItemBase,QString(),parent), |
|
103 d_ptr(new CpSettingFormEntryItemDataPrivate(&itemDataHelper)) |
|
104 { |
|
105 setType ( static_cast<HbDataFormModelItem::DataItemType> (type) ); |
|
106 |
|
107 d_ptr->init(this); |
|
108 |
|
109 setText(text); |
|
110 setDescription(description); |
|
111 setIcon(iconName); |
|
112 } |
|
113 |
|
114 /*! |
|
115 Construct a new CpSettingFormEntryItemData with the given type, text, description, icon name, and parent. |
|
116 */ |
|
117 CpSettingFormEntryItemData::CpSettingFormEntryItemData( |
|
118 EntryItemType type, |
|
119 HbDataForm *dataForm, |
|
120 const QString &text /*= QString()*/, |
|
121 const QString &description /*= QString()*/, |
|
122 const QString &iconName /*= QString()*/, |
|
123 const HbDataFormModelItem *parent /*= 0*/) : |
|
124 CpSettingFormItemData(HbDataFormModelItem::CustomItemBase,QString(),parent), |
|
125 d_ptr(new CpSettingFormEntryItemDataPrivate(dataForm)) |
|
126 { |
|
127 setType ( static_cast<HbDataFormModelItem::DataItemType> (type) ); |
|
128 |
|
129 d_ptr->init(this); |
|
130 |
|
131 setText(text); |
|
132 setDescription(description); |
|
133 setIcon(iconName); |
|
134 } |
|
135 |
|
136 |
|
137 /*! |
|
138 Destructor. |
|
139 */ |
|
140 CpSettingFormEntryItemData::~CpSettingFormEntryItemData() |
|
141 { |
|
142 delete d_ptr; |
|
143 } |
|
144 |
|
145 |
|
146 /*! |
|
147 Get the text string of the entry item. |
|
148 */ |
|
149 QString CpSettingFormEntryItemData::text() const |
|
150 { |
|
151 return d_ptr->text(); |
|
152 } |
|
153 |
|
154 /*! |
|
155 Set the text string of the entry item. |
|
156 */ |
|
157 void CpSettingFormEntryItemData::setText(const QString &text) |
|
158 { |
|
159 d_ptr->setText(text); |
|
160 } |
|
161 |
|
162 /*! |
|
163 Get the description string of the entry item. |
|
164 */ |
|
165 QString CpSettingFormEntryItemData::description() const |
|
166 { |
|
167 return d_ptr->description(); |
|
168 } |
|
169 |
|
170 /*! |
|
171 Set the description string of the entry item. |
|
172 */ |
|
173 void CpSettingFormEntryItemData::setDescription(const QString &description) |
|
174 { |
|
175 d_ptr->setDescription(description); |
|
176 } |
|
177 |
|
178 /*! |
|
179 Get the icon name of the entry item. |
|
180 */ |
|
181 QString CpSettingFormEntryItemData::iconName() const |
|
182 { |
|
183 return d_ptr->iconName(); |
|
184 } |
|
185 |
|
186 /*! |
|
187 Set the icon name of the entry item. |
|
188 */ |
|
189 void CpSettingFormEntryItemData::setIconName(const QString &icon) |
|
190 { |
|
191 d_ptr->setIconName(icon); |
|
192 } |
|
193 |
|
194 /*! |
|
195 Return the icon of the entry item |
|
196 */ |
|
197 HbIcon CpSettingFormEntryItemData::entryItemIcon()const |
|
198 { |
|
199 return d_ptr->entryItemIcon(); |
|
200 } |
|
201 |
|
202 /*! |
|
203 Set the icon for the entry item |
|
204 */ |
|
205 void CpSettingFormEntryItemData::setEntryItemIcon(const HbIcon& icon) |
|
206 { |
|
207 d_ptr->setEntryItemIcon(icon); |
|
208 } |
|
209 |
|
210 /*! |
|
211 Launch the setting view when user clicks the entry item. |
|
212 */ |
|
213 void CpSettingFormEntryItemData::onLaunchView() |
|
214 { |
|
215 //avoid being launched more than one times |
|
216 if (d_ptr->mSettingViewPtr.isNull()) { |
|
217 d_ptr->mSettingViewPtr = createSettingView(); |
|
218 if (!d_ptr->mSettingViewPtr.isNull()) { |
|
219 CpViewLauncher::launchView(d_ptr->mSettingViewPtr.data()); |
|
220 } |
|
221 } |
|
222 } |
|
223 |
|
224 //End of File |
|