author | zautrix <zautrix> | 2005-04-28 09:08:21 (UTC) |
---|---|---|
committer | zautrix <zautrix> | 2005-04-28 09:08:21 (UTC) |
commit | 8fbdf5d2b0ee1e1496cb856e0ead37c668066353 (patch) (unidiff) | |
tree | 964dd57f1492857fb9471a0af9943d08c56e5c6e /qtcompat/qinputdialog.cpp | |
parent | 42786862c89c0de78cec783f251eae66bcbc53db (diff) | |
download | kdepimpi-8fbdf5d2b0ee1e1496cb856e0ead37c668066353.zip kdepimpi-8fbdf5d2b0ee1e1496cb856e0ead37c668066353.tar.gz kdepimpi-8fbdf5d2b0ee1e1496cb856e0ead37c668066353.tar.bz2 |
added comment for todo
-rw-r--r-- | qtcompat/qinputdialog.cpp | 2 |
1 files changed, 1 insertions, 1 deletions
diff --git a/qtcompat/qinputdialog.cpp b/qtcompat/qinputdialog.cpp index 64c581e..ce46118 100644 --- a/qtcompat/qinputdialog.cpp +++ b/qtcompat/qinputdialog.cpp | |||
@@ -183,257 +183,257 @@ QInputDialog::QInputDialog( const QString &label, QWidget* parent, const char* n | |||
183 | /*! | 183 | /*! |
184 | Returns the line edit, which is used in the LineEdit mode | 184 | Returns the line edit, which is used in the LineEdit mode |
185 | */ | 185 | */ |
186 | 186 | ||
187 | QLineEdit *QInputDialog::lineEdit() const | 187 | QLineEdit *QInputDialog::lineEdit() const |
188 | { | 188 | { |
189 | return d->lineEdit; | 189 | return d->lineEdit; |
190 | } | 190 | } |
191 | 191 | ||
192 | /*! | 192 | /*! |
193 | Returns the spinbox, which is used in the SpinBox mode | 193 | Returns the spinbox, which is used in the SpinBox mode |
194 | */ | 194 | */ |
195 | 195 | ||
196 | QSpinBox *QInputDialog::spinBox() const | 196 | QSpinBox *QInputDialog::spinBox() const |
197 | { | 197 | { |
198 | return d->spinBox; | 198 | return d->spinBox; |
199 | } | 199 | } |
200 | 200 | ||
201 | /*! | 201 | /*! |
202 | Returns the combobox, which is used in the ComboBox mode | 202 | Returns the combobox, which is used in the ComboBox mode |
203 | */ | 203 | */ |
204 | 204 | ||
205 | QComboBox *QInputDialog::comboBox() const | 205 | QComboBox *QInputDialog::comboBox() const |
206 | { | 206 | { |
207 | return d->comboBox; | 207 | return d->comboBox; |
208 | } | 208 | } |
209 | 209 | ||
210 | /*! | 210 | /*! |
211 | Returns the combobox, which is used in the EditableComboBox mode | 211 | Returns the combobox, which is used in the EditableComboBox mode |
212 | */ | 212 | */ |
213 | 213 | ||
214 | QComboBox *QInputDialog::editableComboBox() const | 214 | QComboBox *QInputDialog::editableComboBox() const |
215 | { | 215 | { |
216 | return d->editComboBox; | 216 | return d->editComboBox; |
217 | } | 217 | } |
218 | 218 | ||
219 | /*! | 219 | /*! |
220 | Sets the input type of the dialog to \a t. | 220 | Sets the input type of the dialog to \a t. |
221 | */ | 221 | */ |
222 | 222 | ||
223 | void QInputDialog::setType( Type t ) | 223 | void QInputDialog::setType( Type t ) |
224 | { | 224 | { |
225 | switch ( t ) { | 225 | switch ( t ) { |
226 | case LineEdit: | 226 | case LineEdit: |
227 | d->stack->raiseWidget( d->lineEdit ); | 227 | d->stack->raiseWidget( d->lineEdit ); |
228 | d->lineEdit->setFocus(); | 228 | d->lineEdit->setFocus(); |
229 | break; | 229 | break; |
230 | case SpinBox: | 230 | case SpinBox: |
231 | d->stack->raiseWidget( d->spinBox ); | 231 | d->stack->raiseWidget( d->spinBox ); |
232 | d->spinBox->setFocus(); | 232 | d->spinBox->setFocus(); |
233 | break; | 233 | break; |
234 | case ComboBox: | 234 | case ComboBox: |
235 | d->stack->raiseWidget( d->comboBox ); | 235 | d->stack->raiseWidget( d->comboBox ); |
236 | d->comboBox->setFocus(); | 236 | d->comboBox->setFocus(); |
237 | break; | 237 | break; |
238 | case EditableComboBox: | 238 | case EditableComboBox: |
239 | d->stack->raiseWidget( d->editComboBox ); | 239 | d->stack->raiseWidget( d->editComboBox ); |
240 | d->editComboBox->setFocus(); | 240 | d->editComboBox->setFocus(); |
241 | break; | 241 | break; |
242 | } | 242 | } |
243 | 243 | ||
244 | d->type = t; | 244 | d->type = t; |
245 | } | 245 | } |
246 | 246 | ||
247 | /*! | 247 | /*! |
248 | Returns the input type of the dialog. | 248 | Returns the input type of the dialog. |
249 | 249 | ||
250 | \sa setType() | 250 | \sa setType() |
251 | */ | 251 | */ |
252 | 252 | ||
253 | QInputDialog::Type QInputDialog::type() const | 253 | QInputDialog::Type QInputDialog::type() const |
254 | { | 254 | { |
255 | return d->type; | 255 | return d->type; |
256 | } | 256 | } |
257 | 257 | ||
258 | /*! | 258 | /*! |
259 | Destructor. | 259 | Destructor. |
260 | */ | 260 | */ |
261 | 261 | ||
262 | QInputDialog::~QInputDialog() | 262 | QInputDialog::~QInputDialog() |
263 | { | 263 | { |
264 | delete d; | 264 | delete d; |
265 | } | 265 | } |
266 | 266 | ||
267 | /*! | 267 | /*! |
268 | Static convenience function to get a textual input from the user. \a caption is the text | 268 | Static convenience function to get a textual input from the user. \a caption is the text |
269 | which is displayed in the title bar of the dialog. \a label is the text which | 269 | which is displayed in the title bar of the dialog. \a label is the text which |
270 | is shown to the user (it should mention to the user what he/she should input), \a text | 270 | is shown to the user (it should mention to the user what he/she should input), \a text |
271 | the default text which will be initially set to the line edit, \a ok a pointer to | 271 | the default text which will be initially set to the line edit, \a ok a pointer to |
272 | a bool which will be (if not 0!) set to TRUE if the user pressed ok or to FALSE if the | 272 | a bool which will be (if not 0!) set to TRUE if the user pressed ok or to FALSE if the |
273 | user pressed cancel, \a parent the parent widget of the dialog and \a name | 273 | user pressed cancel, \a parent the parent widget of the dialog and \a name |
274 | the name of it. The dialogs pops up modally! | 274 | the name of it. The dialogs pops up modally! |
275 | 275 | ||
276 | This method returns the text which has been entered in the line edit. | 276 | This method returns the text which has been entered in the line edit. |
277 | 277 | ||
278 | You will use this static method like this: | 278 | You will use this static method like this: |
279 | 279 | ||
280 | \code | 280 | \code |
281 | bool ok = FALSE; | 281 | bool ok = FALSE; |
282 | QString text = QInputDialog::getText( tr( "Please enter your name" ), QString::null, &ok, this ); | 282 | QString text = QInputDialog::getText( tr( "Please enter your name" ), QString::null, &ok, this ); |
283 | if ( ok && !text.isEmpty() ) | 283 | if ( ok && !text.isEmpty() ) |
284 | ;// user entered something and pressed ok | 284 | ;// user entered something and pressed ok |
285 | else | 285 | else |
286 | ;// user entered nothing or pressed cancel | 286 | ;// user entered nothing or pressed cancel |
287 | \endcode | 287 | \endcode |
288 | */ | 288 | */ |
289 | 289 | ||
290 | QString QInputDialog::getText( const QString &caption, const QString &label, const QString &text, | 290 | QString QInputDialog::getText( const QString &caption, const QString &label, const QString &text, |
291 | bool *ok, QWidget *parent, const char *name ) | 291 | bool *ok, QWidget *parent, const char *name ) |
292 | { | 292 | { |
293 | return getText( caption, label, QLineEdit::Normal, text, ok, parent, name ); | 293 | return getText( caption, label, QLineEdit::Normal, text, ok, parent, name ); |
294 | } | 294 | } |
295 | 295 | ||
296 | /*! | 296 | /*! |
297 | Like above, but accepts an a \a mode which the line edit will use to display text. | 297 | Like above, but accepts an a \a mode which the line edit will use to display text. |
298 | 298 | ||
299 | \sa getText() | 299 | \sa getText() |
300 | */ | 300 | */ |
301 | 301 | ||
302 | QString QInputDialog::getText( const QString &caption, const QString &label, QLineEdit::EchoMode mode, | 302 | QString QInputDialog::getText( const QString &caption, const QString &label, QLineEdit::EchoMode mode, |
303 | const QString &text, bool *ok, QWidget *parent, const char *name ) | 303 | const QString &text, bool *ok, QWidget *parent, const char *name ) |
304 | { | 304 | { |
305 | QInputDialog *dlg = new QInputDialog( label, parent, name, TRUE, LineEdit ); | 305 | QInputDialog *dlg = new QInputDialog( label, parent, name, TRUE, LineEdit ); |
306 | dlg->setCaption( caption ); | 306 | dlg->setCaption( caption ); |
307 | dlg->lineEdit()->setText( text ); | 307 | dlg->lineEdit()->setText( text ); |
308 | dlg->lineEdit()->setEchoMode( mode ); | 308 | dlg->lineEdit()->setEchoMode( mode ); |
309 | if ( !text.isEmpty() ) | 309 | if ( !text.isEmpty() ) |
310 | dlg->lineEdit()->selectAll(); | 310 | dlg->lineEdit()->selectAll(); |
311 | 311 | dlg->setMinimumWidth ( 230 ); | |
312 | bool ok_ = FALSE; | 312 | bool ok_ = FALSE; |
313 | QString result; | 313 | QString result; |
314 | ok_ = dlg->exec() == QDialog::Accepted; | 314 | ok_ = dlg->exec() == QDialog::Accepted; |
315 | if ( ok ) | 315 | if ( ok ) |
316 | *ok = ok_; | 316 | *ok = ok_; |
317 | if ( ok_ ) | 317 | if ( ok_ ) |
318 | result = dlg->lineEdit()->text(); | 318 | result = dlg->lineEdit()->text(); |
319 | 319 | ||
320 | delete dlg; | 320 | delete dlg; |
321 | return result; | 321 | return result; |
322 | } | 322 | } |
323 | 323 | ||
324 | /*! | 324 | /*! |
325 | Static convenience function to get an integral input from the user. \a caption is the text | 325 | Static convenience function to get an integral input from the user. \a caption is the text |
326 | which is displayed in the title bar of the dialog. \a label is the text which | 326 | which is displayed in the title bar of the dialog. \a label is the text which |
327 | is shown to the user (it should mention to the user what he/she should input), \a num | 327 | is shown to the user (it should mention to the user what he/she should input), \a num |
328 | the default number which will be initially set to the spinbox, \a from and \a to the | 328 | the default number which will be initially set to the spinbox, \a from and \a to the |
329 | range in which the entered number has to be, \a step the step in which the number can | 329 | range in which the entered number has to be, \a step the step in which the number can |
330 | be increased/decreased by the spinbox, \a ok a pointer to | 330 | be increased/decreased by the spinbox, \a ok a pointer to |
331 | a bool which will be (if not 0!) set to TRUE if the user pressed ok or to FALSE if the | 331 | a bool which will be (if not 0!) set to TRUE if the user pressed ok or to FALSE if the |
332 | user pressed cancel, \a parent the parent widget of the dialog and \a name | 332 | user pressed cancel, \a parent the parent widget of the dialog and \a name |
333 | the name of it. The dialogs pops up modally! | 333 | the name of it. The dialogs pops up modally! |
334 | 334 | ||
335 | This method returns the number which has been entered by the user. | 335 | This method returns the number which has been entered by the user. |
336 | 336 | ||
337 | You will use this static method like this: | 337 | You will use this static method like this: |
338 | 338 | ||
339 | \code | 339 | \code |
340 | bool ok = FALSE; | 340 | bool ok = FALSE; |
341 | int res = QInputDialog::getInteger( tr( "Please enter a number" ), 22, 0, 1000, 2, &ok, this ); | 341 | int res = QInputDialog::getInteger( tr( "Please enter a number" ), 22, 0, 1000, 2, &ok, this ); |
342 | if ( ok ) | 342 | if ( ok ) |
343 | ;// user entered something and pressed ok | 343 | ;// user entered something and pressed ok |
344 | else | 344 | else |
345 | ;// user pressed cancel | 345 | ;// user pressed cancel |
346 | \endcode | 346 | \endcode |
347 | */ | 347 | */ |
348 | 348 | ||
349 | int QInputDialog::getInteger( const QString &caption, const QString &label, int num, int from, int to, int step, | 349 | int QInputDialog::getInteger( const QString &caption, const QString &label, int num, int from, int to, int step, |
350 | bool *ok, QWidget *parent, const char *name ) | 350 | bool *ok, QWidget *parent, const char *name ) |
351 | { | 351 | { |
352 | QInputDialog *dlg = new QInputDialog( label, parent, name, TRUE, SpinBox ); | 352 | QInputDialog *dlg = new QInputDialog( label, parent, name, TRUE, SpinBox ); |
353 | dlg->setCaption( caption ); | 353 | dlg->setCaption( caption ); |
354 | dlg->spinBox()->setRange( from, to ); | 354 | dlg->spinBox()->setRange( from, to ); |
355 | dlg->spinBox()->setSteps( step, 0 ); | 355 | dlg->spinBox()->setSteps( step, 0 ); |
356 | dlg->spinBox()->setValue( num ); | 356 | dlg->spinBox()->setValue( num ); |
357 | 357 | ||
358 | bool ok_ = FALSE; | 358 | bool ok_ = FALSE; |
359 | int result; | 359 | int result; |
360 | ok_ = dlg->exec() == QDialog::Accepted; | 360 | ok_ = dlg->exec() == QDialog::Accepted; |
361 | if ( ok ) | 361 | if ( ok ) |
362 | *ok = ok_; | 362 | *ok = ok_; |
363 | result = dlg->spinBox()->value(); | 363 | result = dlg->spinBox()->value(); |
364 | 364 | ||
365 | delete dlg; | 365 | delete dlg; |
366 | return result; | 366 | return result; |
367 | } | 367 | } |
368 | 368 | ||
369 | /*! | 369 | /*! |
370 | Static convenience function to get a decimal input from the user. \a caption is the text | 370 | Static convenience function to get a decimal input from the user. \a caption is the text |
371 | which is displayed in the title bar of the dialog. \a label is the text which | 371 | which is displayed in the title bar of the dialog. \a label is the text which |
372 | is shown to the user (it should mention to the user what he/she should input), \a num | 372 | is shown to the user (it should mention to the user what he/she should input), \a num |
373 | the default decimal number which will be initially set to the line edit, \a from and \a to the | 373 | the default decimal number which will be initially set to the line edit, \a from and \a to the |
374 | range in which the entered number has to be, \a decimals the number of decimal which | 374 | range in which the entered number has to be, \a decimals the number of decimal which |
375 | the number may have, \a ok a pointer to | 375 | the number may have, \a ok a pointer to |
376 | a bool which will be (if not 0!) set to TRUE if the user pressed ok or to FALSE if the | 376 | a bool which will be (if not 0!) set to TRUE if the user pressed ok or to FALSE if the |
377 | user pressed cancel, \a parent the parent widget of the dialog and \a name | 377 | user pressed cancel, \a parent the parent widget of the dialog and \a name |
378 | the name of it. The dialogs pops up modally! | 378 | the name of it. The dialogs pops up modally! |
379 | 379 | ||
380 | This method returns the number which has been entered by the user. | 380 | This method returns the number which has been entered by the user. |
381 | 381 | ||
382 | You will use this static method like this: | 382 | You will use this static method like this: |
383 | 383 | ||
384 | \code | 384 | \code |
385 | bool ok = FALSE; | 385 | bool ok = FALSE; |
386 | double res = QInputDialog::getDouble( tr( "Please enter a decimal number" ), 33.7, 0, 1000, 2, &ok, this ); | 386 | double res = QInputDialog::getDouble( tr( "Please enter a decimal number" ), 33.7, 0, 1000, 2, &ok, this ); |
387 | if ( ok ) | 387 | if ( ok ) |
388 | ;// user entered something and pressed ok | 388 | ;// user entered something and pressed ok |
389 | else | 389 | else |
390 | ;// user pressed cancel | 390 | ;// user pressed cancel |
391 | \endcode | 391 | \endcode |
392 | */ | 392 | */ |
393 | 393 | ||
394 | double QInputDialog::getDouble( const QString &caption, const QString &label, double num, | 394 | double QInputDialog::getDouble( const QString &caption, const QString &label, double num, |
395 | double from, double to, int decimals, | 395 | double from, double to, int decimals, |
396 | bool *ok, QWidget *parent, const char *name ) | 396 | bool *ok, QWidget *parent, const char *name ) |
397 | { | 397 | { |
398 | QInputDialog *dlg = new QInputDialog( label, parent, name, TRUE, LineEdit ); | 398 | QInputDialog *dlg = new QInputDialog( label, parent, name, TRUE, LineEdit ); |
399 | dlg->setCaption( caption ); | 399 | dlg->setCaption( caption ); |
400 | dlg->lineEdit()->setValidator( new QDoubleValidator( from, to, decimals, dlg->lineEdit() ) ); | 400 | dlg->lineEdit()->setValidator( new QDoubleValidator( from, to, decimals, dlg->lineEdit() ) ); |
401 | dlg->lineEdit()->setText( QString::number( num, 'f', decimals ) ); | 401 | dlg->lineEdit()->setText( QString::number( num, 'f', decimals ) ); |
402 | dlg->lineEdit()->selectAll(); | 402 | dlg->lineEdit()->selectAll(); |
403 | 403 | ||
404 | bool accepted = ( dlg->exec() == QDialog::Accepted ); | 404 | bool accepted = ( dlg->exec() == QDialog::Accepted ); |
405 | if ( ok ) | 405 | if ( ok ) |
406 | *ok = accepted; | 406 | *ok = accepted; |
407 | 407 | ||
408 | double result = dlg->lineEdit()->text().toDouble(); | 408 | double result = dlg->lineEdit()->text().toDouble(); |
409 | 409 | ||
410 | delete dlg; | 410 | delete dlg; |
411 | return result; | 411 | return result; |
412 | } | 412 | } |
413 | 413 | ||
414 | /*! | 414 | /*! |
415 | Static convenience function to let the user select an item from a string list. \a caption is the text | 415 | Static convenience function to let the user select an item from a string list. \a caption is the text |
416 | which is displayed in the title bar of the dialog. \a label is the text which | 416 | which is displayed in the title bar of the dialog. \a label is the text which |
417 | is shown to the user (it should mention to the user what he/she should input), \a list the | 417 | is shown to the user (it should mention to the user what he/she should input), \a list the |
418 | string list which is inserted into the combobox, \a current the number of the item which should | 418 | string list which is inserted into the combobox, \a current the number of the item which should |
419 | be initially the current item, \a editable specifies if the combobox should be editable (if it is TRUE) | 419 | be initially the current item, \a editable specifies if the combobox should be editable (if it is TRUE) |
420 | or read-only (if \a editable is FALSE), \a ok a pointer to | 420 | or read-only (if \a editable is FALSE), \a ok a pointer to |
421 | a bool which will be (if not 0!) set to TRUE if the user pressed ok or to FALSE if the | 421 | a bool which will be (if not 0!) set to TRUE if the user pressed ok or to FALSE if the |
422 | user pressed cancel, \a parent the parent widget of the dialog and \a name | 422 | user pressed cancel, \a parent the parent widget of the dialog and \a name |
423 | the name of it. The dialogs pops up modally! | 423 | the name of it. The dialogs pops up modally! |
424 | 424 | ||
425 | This method returns the text of the current item, or if \a editable was TRUE, the current | 425 | This method returns the text of the current item, or if \a editable was TRUE, the current |
426 | text of the combobox. | 426 | text of the combobox. |
427 | 427 | ||
428 | You will use this static method like this: | 428 | You will use this static method like this: |
429 | 429 | ||
430 | \code | 430 | \code |
431 | QStringList lst; | 431 | QStringList lst; |
432 | lst << "First" << "Second" << "Third" << "Fourth" << "Fifth"; | 432 | lst << "First" << "Second" << "Third" << "Fourth" << "Fifth"; |
433 | bool ok = FALSE; | 433 | bool ok = FALSE; |
434 | QString res = QInputDialog::getItem( tr( "Please select an item" ), lst, 1, TRUE, &ok, this ); | 434 | QString res = QInputDialog::getItem( tr( "Please select an item" ), lst, 1, TRUE, &ok, this ); |
435 | if ( ok ) | 435 | if ( ok ) |
436 | ;// user selected an item and pressed ok | 436 | ;// user selected an item and pressed ok |
437 | else | 437 | else |
438 | ;// user pressed cancel | 438 | ;// user pressed cancel |
439 | \endcode | 439 | \endcode |