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/ntqvalidator.html | 153 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 153 insertions(+) create mode 100644 doc/html/ntqvalidator.html (limited to 'doc/html/ntqvalidator.html') diff --git a/doc/html/ntqvalidator.html b/doc/html/ntqvalidator.html new file mode 100644 index 000000000..2e61dbd16 --- /dev/null +++ b/doc/html/ntqvalidator.html @@ -0,0 +1,153 @@ + + + + + +TQValidator Class + + + + + + + +

TQValidator Class Reference

+ +

The TQValidator class provides validation of input text. +More... +

#include <ntqvalidator.h> +

Inherits TQObject. +

Inherited by TQIntValidator, TQDoubleValidator, and TQRegExpValidator. +

List of all member functions. +

Public Members

TQValidator ( TQObject * parent, const char * name = 0 )
~TQValidator ()
enum State { Invalid, Intermediate, Valid = Intermediate, Acceptable }
virtual State validate ( TQString & input, int & pos ) const = 0
virtual void fixup ( TQString & input ) const

Detailed Description

+ + +The TQValidator class provides validation of input text. +

+ +

The class itself is abstract. Two subclasses, TQIntValidator and +TQDoubleValidator, provide basic numeric-range checking, and TQRegExpValidator provides general checking using a custom regular expression. +

If the built-in validators aren't sufficient, you can subclass +TQValidator. The class has two virtual functions: validate() and +fixup(). +

validate() must be implemented by every subclass. It returns +Invalid, Intermediate or Acceptable depending on whether +its argument is valid (for the subclass's definition of valid). +

These three states require some explanation. An Invalid string +is clearly invalid. Intermediate is less obvious: the +concept of validity is slippery when the string is incomplete +(still being edited). TQValidator defines Intermediate as the +property of a string that is neither clearly invalid nor +acceptable as a final result. Acceptable means that the string +is acceptable as a final result. One might say that any string +that is a plausible intermediate state during entry of an Acceptable string is Intermediate. +

Here are some examples: +

For a line edit that accepts integers from 0 to 999 inclusive, +42 and 123 are Acceptable, the empty string and 1114 are Intermediate and asdf is Invalid. +
For an editable combobox that accepts URLs, any well-formed URL +is Acceptable, "http://www.trolltech.com/," is Intermediate +(it might be a cut and paste operation that accidentally took in a +comma at the end), the empty string is Intermediate (the user +might select and delete all of the text in preparation for entering +a new URL), and "http:///./" is Invalid. +
For a spin box that accepts lengths, "11cm" and "1in" are Acceptable, "11" and the empty string are Intermediate and +"http://www.trolltech.com" and "hour" are Invalid. +

fixup() is provided for validators that can repair some user +errors. The default implementation does nothing. TQLineEdit, for +example, will call fixup() if the user presses Enter (or Return) +and the content is not currently valid. This allows the fixup() +function the opportunity of performing some magic to make an Invalid string Acceptable. +

TQValidator is typically used with TQLineEdit, TQSpinBox and +TQComboBox. +

Member Type Documentation

TQValidator::State

+ +

This enum type defines the states in which a validated string can +exist. +

TQValidator::Invalid - the string is clearly invalid. +
TQValidator::Intermediate - the string is a plausible intermediate value +during editing. +
TQValidator::Acceptable - the string is acceptable as a final result, +i.e. it is valid. +

Member Function Documentation

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

+Sets up the validator. The parent and name parameters are +passed on to the TQObject constructor. + +

TQValidator::~TQValidator () +

+Destroys the validator, freeing any storage and other resources +used. + +

void TQValidator::fixup ( TQString & input ) const `[virtual]` +

+ +

This function attempts to change input to be valid according to +this validator's rules. It need not result in a valid string: +callers of this function must re-test afterwards; the default does +nothing. +

Reimplementations of this function can change input even if +they do not produce a valid string. For example, an ISBN validator +might want to delete every character except digits and "-", even +if the result is still not a valid ISBN; a surname validator might +want to remove whitespace from the start and end of the string, +even if the resulting string is not in the list of accepted +surnames. + +

State TQValidator::validate ( TQString & input, int & pos ) const `[pure virtual]` +

+ +

This pure virtual function returns Invalid if input is +invalid according to this validator's rules, Intermediate if it +is likely that a little more editing will make the input +acceptable (e.g. the user types '4' into a widget which accepts +integers between 10 and 99) and Acceptable if the input is +valid. +

The function can change input and pos (the cursor position) +if it wants to. + +

Reimplemented in TQIntValidator, TQDoubleValidator, and TQRegExpValidator. + +

+ +

Trademarks +

TQt 3.3.8

+ -- cgit v1.2.1