3f66f6a5b3
This keyword is not expanded by Git which means it's not replaced with the correct revision value in the releases made using git-based scripts and it's confusing to have lines with unexpanded "$Id$" in the released files. As expanding them with Git is not that simple (it could be done with git archive and export-subst attribute) and there are not many benefits in having them in the first place, just remove all these lines. If nothing else, this will make an eventual transition to Git simpler. Closes #14487. git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@74602 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
116 lines
3.6 KiB
C++
116 lines
3.6 KiB
C++
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: wx/validate.h
|
|
// Purpose: wxValidator class
|
|
// Author: Julian Smart
|
|
// Modified by:
|
|
// Created: 29/01/98
|
|
// Copyright: (c) 1998 Julian Smart
|
|
// Licence: wxWindows licence
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
#ifndef _WX_VALIDATE_H_
|
|
#define _WX_VALIDATE_H_
|
|
|
|
#include "wx/defs.h"
|
|
|
|
#if wxUSE_VALIDATORS
|
|
|
|
#include "wx/event.h"
|
|
|
|
class WXDLLIMPEXP_FWD_CORE wxWindow;
|
|
class WXDLLIMPEXP_FWD_CORE wxWindowBase;
|
|
|
|
/*
|
|
A validator has up to three purposes:
|
|
|
|
1) To validate the data in the window that's associated
|
|
with the validator.
|
|
2) To transfer data to and from the window.
|
|
3) To filter input, using its role as a wxEvtHandler
|
|
to intercept e.g. OnChar.
|
|
|
|
Note that wxValidator and derived classes use reference counting.
|
|
*/
|
|
|
|
class WXDLLIMPEXP_CORE wxValidator : public wxEvtHandler
|
|
{
|
|
public:
|
|
wxValidator();
|
|
wxValidator(const wxValidator& other)
|
|
: wxEvtHandler()
|
|
, m_validatorWindow(other.m_validatorWindow)
|
|
{
|
|
}
|
|
virtual ~wxValidator();
|
|
|
|
// Make a clone of this validator (or return NULL) - currently necessary
|
|
// if you're passing a reference to a validator.
|
|
// Another possibility is to always pass a pointer to a new validator
|
|
// (so the calling code can use a copy constructor of the relevant class).
|
|
virtual wxObject *Clone() const
|
|
{ return NULL; }
|
|
bool Copy(const wxValidator& val)
|
|
{ m_validatorWindow = val.m_validatorWindow; return true; }
|
|
|
|
// Called when the value in the window must be validated.
|
|
// This function can pop up an error message.
|
|
virtual bool Validate(wxWindow *WXUNUSED(parent)) { return false; }
|
|
|
|
// Called to transfer data to the window
|
|
virtual bool TransferToWindow() { return false; }
|
|
|
|
// Called to transfer data from the window
|
|
virtual bool TransferFromWindow() { return false; }
|
|
|
|
// accessors
|
|
wxWindow *GetWindow() const { return (wxWindow *)m_validatorWindow; }
|
|
void SetWindow(wxWindowBase *win) { m_validatorWindow = win; }
|
|
|
|
// validators beep by default if invalid key is pressed, this function
|
|
// allows to change this
|
|
static void SuppressBellOnError(bool suppress = true)
|
|
{ ms_isSilent = suppress; }
|
|
|
|
// test if beep is currently disabled
|
|
static bool IsSilent() { return ms_isSilent; }
|
|
|
|
// this function is deprecated because it handled its parameter
|
|
// unnaturally: it disabled the bell when it was true, not false as could
|
|
// be expected; use SuppressBellOnError() instead
|
|
#if WXWIN_COMPATIBILITY_2_8
|
|
static wxDEPRECATED_INLINE(
|
|
void SetBellOnError(bool doIt = true),
|
|
ms_isSilent = doIt;
|
|
)
|
|
#endif
|
|
|
|
protected:
|
|
wxWindowBase *m_validatorWindow;
|
|
|
|
private:
|
|
static bool ms_isSilent;
|
|
|
|
DECLARE_DYNAMIC_CLASS(wxValidator)
|
|
wxDECLARE_NO_ASSIGN_CLASS(wxValidator);
|
|
};
|
|
|
|
extern WXDLLIMPEXP_DATA_CORE(const wxValidator) wxDefaultValidator;
|
|
|
|
#define wxVALIDATOR_PARAM(val) val
|
|
|
|
#else // !wxUSE_VALIDATORS
|
|
// wxWidgets is compiled without support for wxValidator, but we still
|
|
// want to be able to pass wxDefaultValidator to the functions which take
|
|
// a wxValidator parameter to avoid using "#if wxUSE_VALIDATORS"
|
|
// everywhere
|
|
class WXDLLIMPEXP_FWD_CORE wxValidator;
|
|
#define wxDefaultValidator (*reinterpret_cast<wxValidator*>(NULL))
|
|
|
|
// this macro allows to avoid warnings about unused parameters when
|
|
// wxUSE_VALIDATORS == 0
|
|
#define wxVALIDATOR_PARAM(val)
|
|
#endif // wxUSE_VALIDATORS/!wxUSE_VALIDATORS
|
|
|
|
#endif // _WX_VALIDATE_H_
|
|
|