主页 | 所有的类 | 主要的类 | 注释的类 | 分组的类 | 函数 |
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
也可以参考对话框类。
成员函数文档
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是这个行编辑中所要设置的默认的浮点数值。from和to是最小值和最大值,用户应该在这个范围内进行选择并且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是微调框中所要设置的默认整数。from和to是最小值和最大值,用户应该在这个范围内进行选择并且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版
|