From bd0f3345a938b35ce6a12f6150373b0955b8dd12 Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Sun, 10 Jul 2011 15:24:15 -0500 Subject: Add Qt3 development HEAD version --- doc/html/qintvalidator.html | 176 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 176 insertions(+) create mode 100644 doc/html/qintvalidator.html (limited to 'doc/html/qintvalidator.html') diff --git a/doc/html/qintvalidator.html b/doc/html/qintvalidator.html new file mode 100644 index 0000000..9b3392f --- /dev/null +++ b/doc/html/qintvalidator.html @@ -0,0 +1,176 @@ + + + + + +QIntValidator Class + + + + + + + +

QIntValidator Class Reference

+ +

The QIntValidator class provides a validator which ensures +that a string contains a valid integer within a specified range. +More... +

#include <qvalidator.h> +

Inherits QValidator. +

List of all member functions. +

Public Members

QIntValidator ( QObject * parent, const char * name = 0 )
QIntValidator ( int minimum, int maximum, QObject * parent, const char * name = 0 )
~QIntValidator ()
virtual QValidator::State validate ( QString & input, int & ) const
void setBottom ( int )
void setTop ( int )
virtual void setRange ( int bottom, int top )
int bottom () const
int top () const

Properties

int bottom - the validator's lowest acceptable value
int top - the validator's highest acceptable value

Detailed Description

+ + +The QIntValidator class provides a validator which ensures +that a string contains a valid integer within a specified range. +

Example of use: +

+    QValidator* validator = new QIntValidator( 100, 999, this );
+    QLineEdit* edit = new QLineEdit( this );
+
+    // the edit lineedit will only accept integers between 100 and 999
+    edit->setValidator( validator );
+

+ +

Below we present some examples of validators. In practice they would +normally be associated with a widget as in the example above. +

+    QString str;
+    int pos = 0;
+    QIntValidator v( 100, 999, this );
+
+    str = "1";
+    v.validate( str, pos );     // returns Intermediate
+    str = "12";
+    v.validate( str, pos );     // returns Intermediate
+
+    str = "123";
+    v.validate( str, pos );     // returns Acceptable
+    str = "678";
+    v.validate( str, pos );     // returns Acceptable
+
+    str = "1234";
+    v.validate( str, pos );     // returns Invalid
+    str = "-123";
+    v.validate( str, pos );     // returns Invalid
+    str = "abc";
+    v.validate( str, pos );     // returns Invalid
+    str = "12cm";
+    v.validate( str, pos );     // returns Invalid
+

+ +

The minimum and maximum values are set in one call with setRange() +or individually with setBottom() and setTop(). +

Member Function Documentation

QIntValidator::QIntValidator ( QObject * parent, const char * name = 0 ) +

+Constructs a validator called name with parent parent, that +accepts all integers. + +

QIntValidator::QIntValidator ( int minimum, int maximum, QObject * parent, const char * name = 0 ) +

+Constructs a validator called name with parent parent, that +accepts integers from minimum to maximum inclusive. + +

QIntValidator::~QIntValidator () +

+Destroys the validator, freeing any resources allocated. + +

int QIntValidator::bottom () const +

Returns the validator's lowest acceptable value. +See the "bottom" property for details. +

void QIntValidator::setBottom ( int ) +

Sets the validator's lowest acceptable value. +See the "bottom" property for details. +

void QIntValidator::setRange ( int bottom, int top ) `[virtual]` +

+Sets the range of the validator to only accept integers between bottom and top inclusive. + +

void QIntValidator::setTop ( int ) +

Sets the validator's highest acceptable value. +See the "top" property for details. +

int QIntValidator::top () const +

Returns the validator's highest acceptable value. +See the "top" property for details. +

QValidator::State QIntValidator::validate ( QString & input, int & ) const `[virtual]` +

+Returns Acceptable if the input is an integer within the +valid range, Intermediate if the input is an integer outside +the valid range and Invalid if the input is not an integer. +

Note: If the valid range consists of just positive integers (e.g. 32 - 100) +and input is a negative integer then Invalid is returned. +

+    int pos = 0;
+    s = "abc";
+    v.validate( s, pos ); // returns Invalid
+
+    s = "5";
+    v.validate( s, pos ); // returns Intermediate
+
+    s = "50";
+    v.validate( s, pos ); // returns Valid
+

+ + +

Reimplemented from QValidator. +

Property Documentation

int bottom

This property holds the validator's lowest acceptable value. +

Set this property's value with setBottom() and get this property's value with bottom(). +

int top

This property holds the validator's highest acceptable value. +

Set this property's value with setTop() and get this property's value with top(). +