QInputDialog类

Qt 3.0.5

主页 | 所有的类 | 主要的类 | 注释的类 | 分组的类 | 函数

QInputDialog类参考

QInputDialog类提供了从用户那里得到一个单一值的简单方便的对话框。 详情请见……

#include <qinputdialog.h>

继承了QDialog

所有成员函数的列表。

静态公有成员

  • QString getText ( const QString & caption, const QString & label, QLineEdit::EchoMode mode = QLineEdit::Normal, const QString & text = QString::null, bool * ok = 0, QWidget * parent = 0, const char * name = 0 )
  • int getInteger ( const QString & caption, const QString & label, int num = 0, int from = -2147483647, int to = 2147483647, int step = 1, bool * ok = 0, QWidget * parent = 0, const char * name = 0 )
  • double getDouble ( const QString & caption, const QString & label, double num = 0, double from = -2147483647, double to = 2147483647, int decimals = 1, bool * ok = 0, QWidget * parent = 0, const char * name = 0 )
  • QString getItem ( const QString & caption, const QString & label, const QStringList & list, int current = 0, bool editable = TRUE, bool * ok = 0, QWidget * parent = 0, const char * name = 0 )

详细描述

QInputDialog类提供了从用户那里得到一个单一值的简单方便的对话框。

输入值可以是字符串、数字或者列表中的一项。必须设置标签来告诉用户应该输入什么。

这里有四个方便的函数被提供:getText()、getInteger()、getDouble()和getItem()。所有这些函数都可以按相似的方式使用,例如:

  bool ok = FALSE;
  QString text = QInputDialog::getText(
                    tr( "Application name" ),
                    tr( "Please enter your name" ),
                    QLineEdit::Normal, QString::null, &ok, this );
  if ( ok && !text.isEmpty() )
      ;// 用户输入一些东西并且按下OK
  else
      ;// 用户不输入任何东西或者按下Cancel
  

Input Dialogs

也可以参考对话框类


成员函数文档

double QInputDialog::getDouble ( const QString & caption, const QString & label, double num = 0, double from = -2147483647, double to = 2147483647, int decimals = 1, bool * ok = 0, QWidget * parent = 0, const char * name = 0 ) [静态]

从用户那里得到浮点数的静态方便函数。caption是这个对话框在标题栏显示的文本。label是显示给用户的文本(它应该告诉用户应该输入什么)。num是这个行编辑中所要设置的默认的浮点数值。fromto是最小值和最大值,用户应该在这个范围内进行选择并且decimals小数点后面小数的最大位数。

对话框的父对象为parent、名称为name。如果ok参数为非零,则如果用户点击OK,*ok被设置为真,并且如果用户点击Cancel,就被设置为假。对话框将是模式的。

这个函数返回用户输入的浮点数。

像这样使用这个静态函数:

  bool ok = FALSE;
  double res = QInputDialog::getDouble(
                tr( "Application name" ),
                tr( "Please enter a decimal number" ),
                33.7, 0, 1000, 2, &ok, this );
  if ( ok )
      ;// 用户输入一些东西并且按下OK
  else
      ;// 用户按下Cancel
  

int QInputDialog::getInteger ( const QString & caption, const QString & label, int num = 0, int from = -2147483647, int to = 2147483647, int step = 1, bool * ok = 0, QWidget * parent = 0, const char * name = 0 ) [静态]

从用户那里得到整数的静态方便函数。caption是这个对话框在标题栏显示的文本。label是显示给用户的文本(它应该告诉用户应该输入什么)。num是微调框中所要设置的默认整数。fromto是最小值和最大值,用户应该在这个范围内进行选择并且step是用户通过点击上下箭头增加或者减少的数值。

对话框的父对象为parent、名称为name。如果ok参数为非零,则如果用户点击OK,*ok被设置为真,并且如果用户点击Cancel,就被设置为假。对话框将是模式的。

这个函数返回用户输入的整数。

像这样使用这个静态函数:

  bool ok = FALSE;
  int res = QInputDialog::getInteger(
                tr( "Application name" ),
                tr( "Please enter a number" ), 22, 0, 1000, 2, &ok, this );
  if ( ok )
      ;// 用户输入一些东西并且按下OK
  else
      ;// 用户按下Cancel
  

QString QInputDialog::getItem ( const QString & caption, const QString & label, const QStringList & list, int current = 0, bool editable = TRUE, bool * ok = 0, QWidget * parent = 0, const char * name = 0 ) [静态]

让用户从一个字符串列表中选择一项的静态方便函数。caption是这个对话框在标题栏显示的文本。label是显示给用户的文本(它应该告诉用户应该输入什么)。list是插入到组合框中的字符串列表,并且current是指哪一项为当前项。如果editable为真,则用户可以输入自己的文本,如果editable为假,则用户只能选择已有的项中的一项。

对话框的父对象为parent、名称为name。如果ok参数为非零,则如果用户点击OK,*ok被设置为真,并且如果用户点击Cancel,就被设置为假。对话框将是模式的。

这个函数返回当前项的文本,或者如果editable为真,就是组合框的当前文本。

像这样使用这个静态函数:

  QStringList lst;
  lst << "First" << "Second" << "Third" << "Fourth" << "Fifth";
  bool ok = FALSE;
  QString res = QInputDialog::getItem(
                    tr( "Application name" ),
                    tr( "Please select an item" ), lst, 1, TRUE, &ok, this );
  if ( ok )
      ;// 用户选择一项并且按下OK
  else
      ;// 用户按下Cancel
  

QString QInputDialog::getText ( const QString & caption, const QString & label, QLineEdit::EchoMode mode = QLineEdit::Normal, const QString & text = QString::null, bool * ok = 0, QWidget * parent = 0, const char * name = 0 ) [静态]

从用户那里得到一个字符串的静态方便函数。caption是这个对话框在标题栏显示的文本。label是显示给用户的文本(它应该告诉用户应该输入什么)。text是放置在行编辑中的默认文本。mode是行编辑的回显模式。

对话框的父对象为parent、名称为name。如果ok参数为非零,则如果用户点击OK,*ok被设置为真,并且如果用户点击Cancel,就被设置为假。对话框将是模式的。

这个函数返回用户在行编辑中输入的文本。如果没有输入,就返回空字符串。

像这样使用这个静态函数:

  bool ok = FALSE;
  QString text = QInputDialog::getText(
                    tr( "Application name" ),
                    tr( "Please enter your name" ),
                    QLineEdit::Normal, QString::null, &ok, this );
  if ( ok && !text.isEmpty() )
      ;// 用户输入一些东西并且按下OK
  else
      ;// 用户不输入任何东西或者按下Cancel
  

实例:network/ftpclient/ftpmainwindow.cpp


这个文件是Qt工具包一部分。 版权所有 © 1995-2002 Trolltech。保留所有权利。


Copyright © 2002 Trolltech Trademarks 译者:Cavendish
Qt 3.0.5版