From 39f8a475b4ec5c87a11a7e9300a30ef1c5b4a7e1 Mon Sep 17 00:00:00 2001 From: Michele Calgaro Date: Sat, 31 Aug 2024 19:56:49 +0900 Subject: Rename remaining ntq[i-l]* related files to equivalent tq* Signed-off-by: Michele Calgaro --- doc/html/tqintvalidator.html | 176 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 176 insertions(+) create mode 100644 doc/html/tqintvalidator.html (limited to 'doc/html/tqintvalidator.html') diff --git a/doc/html/tqintvalidator.html b/doc/html/tqintvalidator.html new file mode 100644 index 000000000..f2f324a53 --- /dev/null +++ b/doc/html/tqintvalidator.html @@ -0,0 +1,176 @@ + + + + + +TQIntValidator Class + + + + + + + +

TQIntValidator Class Reference

+ +

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

#include <tqvalidator.h> +

Inherits TQValidator. +

List of all member functions. +

Public Members

TQIntValidator ( TQObject * parent, const char * name = 0 )
TQIntValidator ( int minimum, int maximum, TQObject * parent, const char * name = 0 )
~TQIntValidator ()
virtual TQValidator::State validate ( TQString & 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 TQIntValidator class provides a validator which ensures +that a string contains a valid integer within a specified range. +

Example of use: +

+    TQValidator* validator = new TQIntValidator( 100, 999, this );
+    TQLineEdit* edit = new TQLineEdit( 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. +

+    TQString str;
+    int pos = 0;
+    TQIntValidator 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

TQIntValidator::TQIntValidator ( TQObject * parent, const char * name = 0 ) +

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

TQIntValidator::TQIntValidator ( int minimum, int maximum, TQObject * parent, const char * name = 0 ) +

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

TQIntValidator::~TQIntValidator () +

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

int TQIntValidator::bottom () const +

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

void TQIntValidator::setBottom ( int ) +

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

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

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

void TQIntValidator::setTop ( int ) +

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

int TQIntValidator::top () const +

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

TQValidator::State TQIntValidator::validate ( TQString & 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 TQValidator. +

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(). +