interface/wx/numdlg.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        numdlg.h
   3 // Purpose:     interface of global functions
   4 // Author:      wxWidgets team
   5 // Licence:     wxWindows licence
   6 /////////////////////////////////////////////////////////////////////////////
   7
   8 /** @addtogroup group_funcmacro_dialog */
   9 //@{
  10
  11 /**
  12     Shows a dialog asking the user for numeric input. The dialogs title is set
  13     to @c caption, it contains a (possibly) multiline @c message above the
  14     single line @c prompt and the zone for entering the number.
  15
  16     The number entered must be in the range @c min to @c max (both of which
  17     should be positive) and @c value is the initial value of it. If the user
  18     enters an invalid value, it is forced to fall into the specified range. If
  19     the user cancels the dialog, the function returns -1.
  20
  21     Dialog is centered on its @c parent unless an explicit position is given
  22     in @c pos.
  23
  24     @header{wx/numdlg.h}
  25 */
  26 long wxGetNumberFromUser(const wxString& message,
  27                          const wxString& prompt,
  28                          const wxString& caption,
  29                          long value,
  30                          long min = 0,
  31                          long max = 100,
  32                          wxWindow* parent = NULL,
  33                          const wxPoint& pos = wxDefaultPosition);
  34
  35 //@}
  36