From ea318d1431c89e647598c510c4245c6571aa5f46 Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Thu, 26 Jan 2012 23:32:43 -0600 Subject: Update to latest tqt3 automated conversion --- doc/html/ntqinputdialog.html | 196 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 196 insertions(+) create mode 100644 doc/html/ntqinputdialog.html (limited to 'doc/html/ntqinputdialog.html') diff --git a/doc/html/ntqinputdialog.html b/doc/html/ntqinputdialog.html new file mode 100644 index 000000000..6ba9d306d --- /dev/null +++ b/doc/html/ntqinputdialog.html @@ -0,0 +1,196 @@ + + + + + +TQInputDialog Class + + + + + + + +
+ +Home + | +All Classes + | +Main Classes + | +Annotated + | +Grouped Classes + | +Functions +

TQInputDialog Class Reference

+ +

The TQInputDialog class provides a simple convenience dialog to get a single value from the user. +More... +

#include <ntqinputdialog.h> +

Inherits TQDialog. +

List of all member functions. +

Static Public Members

+ +

Detailed Description

+ + +The TQInputDialog class provides a simple convenience dialog to get a single value from the user. + + +

The input value can be a string, a number or an item from a list. A +label must be set to tell the user what they should enter. +

Four static convenience functions are provided: +getText(), getInteger(), getDouble() and getItem(). All the +functions can be used in a similar way, for example: +

+    bool ok;
+    TQString text = TQInputDialog::getText(
+            "MyApp 3000", "Enter your name:", TQLineEdit::Normal,
+            TQString::null, &ok, this );
+    if ( ok && !text.isEmpty() ) {
+        // user entered something and pressed OK
+    } else {
+        // user entered nothing or pressed Cancel
+    }
+
+ +

Input Dialogs

See also Dialog Classes. + +

Member Function Documentation

+

double TQInputDialog::getDouble ( const TQString & caption, const TQString & label, double value = 0, double minValue = -2147483647, double maxValue = 2147483647, int decimals = 1, bool * ok = 0, TQWidget * parent = 0, const char * name = 0 ) [static] +

+Static convenience function to get a floating point number from +the user. caption is the text which is displayed in the title +bar of the dialog. label is the text which is shown to the user +(it should say what should be entered). value is the default +floating point number that the line edit will be set to. minValue and maxValue are the minimum and maximum values the +user may choose, and decimals is the maximum number of decimal +places the number may have. +

If ok is not-null *ok will be set to TRUE if the user +pressed OK and to FALSE if the user pressed Cancel. The dialog's +parent is parent; the dialog is called name. The dialog will +be modal. +

This function returns the floating point number which has been +entered by the user. +

Use this static function like this: +

+    bool ok;
+    double res = TQInputDialog::getDouble(
+            "MyApp 3000", "Enter a decimal number:", 33.7, 0,
+            1000, 2, &ok, this );
+    if ( ok ) {
+        // user entered something and pressed OK
+    } else {
+        // user pressed Cancel
+    }
+
+ + +

int TQInputDialog::getInteger ( const TQString & caption, const TQString & label, int value = 0, int minValue = -2147483647, int maxValue = 2147483647, int step = 1, bool * ok = 0, TQWidget * parent = 0, const char * name = 0 ) [static] +

+Static convenience function to get an integer input from the +user. caption is the text which is displayed in the title bar +of the dialog. label is the text which is shown to the user +(it should say what should be entered). value is the default +integer which the spinbox will be set to. minValue and maxValue are the minimum and maximum values the user may choose, +and step is the amount by which the values change as the user +presses the arrow buttons to increment or decrement the value. +

If ok is not-null *ok will be set to TRUE if the user +pressed OK and to FALSE if the user pressed Cancel. The dialog's +parent is parent; the dialog is called name. The dialog will +be modal. +

This function returns the integer which has been entered by the user. +

Use this static function like this: +

+    bool ok;
+    int res = TQInputDialog::getInteger(
+            "MyApp 3000", "Enter a number:", 22, 0, 1000, 2,
+            &ok, this );
+    if ( ok ) {
+        // user entered something and pressed OK
+    } else {
+        // user pressed Cancel
+    }
+
+ + +

TQString TQInputDialog::getItem ( const TQString & caption, const TQString & label, const TQStringList & list, int current = 0, bool editable = TRUE, bool * ok = 0, TQWidget * parent = 0, const char * name = 0 ) [static] +

+Static convenience function to let the user select an item from a +string list. caption is the text which is displayed in the title +bar of the dialog. label is the text which is shown to the user (it +should say what should be entered). list is the +string list which is inserted into the combobox, and current is the number +of the item which should be the current item. If editable is TRUE +the user can enter their own text; if editable is FALSE the user +may only select one of the existing items. +

If ok is not-null *ok will be set to TRUE if the user +pressed OK and to FALSE if the user pressed Cancel. The dialog's +parent is parent; the dialog is called name. The dialog will +be modal. +

This function returns the text of the current item, or if editable is TRUE, the current text of the combobox. +

Use this static function like this: +

+    TQStringList lst;
+    lst << "First" << "Second" << "Third" << "Fourth" << "Fifth";
+    bool ok;
+    TQString res = TQInputDialog::getItem(
+            "MyApp 3000", "Select an item:", lst, 1, TRUE, &ok,
+            this );
+    if ( ok ) {
+        // user selected an item and pressed OK
+    } else {
+        // user pressed Cancel
+    }
+
+ + +

TQString TQInputDialog::getText ( const TQString & caption, const TQString & label, TQLineEdit::EchoMode mode = TQLineEdit::Normal, const TQString & text = TQString::null, bool * ok = 0, TQWidget * parent = 0, const char * name = 0 ) [static] +

+Static convenience function to get a string from the user. caption is the text which is displayed in the title bar of the +dialog. label is the text which is shown to the user (it should +say what should be entered). text is the default text which is +placed in the line edit. The mode is the echo mode the line edit +will use. If ok is not-null *ok will be set to TRUE if the +user pressed OK and to FALSE if the user pressed Cancel. The +dialog's parent is parent; the dialog is called name. The +dialog will be modal. +

This function returns the text which has been entered in the line +edit. It will not return an empty string. +

Use this static function like this: +

+    bool ok;
+    TQString text = TQInputDialog::getText(
+            "MyApp 3000", "Enter your name:", TQLineEdit::Normal,
+            TQString::null, &ok, this );
+    if ( ok && !text.isEmpty() ) {
+        // user entered something and pressed OK
+    } else {
+        // user entered nothing or pressed Cancel
+    }
+
+ + + +

+This file is part of the TQt toolkit. +Copyright © 1995-2007 +Trolltech. All Rights Reserved.

+ +
Copyright © 2007 +TrolltechTrademarks +
TQt 3.3.8
+
+ -- cgit v1.2.1