tests/validators/valnum.cpp

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        tests/validators/valnum.cpp
   3 // Purpose:     Unit tests for numeric validators.
   4 // Author:      Vadim Zeitlin
   5 // Created:     2011-01-18
   6 // RCS-ID:      $Id$
   7 // Copyright:   (c) 2011 Vadim Zeitlin <vadim@wxwidgets.org>
   8 ///////////////////////////////////////////////////////////////////////////////
   9
  10 #include "testprec.h"
  11
  12 #ifdef __BORLANDC__
  13     #pragma hdrstop
  14 #endif
  15
  16 #ifndef WX_PRECOMP
  17     #include "wx/app.h"
  18     #include "wx/intl.h"
  19     #include "wx/textctrl.h"
  20     #include "wx/validate.h"
  21 #endif // WX_PRECOMP
  22
  23 #include "wx/valnum.h"
  24
  25 #include "asserthelper.h"
  26 #include "testableframe.h"
  27 #include "wx/uiaction.h"
  28
  29 class NumValidatorTestCase : public CppUnit::TestCase
  30 {
  31 public:
  32     NumValidatorTestCase() { }
  33
  34     void setUp();
  35     void tearDown();
  36
  37 private:
  38     CPPUNIT_TEST_SUITE( NumValidatorTestCase );
  39         CPPUNIT_TEST( TransferInt );
  40         CPPUNIT_TEST( TransferUnsigned );
  41         CPPUNIT_TEST( TransferFloat );
  42         CPPUNIT_TEST( ZeroAsBlank );
  43         CPPUNIT_TEST( NoTrailingZeroes );
  44         WXUISIM_TEST( Interactive );
  45     CPPUNIT_TEST_SUITE_END();
  46
  47     void TransferInt();
  48     void TransferUnsigned();
  49     void TransferFloat();
  50     void ZeroAsBlank();
  51     void NoTrailingZeroes();
  52 #if wxUSE_UIACTIONSIMULATOR
  53     void Interactive();
  54 #endif // wxUSE_UIACTIONSIMULATOR
  55
  56     wxTextCtrl *m_text;
  57
  58     wxDECLARE_NO_COPY_CLASS(NumValidatorTestCase);
  59 };
  60
  61 // register in the unnamed registry so that these tests are run by default
  62 CPPUNIT_TEST_SUITE_REGISTRATION( NumValidatorTestCase );
  63
  64 // also include in it's own registry so that these tests can be run alone
  65 CPPUNIT_TEST_SUITE_NAMED_REGISTRATION( NumValidatorTestCase, "NumValidatorTestCase" );
  66
  67 void NumValidatorTestCase::setUp()
  68 {
  69     m_text = new wxTextCtrl(wxTheApp->GetTopWindow(), wxID_ANY);
  70 }
  71
  72 void NumValidatorTestCase::tearDown()
  73 {
  74     wxTheApp->GetTopWindow()->DestroyChildren();
  75 }
  76
  77 void NumValidatorTestCase::TransferInt()
  78 {
  79     int value = 0;
  80     wxIntegerValidator<int> valInt(&value);
  81     valInt.SetWindow(m_text);
  82
  83     CPPUNIT_ASSERT( valInt.TransferToWindow() );
  84     CPPUNIT_ASSERT_EQUAL( "0", m_text->GetValue() );
  85
  86     value = 17;
  87     CPPUNIT_ASSERT( valInt.TransferToWindow() );
  88     CPPUNIT_ASSERT_EQUAL( "17", m_text->GetValue() );
  89
  90
  91     m_text->ChangeValue("foobar");
  92     CPPUNIT_ASSERT( !valInt.TransferFromWindow() );
  93
  94     m_text->ChangeValue("-234");
  95     CPPUNIT_ASSERT( valInt.TransferFromWindow() );
  96     CPPUNIT_ASSERT_EQUAL( -234, value );
  97
  98     m_text->ChangeValue("9223372036854775808"); // == LLONG_MAX + 1
  99     CPPUNIT_ASSERT( !valInt.TransferFromWindow() );
 100
 101     m_text->Clear();
 102     CPPUNIT_ASSERT( !valInt.TransferFromWindow() );
 103 }
 104
 105 void NumValidatorTestCase::TransferUnsigned()
 106 {
 107     unsigned value = 0;
 108     wxIntegerValidator<unsigned> valUnsigned(&value);
 109     valUnsigned.SetWindow(m_text);
 110
 111     CPPUNIT_ASSERT( valUnsigned.TransferToWindow() );
 112     CPPUNIT_ASSERT_EQUAL( "0", m_text->GetValue() );
 113
 114     value = 17;
 115     CPPUNIT_ASSERT( valUnsigned.TransferToWindow() );
 116     CPPUNIT_ASSERT_EQUAL( "17", m_text->GetValue() );
 117
 118
 119     m_text->ChangeValue("foobar");
 120     CPPUNIT_ASSERT( !valUnsigned.TransferFromWindow() );
 121
 122     m_text->ChangeValue("-234");
 123     CPPUNIT_ASSERT( !valUnsigned.TransferFromWindow() );
 124
 125     m_text->ChangeValue("234");
 126     CPPUNIT_ASSERT( valUnsigned.TransferFromWindow() );
 127     CPPUNIT_ASSERT_EQUAL( 234, value );
 128
 129     m_text->ChangeValue("18446744073709551616"); // == ULLONG_MAX + 1
 130     CPPUNIT_ASSERT( !valUnsigned.TransferFromWindow() );
 131
 132     m_text->Clear();
 133     CPPUNIT_ASSERT( !valUnsigned.TransferFromWindow() );
 134 }
 135
 136 void NumValidatorTestCase::TransferFloat()
 137 {
 138     // We need a locale with point as decimal separator.
 139     wxLocale loc(wxLANGUAGE_ENGLISH_UK, wxLOCALE_DONT_LOAD_DEFAULT);
 140
 141     float value = 0;
 142     wxFloatingPointValidator<float> valFloat(3, &value);
 143     valFloat.SetWindow(m_text);
 144
 145     CPPUNIT_ASSERT( valFloat.TransferToWindow() );
 146     CPPUNIT_ASSERT_EQUAL( "0.000", m_text->GetValue() );
 147
 148     value = 1.234f;
 149     CPPUNIT_ASSERT( valFloat.TransferToWindow() );
 150     CPPUNIT_ASSERT_EQUAL( "1.234", m_text->GetValue() );
 151
 152     value = 1.2345678f;
 153     CPPUNIT_ASSERT( valFloat.TransferToWindow() );
 154     CPPUNIT_ASSERT_EQUAL( "1.235", m_text->GetValue() );
 155
 156
 157     m_text->ChangeValue("foobar");
 158     CPPUNIT_ASSERT( !valFloat.TransferFromWindow() );
 159
 160     m_text->ChangeValue("-234.567");
 161     CPPUNIT_ASSERT( valFloat.TransferFromWindow() );
 162     CPPUNIT_ASSERT_EQUAL( -234.567f, value );
 163
 164     m_text->Clear();
 165     CPPUNIT_ASSERT( !valFloat.TransferFromWindow() );
 166 }
 167
 168 void NumValidatorTestCase::ZeroAsBlank()
 169 {
 170     long value = 0;
 171     m_text->SetValidator(
 172         wxMakeIntegerValidator(&value, wxNUM_VAL_ZERO_AS_BLANK));
 173
 174     wxValidator * const val = m_text->GetValidator();
 175
 176     CPPUNIT_ASSERT( val->TransferToWindow() );
 177     CPPUNIT_ASSERT_EQUAL( "", m_text->GetValue() );
 178
 179     value++;
 180     CPPUNIT_ASSERT( val->TransferFromWindow() );
 181     CPPUNIT_ASSERT_EQUAL( 0, value );
 182 }
 183
 184 void NumValidatorTestCase::NoTrailingZeroes()
 185 {
 186     // We need a locale with point as decimal separator.
 187     wxLocale loc(wxLANGUAGE_ENGLISH_UK, wxLOCALE_DONT_LOAD_DEFAULT);
 188
 189     double value = 1.2;
 190     m_text->SetValidator(
 191         wxMakeFloatingPointValidator(3, &value, wxNUM_VAL_NO_TRAILING_ZEROES));
 192
 193     wxValidator * const val = m_text->GetValidator();
 194
 195     CPPUNIT_ASSERT( val->TransferToWindow() );
 196     CPPUNIT_ASSERT_EQUAL( "1.2", m_text->GetValue() );
 197
 198     value = 1.234;
 199     CPPUNIT_ASSERT( val->TransferToWindow() );
 200     CPPUNIT_ASSERT_EQUAL( "1.234", m_text->GetValue() );
 201 }
 202
 203 #if wxUSE_UIACTIONSIMULATOR
 204
 205 void NumValidatorTestCase::Interactive()
 206 {
 207     // FIXME: This test fails on MSW buildbot slaves although works fine on
 208     //        development machine, no idea why. It seems to be a problem with
 209     //        wxUIActionSimulator rather the wxListCtrl control itself however.
 210     if ( wxGetUserId().Lower().Matches("buildslave*") )
 211         return;
 212
 213     // Set a locale using comma as thousands separator character.
 214     wxLocale loc(wxLANGUAGE_ENGLISH_UK, wxLOCALE_DONT_LOAD_DEFAULT);
 215
 216     m_text->SetValidator(
 217         wxIntegerValidator<unsigned>(NULL, wxNUM_VAL_THOUSANDS_SEPARATOR));
 218
 219     // Create a sibling text control to be able to switch focus and thus
 220     // trigger the control validation/normalization.
 221     wxTextCtrl * const text2 = new wxTextCtrl(m_text->GetParent(), wxID_ANY);
 222     text2->Move(10, 80); // Just to see it better while debugging...
 223     wxFloatingPointValidator<float> valFloat(3);
 224     valFloat.SetRange(-10., 10.);
 225     text2->SetValidator(valFloat);
 226
 227     wxUIActionSimulator sim;
 228
 229     // Entering '-' in a control with positive range is not allowed.
 230     m_text->SetFocus();
 231     sim.Char('-');
 232     wxYield();
 233     CPPUNIT_ASSERT_EQUAL( "", m_text->GetValue() );
 234
 235     // Neither is entering '.' or any non-digit character.
 236     sim.Text(".a+/");
 237     wxYield();
 238     CPPUNIT_ASSERT_EQUAL( "", m_text->GetValue() );
 239
 240     // Entering digits should work though and after leaving the control the
 241     // contents should be normalized.
 242     sim.Text("1234567");
 243     wxYield();
 244     text2->SetFocus();
 245     wxYield();
 246     if ( loc.IsOk() )
 247         CPPUNIT_ASSERT_EQUAL( "1,234,567", m_text->GetValue() );
 248     else
 249         CPPUNIT_ASSERT_EQUAL( "1234567", m_text->GetValue() );
 250
 251
 252     // Entering both '-' and '.' in this control should work but only in the
 253     // correct order.
 254     sim.Char('-');
 255     wxYield();
 256     CPPUNIT_ASSERT_EQUAL( "-", text2->GetValue() );
 257
 258     text2->SetInsertionPoint(0);
 259     sim.Char('.');
 260     wxYield();
 261     CPPUNIT_ASSERT_EQUAL( "-", text2->GetValue() );
 262
 263     text2->SetInsertionPointEnd();
 264     sim.Char('.');
 265     wxYield();
 266     CPPUNIT_ASSERT_EQUAL( "-.", text2->GetValue() );
 267
 268     // Adding up to three digits after the point should work.
 269     sim.Text("987");
 270     wxYield();
 271     CPPUNIT_ASSERT_EQUAL( "-.987", text2->GetValue() );
 272
 273     // But no more.
 274     sim.Text("654");
 275     wxYield();
 276     CPPUNIT_ASSERT_EQUAL( "-.987", text2->GetValue() );
 277
 278     // We can remove one digit and another one though.
 279     sim.Char(WXK_BACK);
 280     sim.Char(WXK_BACK);
 281     sim.Char('6');
 282     wxYield();
 283     CPPUNIT_ASSERT_EQUAL( "-.96", text2->GetValue() );
 284
 285
 286     // Also test the range constraint.
 287     text2->Clear();
 288
 289     sim.Char('9');
 290     wxYield();
 291     CPPUNIT_ASSERT_EQUAL( "9", text2->GetValue() );
 292
 293     sim.Char('9');
 294     wxYield();
 295     CPPUNIT_ASSERT_EQUAL( "9", text2->GetValue() );
 296 }
 297
 298 #endif // wxUSE_UIACTIONSIMULATOR