| 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474447544764477447844794480448144824483448444854486448744884489449044914492449344944495449644974498449945004501 |
- /////////////////////////////////////////////////////////////////////////////
- // Name: wx/event.h
- // Purpose: Event classes
- // Author: Julian Smart
- // Modified by:
- // Created: 01/02/97
- // Copyright: (c) wxWidgets team
- // Licence: wxWindows licence
- /////////////////////////////////////////////////////////////////////////////
- #ifndef _WX_EVENT_H_
- #define _WX_EVENT_H_
- #include "wx/defs.h"
- #include "wx/cpp.h"
- #include "wx/object.h"
- #include "wx/clntdata.h"
- #if wxUSE_GUI
- #include "wx/gdicmn.h"
- #include "wx/cursor.h"
- #include "wx/mousestate.h"
- #endif
- #include "wx/dynarray.h"
- #include "wx/thread.h"
- #include "wx/tracker.h"
- #include "wx/typeinfo.h"
- #include "wx/any.h"
- #ifdef wxHAS_EVENT_BIND
- #include "wx/meta/convertible.h"
- #endif
- // Currently VC6 and VC7 are known to not be able to compile CallAfter() code,
- // so disable it for them.
- #if !defined(__VISUALC__) || wxCHECK_VISUALC_VERSION(8)
- #include "wx/meta/removeref.h"
- #define wxHAS_CALL_AFTER
- #endif
- // ----------------------------------------------------------------------------
- // forward declarations
- // ----------------------------------------------------------------------------
- class WXDLLIMPEXP_FWD_BASE wxList;
- class WXDLLIMPEXP_FWD_BASE wxEvent;
- class WXDLLIMPEXP_FWD_BASE wxEventFilter;
- #if wxUSE_GUI
- class WXDLLIMPEXP_FWD_CORE wxDC;
- class WXDLLIMPEXP_FWD_CORE wxMenu;
- class WXDLLIMPEXP_FWD_CORE wxWindow;
- class WXDLLIMPEXP_FWD_CORE wxWindowBase;
- #endif // wxUSE_GUI
- // We operate with pointer to members of wxEvtHandler (such functions are used
- // as event handlers in the event tables or as arguments to Connect()) but by
- // default MSVC uses a restricted (but more efficient) representation of
- // pointers to members which can't deal with multiple base classes. To avoid
- // mysterious (as the compiler is not good enough to detect this and give a
- // sensible error message) errors in the user code as soon as it defines
- // classes inheriting from both wxEvtHandler (possibly indirectly, e.g. via
- // wxWindow) and something else (including our own wxTrackable but not limited
- // to it), we use the special MSVC keyword telling the compiler to use a more
- // general pointer to member representation for the classes inheriting from
- // wxEvtHandler.
- #ifdef __VISUALC__
- #define wxMSVC_FWD_MULTIPLE_BASES __multiple_inheritance
- #else
- #define wxMSVC_FWD_MULTIPLE_BASES
- #endif
- class WXDLLIMPEXP_FWD_BASE wxMSVC_FWD_MULTIPLE_BASES wxEvtHandler;
- class wxEventConnectionRef;
- // ----------------------------------------------------------------------------
- // Event types
- // ----------------------------------------------------------------------------
- typedef int wxEventType;
- #define wxEVT_ANY ((wxEventType)-1)
- // this is used to make the event table entry type safe, so that for an event
- // handler only a function with proper parameter list can be given. See also
- // the wxEVENT_HANDLER_CAST-macro.
- #define wxStaticCastEvent(type, val) static_cast<type>(val)
- #define wxDECLARE_EVENT_TABLE_ENTRY(type, winid, idLast, fn, obj) \
- wxEventTableEntry(type, winid, idLast, wxNewEventTableFunctor(type, fn), obj)
- #define wxDECLARE_EVENT_TABLE_TERMINATOR() \
- wxEventTableEntry(wxEVT_NULL, 0, 0, 0, 0)
- // generate a new unique event type
- extern WXDLLIMPEXP_BASE wxEventType wxNewEventType();
- // define macros to create new event types:
- #ifdef wxHAS_EVENT_BIND
- // events are represented by an instance of wxEventTypeTag and the
- // corresponding type must be specified for type-safety checks
- // define a new custom event type, can be used alone or after event
- // declaration in the header using one of the macros below
- #define wxDEFINE_EVENT( name, type ) \
- const wxEventTypeTag< type > name( wxNewEventType() )
- // the general version allowing exporting the event type from DLL, used by
- // wxWidgets itself
- #define wxDECLARE_EXPORTED_EVENT( expdecl, name, type ) \
- extern const expdecl wxEventTypeTag< type > name
- // this is the version which will normally be used in the user code
- #define wxDECLARE_EVENT( name, type ) \
- wxDECLARE_EXPORTED_EVENT( wxEMPTY_PARAMETER_VALUE, name, type )
- // these macros are only used internally for backwards compatibility and
- // allow to define an alias for an existing event type (this is used by
- // wxEVT_SPIN_XXX)
- #define wxDEFINE_EVENT_ALIAS( name, type, value ) \
- const wxEventTypeTag< type > name( value )
- #define wxDECLARE_EXPORTED_EVENT_ALIAS( expdecl, name, type ) \
- extern const expdecl wxEventTypeTag< type > name
- #else // !wxHAS_EVENT_BIND
- // the macros are the same ones as above but defined differently as we only
- // use the integer event type values to identify events in this case
- #define wxDEFINE_EVENT( name, type ) \
- const wxEventType name( wxNewEventType() )
- #define wxDECLARE_EXPORTED_EVENT( expdecl, name, type ) \
- extern const expdecl wxEventType name
- #define wxDECLARE_EVENT( name, type ) \
- wxDECLARE_EXPORTED_EVENT( wxEMPTY_PARAMETER_VALUE, name, type )
- #define wxDEFINE_EVENT_ALIAS( name, type, value ) \
- const wxEventType name = value
- #define wxDECLARE_EXPORTED_EVENT_ALIAS( expdecl, name, type ) \
- extern const expdecl wxEventType name
- #endif // wxHAS_EVENT_BIND/!wxHAS_EVENT_BIND
- // Try to cast the given event handler to the correct handler type:
- #define wxEVENT_HANDLER_CAST( functype, func ) \
- ( wxObjectEventFunction )( wxEventFunction )wxStaticCastEvent( functype, &func )
- #ifdef wxHAS_EVENT_BIND
- // The tag is a type associated to the event type (which is an integer itself,
- // in spite of its name) value. It exists in order to be used as a template
- // parameter and provide a mapping between the event type values and their
- // corresponding wxEvent-derived classes.
- template <typename T>
- class wxEventTypeTag
- {
- public:
- // The class of wxEvent-derived class carried by the events of this type.
- typedef T EventClass;
- wxEventTypeTag(wxEventType type) { m_type = type; }
- // Return a wxEventType reference for the initialization of the static
- // event tables. See wxEventTableEntry::m_eventType for a more thorough
- // explanation.
- operator const wxEventType&() const { return m_type; }
- private:
- wxEventType m_type;
- };
- #endif // wxHAS_EVENT_BIND
- // These are needed for the functor definitions
- typedef void (wxEvtHandler::*wxEventFunction)(wxEvent&);
- // We had some trouble (specifically with eVC for ARM WinCE build) with using
- // wxEventFunction in the past so we had introduced wxObjectEventFunction which
- // used to be a typedef for a member of wxObject and not wxEvtHandler to work
- // around this but as eVC is not really supported any longer we now only keep
- // this for backwards compatibility and, despite its name, this is a typedef
- // for wxEvtHandler member now -- but if we have the same problem with another
- // compiler we can restore its old definition for it.
- typedef wxEventFunction wxObjectEventFunction;
- // The event functor which is stored in the static and dynamic event tables:
- class WXDLLIMPEXP_BASE wxEventFunctor
- {
- public:
- virtual ~wxEventFunctor();
- // Invoke the actual event handler:
- virtual void operator()(wxEvtHandler *, wxEvent&) = 0;
- // this function tests whether this functor is matched, for the purpose of
- // finding it in an event table in Unbind(), by the given functor:
- virtual bool IsMatching(const wxEventFunctor& functor) const = 0;
- // If the functor holds an wxEvtHandler, then get access to it and track
- // its lifetime with wxEventConnectionRef:
- virtual wxEvtHandler *GetEvtHandler() const
- { return NULL; }
- // This is only used to maintain backward compatibility in
- // wxAppConsoleBase::CallEventHandler and ensures that an overwritten
- // wxAppConsoleBase::HandleEvent is still called for functors which hold an
- // wxEventFunction:
- virtual wxEventFunction GetEvtMethod() const
- { return NULL; }
- private:
- WX_DECLARE_ABSTRACT_TYPEINFO(wxEventFunctor)
- };
- // A plain method functor for the untyped legacy event types:
- class WXDLLIMPEXP_BASE wxObjectEventFunctor : public wxEventFunctor
- {
- public:
- wxObjectEventFunctor(wxObjectEventFunction method, wxEvtHandler *handler)
- : m_handler( handler ), m_method( method )
- { }
- virtual void operator()(wxEvtHandler *handler, wxEvent& event);
- virtual bool IsMatching(const wxEventFunctor& functor) const
- {
- if ( wxTypeId(functor) == wxTypeId(*this) )
- {
- const wxObjectEventFunctor &other =
- static_cast< const wxObjectEventFunctor & >( functor );
- // FIXME-VC6: amazing but true: replacing "m_method == 0" here
- // with "!m_method" makes VC6 crash with an ICE in DLL build (only!)
- // Also notice that using "NULL" instead of "0" results in warnings
- // about "using NULL in arithmetics" from arm-linux-androideabi-g++
- // 4.4.3 used for wxAndroid build.
- return ( m_method == other.m_method || other.m_method == 0 ) &&
- ( m_handler == other.m_handler || other.m_handler == NULL );
- }
- else
- return false;
- }
- virtual wxEvtHandler *GetEvtHandler() const
- { return m_handler; }
- virtual wxEventFunction GetEvtMethod() const
- { return m_method; }
- private:
- wxEvtHandler *m_handler;
- wxEventFunction m_method;
- // Provide a dummy default ctor for type info purposes
- wxObjectEventFunctor() { }
- WX_DECLARE_TYPEINFO_INLINE(wxObjectEventFunctor)
- };
- // Create a functor for the legacy events: used by Connect()
- inline wxObjectEventFunctor *
- wxNewEventFunctor(const wxEventType& WXUNUSED(evtType),
- wxObjectEventFunction method,
- wxEvtHandler *handler)
- {
- return new wxObjectEventFunctor(method, handler);
- }
- // This version is used by wxDECLARE_EVENT_TABLE_ENTRY()
- inline wxObjectEventFunctor *
- wxNewEventTableFunctor(const wxEventType& WXUNUSED(evtType),
- wxObjectEventFunction method)
- {
- return new wxObjectEventFunctor(method, NULL);
- }
- inline wxObjectEventFunctor
- wxMakeEventFunctor(const wxEventType& WXUNUSED(evtType),
- wxObjectEventFunction method,
- wxEvtHandler *handler)
- {
- return wxObjectEventFunctor(method, handler);
- }
- #ifdef wxHAS_EVENT_BIND
- namespace wxPrivate
- {
- // helper template defining nested "type" typedef as the event class
- // corresponding to the given event type
- template <typename T> struct EventClassOf;
- // the typed events provide the information about the class of the events they
- // carry themselves:
- template <typename T>
- struct EventClassOf< wxEventTypeTag<T> >
- {
- typedef typename wxEventTypeTag<T>::EventClass type;
- };
- // for the old untyped events we don't have information about the exact event
- // class carried by them
- template <>
- struct EventClassOf<wxEventType>
- {
- typedef wxEvent type;
- };
- // helper class defining operations different for method functors using an
- // object of wxEvtHandler-derived class as handler and the others
- template <typename T, typename A, bool> struct HandlerImpl;
- // specialization for handlers deriving from wxEvtHandler
- template <typename T, typename A>
- struct HandlerImpl<T, A, true>
- {
- static bool IsEvtHandler()
- { return true; }
- static T *ConvertFromEvtHandler(wxEvtHandler *p)
- { return static_cast<T *>(p); }
- static wxEvtHandler *ConvertToEvtHandler(T *p)
- { return p; }
- static wxEventFunction ConvertToEvtMethod(void (T::*f)(A&))
- { return static_cast<wxEventFunction>(
- reinterpret_cast<void (T::*)(wxEvent&)>(f)); }
- };
- // specialization for handlers not deriving from wxEvtHandler
- template <typename T, typename A>
- struct HandlerImpl<T, A, false>
- {
- static bool IsEvtHandler()
- { return false; }
- static T *ConvertFromEvtHandler(wxEvtHandler *)
- { return NULL; }
- static wxEvtHandler *ConvertToEvtHandler(T *)
- { return NULL; }
- static wxEventFunction ConvertToEvtMethod(void (T::*)(A&))
- { return NULL; }
- };
- } // namespace wxPrivate
- // functor forwarding the event to a method of the given object
- //
- // notice that the object class may be different from the class in which the
- // method is defined but it must be convertible to this class
- //
- // also, the type of the handler parameter doesn't need to be exactly the same
- // as EventTag::EventClass but it must be its base class -- this is explicitly
- // allowed to handle different events in the same handler taking wxEvent&, for
- // example
- template
- <typename EventTag, typename Class, typename EventArg, typename EventHandler>
- class wxEventFunctorMethod
- : public wxEventFunctor,
- private wxPrivate::HandlerImpl
- <
- Class,
- EventArg,
- wxConvertibleTo<Class, wxEvtHandler>::value != 0
- >
- {
- private:
- static void CheckHandlerArgument(EventArg *) { }
- public:
- // the event class associated with the given event tag
- typedef typename wxPrivate::EventClassOf<EventTag>::type EventClass;
- wxEventFunctorMethod(void (Class::*method)(EventArg&), EventHandler *handler)
- : m_handler( handler ), m_method( method )
- {
- wxASSERT_MSG( handler || this->IsEvtHandler(),
- "handlers defined in non-wxEvtHandler-derived classes "
- "must be connected with a valid sink object" );
- // if you get an error here it means that the signature of the handler
- // you're trying to use is not compatible with (i.e. is not the same as
- // or a base class of) the real event class used for this event type
- CheckHandlerArgument(static_cast<EventClass *>(NULL));
- }
- virtual void operator()(wxEvtHandler *handler, wxEvent& event)
- {
- Class * realHandler = m_handler;
- if ( !realHandler )
- {
- realHandler = this->ConvertFromEvtHandler(handler);
- // this is not supposed to happen but check for it nevertheless
- wxCHECK_RET( realHandler, "invalid event handler" );
- }
- // the real (run-time) type of event is EventClass and we checked in
- // the ctor that EventClass can be converted to EventArg, so this cast
- // is always valid
- (realHandler->*m_method)(static_cast<EventArg&>(event));
- }
- virtual bool IsMatching(const wxEventFunctor& functor) const
- {
- if ( wxTypeId(functor) != wxTypeId(*this) )
- return false;
- typedef wxEventFunctorMethod<EventTag, Class, EventArg, EventHandler>
- ThisFunctor;
- // the cast is valid because wxTypeId()s matched above
- const ThisFunctor& other = static_cast<const ThisFunctor &>(functor);
- return (m_method == other.m_method || other.m_method == NULL) &&
- (m_handler == other.m_handler || other.m_handler == NULL);
- }
- virtual wxEvtHandler *GetEvtHandler() const
- { return this->ConvertToEvtHandler(m_handler); }
- virtual wxEventFunction GetEvtMethod() const
- { return this->ConvertToEvtMethod(m_method); }
- private:
- EventHandler *m_handler;
- void (Class::*m_method)(EventArg&);
- // Provide a dummy default ctor for type info purposes
- wxEventFunctorMethod() { }
- typedef wxEventFunctorMethod<EventTag, Class,
- EventArg, EventHandler> thisClass;
- WX_DECLARE_TYPEINFO_INLINE(thisClass)
- };
- // functor forwarding the event to function (function, static method)
- template <typename EventTag, typename EventArg>
- class wxEventFunctorFunction : public wxEventFunctor
- {
- private:
- static void CheckHandlerArgument(EventArg *) { }
- public:
- // the event class associated with the given event tag
- typedef typename wxPrivate::EventClassOf<EventTag>::type EventClass;
- wxEventFunctorFunction( void ( *handler )( EventArg & ))
- : m_handler( handler )
- {
- // if you get an error here it means that the signature of the handler
- // you're trying to use is not compatible with (i.e. is not the same as
- // or a base class of) the real event class used for this event type
- CheckHandlerArgument(static_cast<EventClass *>(NULL));
- }
- virtual void operator()(wxEvtHandler *WXUNUSED(handler), wxEvent& event)
- {
- // If you get an error here like "must use .* or ->* to call
- // pointer-to-member function" then you probably tried to call
- // Bind/Unbind with a method pointer but without a handler pointer or
- // NULL as a handler e.g.:
- // Unbind( wxEVT_XXX, &EventHandler::method );
- // or
- // Unbind( wxEVT_XXX, &EventHandler::method, NULL )
- m_handler(static_cast<EventArg&>(event));
- }
- virtual bool IsMatching(const wxEventFunctor &functor) const
- {
- if ( wxTypeId(functor) != wxTypeId(*this) )
- return false;
- typedef wxEventFunctorFunction<EventTag, EventArg> ThisFunctor;
- const ThisFunctor& other = static_cast<const ThisFunctor&>( functor );
- return m_handler == other.m_handler;
- }
- private:
- void (*m_handler)(EventArg&);
- // Provide a dummy default ctor for type info purposes
- wxEventFunctorFunction() { }
- typedef wxEventFunctorFunction<EventTag, EventArg> thisClass;
- WX_DECLARE_TYPEINFO_INLINE(thisClass)
- };
- template <typename EventTag, typename Functor>
- class wxEventFunctorFunctor : public wxEventFunctor
- {
- public:
- typedef typename EventTag::EventClass EventArg;
- wxEventFunctorFunctor(const Functor& handler)
- : m_handler(handler), m_handlerAddr(&handler)
- { }
- virtual void operator()(wxEvtHandler *WXUNUSED(handler), wxEvent& event)
- {
- // If you get an error here like "must use '.*' or '->*' to call
- // pointer-to-member function" then you probably tried to call
- // Bind/Unbind with a method pointer but without a handler pointer or
- // NULL as a handler e.g.:
- // Unbind( wxEVT_XXX, &EventHandler::method );
- // or
- // Unbind( wxEVT_XXX, &EventHandler::method, NULL )
- m_handler(static_cast<EventArg&>(event));
- }
- virtual bool IsMatching(const wxEventFunctor &functor) const
- {
- if ( wxTypeId(functor) != wxTypeId(*this) )
- return false;
- typedef wxEventFunctorFunctor<EventTag, Functor> FunctorThis;
- const FunctorThis& other = static_cast<const FunctorThis&>(functor);
- // The only reliable/portable way to compare two functors is by
- // identity:
- return m_handlerAddr == other.m_handlerAddr;
- }
- private:
- // Store a copy of the functor to prevent using/calling an already
- // destroyed instance:
- Functor m_handler;
- // Use the address of the original functor for comparison in IsMatching:
- const void *m_handlerAddr;
- // Provide a dummy default ctor for type info purposes
- wxEventFunctorFunctor() { }
- typedef wxEventFunctorFunctor<EventTag, Functor> thisClass;
- WX_DECLARE_TYPEINFO_INLINE(thisClass)
- };
- // Create functors for the templatized events, either allocated on the heap for
- // wxNewXXX() variants (this is needed in wxEvtHandler::Bind<>() to store them
- // in dynamic event table) or just by returning them as temporary objects (this
- // is enough for Unbind<>() and we avoid unnecessary heap allocation like this).
- // Create functors wrapping functions:
- template <typename EventTag, typename EventArg>
- inline wxEventFunctorFunction<EventTag, EventArg> *
- wxNewEventFunctor(const EventTag&, void (*func)(EventArg &))
- {
- return new wxEventFunctorFunction<EventTag, EventArg>(func);
- }
- template <typename EventTag, typename EventArg>
- inline wxEventFunctorFunction<EventTag, EventArg>
- wxMakeEventFunctor(const EventTag&, void (*func)(EventArg &))
- {
- return wxEventFunctorFunction<EventTag, EventArg>(func);
- }
- // Create functors wrapping other functors:
- template <typename EventTag, typename Functor>
- inline wxEventFunctorFunctor<EventTag, Functor> *
- wxNewEventFunctor(const EventTag&, const Functor &func)
- {
- return new wxEventFunctorFunctor<EventTag, Functor>(func);
- }
- template <typename EventTag, typename Functor>
- inline wxEventFunctorFunctor<EventTag, Functor>
- wxMakeEventFunctor(const EventTag&, const Functor &func)
- {
- return wxEventFunctorFunctor<EventTag, Functor>(func);
- }
- // Create functors wrapping methods:
- template
- <typename EventTag, typename Class, typename EventArg, typename EventHandler>
- inline wxEventFunctorMethod<EventTag, Class, EventArg, EventHandler> *
- wxNewEventFunctor(const EventTag&,
- void (Class::*method)(EventArg&),
- EventHandler *handler)
- {
- return new wxEventFunctorMethod<EventTag, Class, EventArg, EventHandler>(
- method, handler);
- }
- template
- <typename EventTag, typename Class, typename EventArg, typename EventHandler>
- inline wxEventFunctorMethod<EventTag, Class, EventArg, EventHandler>
- wxMakeEventFunctor(const EventTag&,
- void (Class::*method)(EventArg&),
- EventHandler *handler)
- {
- return wxEventFunctorMethod<EventTag, Class, EventArg, EventHandler>(
- method, handler);
- }
- // Create an event functor for the event table via wxDECLARE_EVENT_TABLE_ENTRY:
- // in this case we don't have the handler (as it's always the same as the
- // object which generated the event) so we must use Class as its type
- template <typename EventTag, typename Class, typename EventArg>
- inline wxEventFunctorMethod<EventTag, Class, EventArg, Class> *
- wxNewEventTableFunctor(const EventTag&, void (Class::*method)(EventArg&))
- {
- return new wxEventFunctorMethod<EventTag, Class, EventArg, Class>(
- method, NULL);
- }
- #endif // wxHAS_EVENT_BIND
- // many, but not all, standard event types
- // some generic events
- extern WXDLLIMPEXP_BASE const wxEventType wxEVT_NULL;
- extern WXDLLIMPEXP_BASE const wxEventType wxEVT_FIRST;
- extern WXDLLIMPEXP_BASE const wxEventType wxEVT_USER_FIRST;
- // Need events declared to do this
- class WXDLLIMPEXP_FWD_BASE wxIdleEvent;
- class WXDLLIMPEXP_FWD_BASE wxThreadEvent;
- class WXDLLIMPEXP_FWD_BASE wxAsyncMethodCallEvent;
- class WXDLLIMPEXP_FWD_CORE wxCommandEvent;
- class WXDLLIMPEXP_FWD_CORE wxMouseEvent;
- class WXDLLIMPEXP_FWD_CORE wxFocusEvent;
- class WXDLLIMPEXP_FWD_CORE wxChildFocusEvent;
- class WXDLLIMPEXP_FWD_CORE wxKeyEvent;
- class WXDLLIMPEXP_FWD_CORE wxNavigationKeyEvent;
- class WXDLLIMPEXP_FWD_CORE wxSetCursorEvent;
- class WXDLLIMPEXP_FWD_CORE wxScrollEvent;
- class WXDLLIMPEXP_FWD_CORE wxSpinEvent;
- class WXDLLIMPEXP_FWD_CORE wxScrollWinEvent;
- class WXDLLIMPEXP_FWD_CORE wxSizeEvent;
- class WXDLLIMPEXP_FWD_CORE wxMoveEvent;
- class WXDLLIMPEXP_FWD_CORE wxCloseEvent;
- class WXDLLIMPEXP_FWD_CORE wxActivateEvent;
- class WXDLLIMPEXP_FWD_CORE wxWindowCreateEvent;
- class WXDLLIMPEXP_FWD_CORE wxWindowDestroyEvent;
- class WXDLLIMPEXP_FWD_CORE wxShowEvent;
- class WXDLLIMPEXP_FWD_CORE wxIconizeEvent;
- class WXDLLIMPEXP_FWD_CORE wxMaximizeEvent;
- class WXDLLIMPEXP_FWD_CORE wxMouseCaptureChangedEvent;
- class WXDLLIMPEXP_FWD_CORE wxMouseCaptureLostEvent;
- class WXDLLIMPEXP_FWD_CORE wxPaintEvent;
- class WXDLLIMPEXP_FWD_CORE wxEraseEvent;
- class WXDLLIMPEXP_FWD_CORE wxNcPaintEvent;
- class WXDLLIMPEXP_FWD_CORE wxMenuEvent;
- class WXDLLIMPEXP_FWD_CORE wxContextMenuEvent;
- class WXDLLIMPEXP_FWD_CORE wxSysColourChangedEvent;
- class WXDLLIMPEXP_FWD_CORE wxDisplayChangedEvent;
- class WXDLLIMPEXP_FWD_CORE wxQueryNewPaletteEvent;
- class WXDLLIMPEXP_FWD_CORE wxPaletteChangedEvent;
- class WXDLLIMPEXP_FWD_CORE wxJoystickEvent;
- class WXDLLIMPEXP_FWD_CORE wxDropFilesEvent;
- class WXDLLIMPEXP_FWD_CORE wxInitDialogEvent;
- class WXDLLIMPEXP_FWD_CORE wxUpdateUIEvent;
- class WXDLLIMPEXP_FWD_CORE wxClipboardTextEvent;
- class WXDLLIMPEXP_FWD_CORE wxHelpEvent;
- // Command events
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_BUTTON, wxCommandEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_CHECKBOX, wxCommandEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_CHOICE, wxCommandEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_LISTBOX, wxCommandEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_LISTBOX_DCLICK, wxCommandEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_CHECKLISTBOX, wxCommandEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_MENU, wxCommandEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SLIDER, wxCommandEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_RADIOBOX, wxCommandEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_RADIOBUTTON, wxCommandEvent);
- // wxEVT_SCROLLBAR is deprecated, use wxEVT_SCROLL... events
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SCROLLBAR, wxCommandEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_VLBOX, wxCommandEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_COMBOBOX, wxCommandEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_TOOL_RCLICKED, wxCommandEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_TOOL_DROPDOWN, wxCommandEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_TOOL_ENTER, wxCommandEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_COMBOBOX_DROPDOWN, wxCommandEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_COMBOBOX_CLOSEUP, wxCommandEvent);
- // Thread and asynchronous method call events
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_BASE, wxEVT_THREAD, wxThreadEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_BASE, wxEVT_ASYNC_METHOD_CALL, wxAsyncMethodCallEvent);
- // Mouse event types
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_LEFT_DOWN, wxMouseEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_LEFT_UP, wxMouseEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_MIDDLE_DOWN, wxMouseEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_MIDDLE_UP, wxMouseEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_RIGHT_DOWN, wxMouseEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_RIGHT_UP, wxMouseEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_MOTION, wxMouseEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_ENTER_WINDOW, wxMouseEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_LEAVE_WINDOW, wxMouseEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_LEFT_DCLICK, wxMouseEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_MIDDLE_DCLICK, wxMouseEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_RIGHT_DCLICK, wxMouseEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SET_FOCUS, wxFocusEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_KILL_FOCUS, wxFocusEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_CHILD_FOCUS, wxChildFocusEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_MOUSEWHEEL, wxMouseEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_AUX1_DOWN, wxMouseEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_AUX1_UP, wxMouseEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_AUX1_DCLICK, wxMouseEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_AUX2_DOWN, wxMouseEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_AUX2_UP, wxMouseEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_AUX2_DCLICK, wxMouseEvent);
- // Character input event type
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_CHAR, wxKeyEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_CHAR_HOOK, wxKeyEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_NAVIGATION_KEY, wxNavigationKeyEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_KEY_DOWN, wxKeyEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_KEY_UP, wxKeyEvent);
- #if wxUSE_HOTKEY
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_HOTKEY, wxKeyEvent);
- #endif
- // This is a private event used by wxMSW code only and subject to change or
- // disappear in the future. Don't use.
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_AFTER_CHAR, wxKeyEvent);
- // Set cursor event
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SET_CURSOR, wxSetCursorEvent);
- // wxScrollBar and wxSlider event identifiers
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SCROLL_TOP, wxScrollEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SCROLL_BOTTOM, wxScrollEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SCROLL_LINEUP, wxScrollEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SCROLL_LINEDOWN, wxScrollEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SCROLL_PAGEUP, wxScrollEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SCROLL_PAGEDOWN, wxScrollEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SCROLL_THUMBTRACK, wxScrollEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SCROLL_THUMBRELEASE, wxScrollEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SCROLL_CHANGED, wxScrollEvent);
- // Due to a bug in older wx versions, wxSpinEvents were being sent with type of
- // wxEVT_SCROLL_LINEUP, wxEVT_SCROLL_LINEDOWN and wxEVT_SCROLL_THUMBTRACK. But
- // with the type-safe events in place, these event types are associated with
- // wxScrollEvent. To allow handling of spin events, new event types have been
- // defined in spinbutt.h/spinnbuttcmn.cpp. To maintain backward compatibility
- // the spin event types are being initialized with the scroll event types.
- #if wxUSE_SPINBTN
- wxDECLARE_EXPORTED_EVENT_ALIAS( WXDLLIMPEXP_CORE, wxEVT_SPIN_UP, wxSpinEvent );
- wxDECLARE_EXPORTED_EVENT_ALIAS( WXDLLIMPEXP_CORE, wxEVT_SPIN_DOWN, wxSpinEvent );
- wxDECLARE_EXPORTED_EVENT_ALIAS( WXDLLIMPEXP_CORE, wxEVT_SPIN, wxSpinEvent );
- #endif
- // Scroll events from wxWindow
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SCROLLWIN_TOP, wxScrollWinEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SCROLLWIN_BOTTOM, wxScrollWinEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SCROLLWIN_LINEUP, wxScrollWinEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SCROLLWIN_LINEDOWN, wxScrollWinEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SCROLLWIN_PAGEUP, wxScrollWinEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SCROLLWIN_PAGEDOWN, wxScrollWinEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SCROLLWIN_THUMBTRACK, wxScrollWinEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SCROLLWIN_THUMBRELEASE, wxScrollWinEvent);
- // System events
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SIZE, wxSizeEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_MOVE, wxMoveEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_CLOSE_WINDOW, wxCloseEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_END_SESSION, wxCloseEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_QUERY_END_SESSION, wxCloseEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_ACTIVATE_APP, wxActivateEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_ACTIVATE, wxActivateEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_CREATE, wxWindowCreateEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_DESTROY, wxWindowDestroyEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SHOW, wxShowEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_ICONIZE, wxIconizeEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_MAXIMIZE, wxMaximizeEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_MOUSE_CAPTURE_CHANGED, wxMouseCaptureChangedEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_MOUSE_CAPTURE_LOST, wxMouseCaptureLostEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_PAINT, wxPaintEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_ERASE_BACKGROUND, wxEraseEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_NC_PAINT, wxNcPaintEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_MENU_OPEN, wxMenuEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_MENU_CLOSE, wxMenuEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_MENU_HIGHLIGHT, wxMenuEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_CONTEXT_MENU, wxContextMenuEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SYS_COLOUR_CHANGED, wxSysColourChangedEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_DISPLAY_CHANGED, wxDisplayChangedEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_QUERY_NEW_PALETTE, wxQueryNewPaletteEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_PALETTE_CHANGED, wxPaletteChangedEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_JOY_BUTTON_DOWN, wxJoystickEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_JOY_BUTTON_UP, wxJoystickEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_JOY_MOVE, wxJoystickEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_JOY_ZMOVE, wxJoystickEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_DROP_FILES, wxDropFilesEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_INIT_DIALOG, wxInitDialogEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_BASE, wxEVT_IDLE, wxIdleEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_UPDATE_UI, wxUpdateUIEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_SIZING, wxSizeEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_MOVING, wxMoveEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_MOVE_START, wxMoveEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_MOVE_END, wxMoveEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_HIBERNATE, wxActivateEvent);
- // Clipboard events
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_TEXT_COPY, wxClipboardTextEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_TEXT_CUT, wxClipboardTextEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_TEXT_PASTE, wxClipboardTextEvent);
- // Generic command events
- // Note: a click is a higher-level event than button down/up
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_COMMAND_LEFT_CLICK, wxCommandEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_COMMAND_LEFT_DCLICK, wxCommandEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_COMMAND_RIGHT_CLICK, wxCommandEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_COMMAND_RIGHT_DCLICK, wxCommandEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_COMMAND_SET_FOCUS, wxCommandEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_COMMAND_KILL_FOCUS, wxCommandEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_COMMAND_ENTER, wxCommandEvent);
- // Help events
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_HELP, wxHelpEvent);
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_DETAILED_HELP, wxHelpEvent);
- // these 2 events are the same
- #define wxEVT_TOOL wxEVT_MENU
- // ----------------------------------------------------------------------------
- // Compatibility
- // ----------------------------------------------------------------------------
- // this event is also used by wxComboBox and wxSpinCtrl which don't include
- // wx/textctrl.h in all ports [yet], so declare it here as well
- //
- // still, any new code using it should include wx/textctrl.h explicitly
- wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_CORE, wxEVT_TEXT, wxCommandEvent);
- // ----------------------------------------------------------------------------
- // wxEvent(-derived) classes
- // ----------------------------------------------------------------------------
- // the predefined constants for the number of times we propagate event
- // upwards window child-parent chain
- enum wxEventPropagation
- {
- // don't propagate it at all
- wxEVENT_PROPAGATE_NONE = 0,
- // propagate it until it is processed
- wxEVENT_PROPAGATE_MAX = INT_MAX
- };
- // The different categories for a wxEvent; see wxEvent::GetEventCategory.
- // NOTE: they are used as OR-combinable flags by wxEventLoopBase::YieldFor
- enum wxEventCategory
- {
- // this is the category for those events which are generated to update
- // the appearance of the GUI but which (usually) do not comport data
- // processing, i.e. which do not provide input or output data
- // (e.g. size events, scroll events, etc).
- // They are events NOT directly generated by the user's input devices.
- wxEVT_CATEGORY_UI = 1,
- // this category groups those events which are generated directly from the
- // user through input devices like mouse and keyboard and usually result in
- // data to be processed from the application.
- // (e.g. mouse clicks, key presses, etc)
- wxEVT_CATEGORY_USER_INPUT = 2,
- // this category is for wxSocketEvent
- wxEVT_CATEGORY_SOCKET = 4,
- // this category is for wxTimerEvent
- wxEVT_CATEGORY_TIMER = 8,
- // this category is for any event used to send notifications from the
- // secondary threads to the main one or in general for notifications among
- // different threads (which may or may not be user-generated)
- wxEVT_CATEGORY_THREAD = 16,
- // implementation only
- // used in the implementations of wxEventLoopBase::YieldFor
- wxEVT_CATEGORY_UNKNOWN = 32,
- // a special category used as an argument to wxEventLoopBase::YieldFor to indicate that
- // Yield() should leave all wxEvents on the queue while emptying the native event queue
- // (native events will be processed but the wxEvents they generate will be queued)
- wxEVT_CATEGORY_CLIPBOARD = 64,
- // shortcut masks
- // this category groups those events which are emitted in response to
- // events of the native toolkit and which typically are not-"delayable".
- wxEVT_CATEGORY_NATIVE_EVENTS = wxEVT_CATEGORY_UI|wxEVT_CATEGORY_USER_INPUT,
- // used in wxEventLoopBase::YieldFor to specify all event categories should be processed:
- wxEVT_CATEGORY_ALL =
- wxEVT_CATEGORY_UI|wxEVT_CATEGORY_USER_INPUT|wxEVT_CATEGORY_SOCKET| \
- wxEVT_CATEGORY_TIMER|wxEVT_CATEGORY_THREAD|wxEVT_CATEGORY_UNKNOWN| \
- wxEVT_CATEGORY_CLIPBOARD
- };
- /*
- * wxWidgets events, covering all interesting things that might happen
- * (button clicking, resizing, setting text in widgets, etc.).
- *
- * For each completely new event type, derive a new event class.
- * An event CLASS represents a C++ class defining a range of similar event TYPES;
- * examples are canvas events, panel item command events.
- * An event TYPE is a unique identifier for a particular system event,
- * such as a button press or a listbox deselection.
- *
- */
- class WXDLLIMPEXP_BASE wxEvent : public wxObject
- {
- public:
- wxEvent(int winid = 0, wxEventType commandType = wxEVT_NULL );
- void SetEventType(wxEventType typ) { m_eventType = typ; }
- wxEventType GetEventType() const { return m_eventType; }
- wxObject *GetEventObject() const { return m_eventObject; }
- void SetEventObject(wxObject *obj) { m_eventObject = obj; }
- long GetTimestamp() const { return m_timeStamp; }
- void SetTimestamp(long ts = 0) { m_timeStamp = ts; }
- int GetId() const { return m_id; }
- void SetId(int Id) { m_id = Id; }
- // Returns the user data optionally associated with the event handler when
- // using Connect() or Bind().
- wxObject *GetEventUserData() const { return m_callbackUserData; }
- // Can instruct event processor that we wish to ignore this event
- // (treat as if the event table entry had not been found): this must be done
- // to allow the event processing by the base classes (calling event.Skip()
- // is the analog of calling the base class version of a virtual function)
- void Skip(bool skip = true) { m_skipped = skip; }
- bool GetSkipped() const { return m_skipped; }
- // This function is used to create a copy of the event polymorphically and
- // all derived classes must implement it because otherwise wxPostEvent()
- // for them wouldn't work (it needs to do a copy of the event)
- virtual wxEvent *Clone() const = 0;
- // this function is used to selectively process events in wxEventLoopBase::YieldFor
- // NOTE: by default it returns wxEVT_CATEGORY_UI just because the major
- // part of wxWidgets events belong to that category.
- virtual wxEventCategory GetEventCategory() const
- { return wxEVT_CATEGORY_UI; }
- // Implementation only: this test is explicitly anti OO and this function
- // exists only for optimization purposes.
- bool IsCommandEvent() const { return m_isCommandEvent; }
- // Determine if this event should be propagating to the parent window.
- bool ShouldPropagate() const
- { return m_propagationLevel != wxEVENT_PROPAGATE_NONE; }
- // Stop an event from propagating to its parent window, returns the old
- // propagation level value
- int StopPropagation()
- {
- int propagationLevel = m_propagationLevel;
- m_propagationLevel = wxEVENT_PROPAGATE_NONE;
- return propagationLevel;
- }
- // Resume the event propagation by restoring the propagation level
- // (returned by StopPropagation())
- void ResumePropagation(int propagationLevel)
- {
- m_propagationLevel = propagationLevel;
- }
- // This method is for internal use only and allows to get the object that
- // is propagating this event upwards the window hierarchy, if any.
- wxEvtHandler* GetPropagatedFrom() const { return m_propagatedFrom; }
- // This is for internal use only and is only called by
- // wxEvtHandler::ProcessEvent() to check whether it's the first time this
- // event is being processed
- bool WasProcessed()
- {
- if ( m_wasProcessed )
- return true;
- m_wasProcessed = true;
- return false;
- }
- // This is for internal use only and is used for setting, testing and
- // resetting of m_willBeProcessedAgain flag.
- void SetWillBeProcessedAgain()
- {
- m_willBeProcessedAgain = true;
- }
- bool WillBeProcessedAgain()
- {
- if ( m_willBeProcessedAgain )
- {
- m_willBeProcessedAgain = false;
- return true;
- }
- return false;
- }
- // This is also used only internally by ProcessEvent() to check if it
- // should process the event normally or only restrict the search for the
- // event handler to this object itself.
- bool ShouldProcessOnlyIn(wxEvtHandler *h) const
- {
- return h == m_handlerToProcessOnlyIn;
- }
- // Called to indicate that the result of ShouldProcessOnlyIn() wasn't taken
- // into account. The existence of this function may seem counterintuitive
- // but unfortunately it's needed by wxScrollHelperEvtHandler, see comments
- // there. Don't even think of using this in your own code, this is a gross
- // hack and is only needed because of wx complicated history and should
- // never be used anywhere else.
- void DidntHonourProcessOnlyIn()
- {
- m_handlerToProcessOnlyIn = NULL;
- }
- protected:
- wxObject* m_eventObject;
- wxEventType m_eventType;
- long m_timeStamp;
- int m_id;
- public:
- // m_callbackUserData is for internal usage only
- wxObject* m_callbackUserData;
- private:
- // If this handler
- wxEvtHandler *m_handlerToProcessOnlyIn;
- protected:
- // the propagation level: while it is positive, we propagate the event to
- // the parent window (if any)
- int m_propagationLevel;
- // The object that the event is being propagated from, initially NULL and
- // only set by wxPropagateOnce.
- wxEvtHandler* m_propagatedFrom;
- bool m_skipped;
- bool m_isCommandEvent;
- // initially false but becomes true as soon as WasProcessed() is called for
- // the first time, as this is done only by ProcessEvent() it explains the
- // variable name: it becomes true after ProcessEvent() was called at least
- // once for this event
- bool m_wasProcessed;
- // This one is initially false too, but can be set to true to indicate that
- // the event will be passed to another handler if it's not processed in
- // this one.
- bool m_willBeProcessedAgain;
- protected:
- wxEvent(const wxEvent&); // for implementing Clone()
- wxEvent& operator=(const wxEvent&); // for derived classes operator=()
- private:
- // It needs to access our m_propagationLevel and m_propagatedFrom fields.
- friend class WXDLLIMPEXP_FWD_BASE wxPropagateOnce;
- // and this one needs to access our m_handlerToProcessOnlyIn
- friend class WXDLLIMPEXP_FWD_BASE wxEventProcessInHandlerOnly;
- DECLARE_ABSTRACT_CLASS(wxEvent)
- };
- /*
- * Helper class to temporarily change an event not to propagate.
- */
- class WXDLLIMPEXP_BASE wxPropagationDisabler
- {
- public:
- wxPropagationDisabler(wxEvent& event) : m_event(event)
- {
- m_propagationLevelOld = m_event.StopPropagation();
- }
- ~wxPropagationDisabler()
- {
- m_event.ResumePropagation(m_propagationLevelOld);
- }
- private:
- wxEvent& m_event;
- int m_propagationLevelOld;
- wxDECLARE_NO_COPY_CLASS(wxPropagationDisabler);
- };
- /*
- * Helper used to indicate that an event is propagated upwards the window
- * hierarchy by the given window.
- */
- class WXDLLIMPEXP_BASE wxPropagateOnce
- {
- public:
- // The handler argument should normally be non-NULL to allow the parent
- // event handler to know that it's being used to process an event coming
- // from the child, it's only NULL by default for backwards compatibility.
- wxPropagateOnce(wxEvent& event, wxEvtHandler* handler = NULL)
- : m_event(event),
- m_propagatedFromOld(event.m_propagatedFrom)
- {
- wxASSERT_MSG( m_event.m_propagationLevel > 0,
- wxT("shouldn't be used unless ShouldPropagate()!") );
- m_event.m_propagationLevel--;
- m_event.m_propagatedFrom = handler;
- }
- ~wxPropagateOnce()
- {
- m_event.m_propagatedFrom = m_propagatedFromOld;
- m_event.m_propagationLevel++;
- }
- private:
- wxEvent& m_event;
- wxEvtHandler* const m_propagatedFromOld;
- wxDECLARE_NO_COPY_CLASS(wxPropagateOnce);
- };
- // A helper object used to temporarily make wxEvent::ShouldProcessOnlyIn()
- // return true for the handler passed to its ctor.
- class wxEventProcessInHandlerOnly
- {
- public:
- wxEventProcessInHandlerOnly(wxEvent& event, wxEvtHandler *handler)
- : m_event(event),
- m_handlerToProcessOnlyInOld(event.m_handlerToProcessOnlyIn)
- {
- m_event.m_handlerToProcessOnlyIn = handler;
- }
- ~wxEventProcessInHandlerOnly()
- {
- m_event.m_handlerToProcessOnlyIn = m_handlerToProcessOnlyInOld;
- }
- private:
- wxEvent& m_event;
- wxEvtHandler * const m_handlerToProcessOnlyInOld;
- wxDECLARE_NO_COPY_CLASS(wxEventProcessInHandlerOnly);
- };
- class WXDLLIMPEXP_BASE wxEventBasicPayloadMixin
- {
- public:
- wxEventBasicPayloadMixin()
- : m_commandInt(0),
- m_extraLong(0)
- {
- }
- void SetString(const wxString& s) { m_cmdString = s; }
- const wxString& GetString() const { return m_cmdString; }
- void SetInt(int i) { m_commandInt = i; }
- int GetInt() const { return m_commandInt; }
- void SetExtraLong(long extraLong) { m_extraLong = extraLong; }
- long GetExtraLong() const { return m_extraLong; }
- protected:
- // Note: these variables have "cmd" or "command" in their name for backward compatibility:
- // they used to be part of wxCommandEvent, not this mixin.
- wxString m_cmdString; // String event argument
- int m_commandInt;
- long m_extraLong; // Additional information (e.g. select/deselect)
- wxDECLARE_NO_ASSIGN_CLASS(wxEventBasicPayloadMixin);
- };
- class WXDLLIMPEXP_BASE wxEventAnyPayloadMixin : public wxEventBasicPayloadMixin
- {
- public:
- wxEventAnyPayloadMixin() : wxEventBasicPayloadMixin() {}
- #if wxUSE_ANY && (!defined(__VISUALC__) || wxCHECK_VISUALC_VERSION(7))
- template<typename T>
- void SetPayload(const T& payload)
- {
- m_payload = payload;
- }
- template<typename T>
- T GetPayload() const
- {
- return m_payload.As<T>();
- }
- protected:
- wxAny m_payload;
- #endif // wxUSE_ANY && (!defined(__VISUALC__) || wxCHECK_VISUALC_VERSION(7))
- wxDECLARE_NO_ASSIGN_CLASS(wxEventBasicPayloadMixin);
- };
- // Idle event
- /*
- wxEVT_IDLE
- */
- // Whether to always send idle events to windows, or
- // to only send update events to those with the
- // wxWS_EX_PROCESS_IDLE style.
- enum wxIdleMode
- {
- // Send idle events to all windows
- wxIDLE_PROCESS_ALL,
- // Send idle events to windows that have
- // the wxWS_EX_PROCESS_IDLE flag specified
- wxIDLE_PROCESS_SPECIFIED
- };
- class WXDLLIMPEXP_BASE wxIdleEvent : public wxEvent
- {
- public:
- wxIdleEvent()
- : wxEvent(0, wxEVT_IDLE),
- m_requestMore(false)
- { }
- wxIdleEvent(const wxIdleEvent& event)
- : wxEvent(event),
- m_requestMore(event.m_requestMore)
- { }
- void RequestMore(bool needMore = true) { m_requestMore = needMore; }
- bool MoreRequested() const { return m_requestMore; }
- virtual wxEvent *Clone() const { return new wxIdleEvent(*this); }
- // Specify how wxWidgets will send idle events: to
- // all windows, or only to those which specify that they
- // will process the events.
- static void SetMode(wxIdleMode mode) { sm_idleMode = mode; }
- // Returns the idle event mode
- static wxIdleMode GetMode() { return sm_idleMode; }
- protected:
- bool m_requestMore;
- static wxIdleMode sm_idleMode;
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxIdleEvent)
- };
- // Thread event
- class WXDLLIMPEXP_BASE wxThreadEvent : public wxEvent,
- public wxEventAnyPayloadMixin
- {
- public:
- wxThreadEvent(wxEventType eventType = wxEVT_THREAD, int id = wxID_ANY)
- : wxEvent(id, eventType)
- { }
- wxThreadEvent(const wxThreadEvent& event)
- : wxEvent(event),
- wxEventAnyPayloadMixin(event)
- {
- // make sure our string member (which uses COW, aka refcounting) is not
- // shared by other wxString instances:
- SetString(GetString().Clone());
- }
- virtual wxEvent *Clone() const
- {
- return new wxThreadEvent(*this);
- }
- // this is important to avoid that calling wxEventLoopBase::YieldFor thread events
- // gets processed when this is unwanted:
- virtual wxEventCategory GetEventCategory() const
- { return wxEVT_CATEGORY_THREAD; }
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxThreadEvent)
- };
- // Asynchronous method call events: these event are processed by wxEvtHandler
- // itself and result in a call to its Execute() method which simply calls the
- // specified method. The difference with a simple method call is that this is
- // done asynchronously, i.e. at some later time, instead of immediately when
- // the event object is constructed.
- #ifdef wxHAS_CALL_AFTER
- // This is a base class used to process all method calls.
- class wxAsyncMethodCallEvent : public wxEvent
- {
- public:
- wxAsyncMethodCallEvent(wxObject* object)
- : wxEvent(wxID_ANY, wxEVT_ASYNC_METHOD_CALL)
- {
- SetEventObject(object);
- }
- wxAsyncMethodCallEvent(const wxAsyncMethodCallEvent& other)
- : wxEvent(other)
- {
- }
- virtual void Execute() = 0;
- };
- // This is a version for calling methods without parameters.
- template <typename T>
- class wxAsyncMethodCallEvent0 : public wxAsyncMethodCallEvent
- {
- public:
- typedef T ObjectType;
- typedef void (ObjectType::*MethodType)();
- wxAsyncMethodCallEvent0(ObjectType* object,
- MethodType method)
- : wxAsyncMethodCallEvent(object),
- m_object(object),
- m_method(method)
- {
- }
- wxAsyncMethodCallEvent0(const wxAsyncMethodCallEvent0& other)
- : wxAsyncMethodCallEvent(other),
- m_object(other.m_object),
- m_method(other.m_method)
- {
- }
- virtual wxEvent *Clone() const
- {
- return new wxAsyncMethodCallEvent0(*this);
- }
- virtual void Execute()
- {
- (m_object->*m_method)();
- }
- private:
- ObjectType* const m_object;
- const MethodType m_method;
- };
- // This is a version for calling methods with a single parameter.
- template <typename T, typename T1>
- class wxAsyncMethodCallEvent1 : public wxAsyncMethodCallEvent
- {
- public:
- typedef T ObjectType;
- typedef void (ObjectType::*MethodType)(T1 x1);
- typedef typename wxRemoveRef<T1>::type ParamType1;
- wxAsyncMethodCallEvent1(ObjectType* object,
- MethodType method,
- const ParamType1& x1)
- : wxAsyncMethodCallEvent(object),
- m_object(object),
- m_method(method),
- m_param1(x1)
- {
- }
- wxAsyncMethodCallEvent1(const wxAsyncMethodCallEvent1& other)
- : wxAsyncMethodCallEvent(other),
- m_object(other.m_object),
- m_method(other.m_method),
- m_param1(other.m_param1)
- {
- }
- virtual wxEvent *Clone() const
- {
- return new wxAsyncMethodCallEvent1(*this);
- }
- virtual void Execute()
- {
- (m_object->*m_method)(m_param1);
- }
- private:
- ObjectType* const m_object;
- const MethodType m_method;
- const ParamType1 m_param1;
- };
- // This is a version for calling methods with two parameters.
- template <typename T, typename T1, typename T2>
- class wxAsyncMethodCallEvent2 : public wxAsyncMethodCallEvent
- {
- public:
- typedef T ObjectType;
- typedef void (ObjectType::*MethodType)(T1 x1, T2 x2);
- typedef typename wxRemoveRef<T1>::type ParamType1;
- typedef typename wxRemoveRef<T2>::type ParamType2;
- wxAsyncMethodCallEvent2(ObjectType* object,
- MethodType method,
- const ParamType1& x1,
- const ParamType2& x2)
- : wxAsyncMethodCallEvent(object),
- m_object(object),
- m_method(method),
- m_param1(x1),
- m_param2(x2)
- {
- }
- wxAsyncMethodCallEvent2(const wxAsyncMethodCallEvent2& other)
- : wxAsyncMethodCallEvent(other),
- m_object(other.m_object),
- m_method(other.m_method),
- m_param1(other.m_param1),
- m_param2(other.m_param2)
- {
- }
- virtual wxEvent *Clone() const
- {
- return new wxAsyncMethodCallEvent2(*this);
- }
- virtual void Execute()
- {
- (m_object->*m_method)(m_param1, m_param2);
- }
- private:
- ObjectType* const m_object;
- const MethodType m_method;
- const ParamType1 m_param1;
- const ParamType2 m_param2;
- };
- // This is a version for calling any functors
- template <typename T>
- class wxAsyncMethodCallEventFunctor : public wxAsyncMethodCallEvent
- {
- public:
- typedef T FunctorType;
- wxAsyncMethodCallEventFunctor(wxObject *object, const FunctorType& fn)
- : wxAsyncMethodCallEvent(object),
- m_fn(fn)
- {
- }
- wxAsyncMethodCallEventFunctor(const wxAsyncMethodCallEventFunctor& other)
- : wxAsyncMethodCallEvent(other),
- m_fn(other.m_fn)
- {
- }
- virtual wxEvent *Clone() const
- {
- return new wxAsyncMethodCallEventFunctor(*this);
- }
- virtual void Execute()
- {
- m_fn();
- }
- private:
- FunctorType m_fn;
- };
- #endif // wxHAS_CALL_AFTER
- #if wxUSE_GUI
- // Item or menu event class
- /*
- wxEVT_BUTTON
- wxEVT_CHECKBOX
- wxEVT_CHOICE
- wxEVT_LISTBOX
- wxEVT_LISTBOX_DCLICK
- wxEVT_TEXT
- wxEVT_TEXT_ENTER
- wxEVT_MENU
- wxEVT_SLIDER
- wxEVT_RADIOBOX
- wxEVT_RADIOBUTTON
- wxEVT_SCROLLBAR
- wxEVT_VLBOX
- wxEVT_COMBOBOX
- wxEVT_TOGGLEBUTTON
- */
- class WXDLLIMPEXP_CORE wxCommandEvent : public wxEvent,
- public wxEventBasicPayloadMixin
- {
- public:
- wxCommandEvent(wxEventType commandType = wxEVT_NULL, int winid = 0);
- wxCommandEvent(const wxCommandEvent& event)
- : wxEvent(event),
- wxEventBasicPayloadMixin(event),
- m_clientData(event.m_clientData),
- m_clientObject(event.m_clientObject)
- {
- // Because GetString() can retrieve the string text only on demand, we
- // need to copy it explicitly.
- if ( m_cmdString.empty() )
- m_cmdString = event.GetString();
- }
- // Set/Get client data from controls
- void SetClientData(void* clientData) { m_clientData = clientData; }
- void *GetClientData() const { return m_clientData; }
- // Set/Get client object from controls
- void SetClientObject(wxClientData* clientObject) { m_clientObject = clientObject; }
- wxClientData *GetClientObject() const { return m_clientObject; }
- // Note: this shadows wxEventBasicPayloadMixin::GetString(), because it does some
- // GUI-specific hacks
- wxString GetString() const;
- // Get listbox selection if single-choice
- int GetSelection() const { return m_commandInt; }
- // Get checkbox value
- bool IsChecked() const { return m_commandInt != 0; }
- // true if the listbox event was a selection.
- bool IsSelection() const { return (m_extraLong != 0); }
- virtual wxEvent *Clone() const { return new wxCommandEvent(*this); }
- virtual wxEventCategory GetEventCategory() const { return wxEVT_CATEGORY_USER_INPUT; }
- protected:
- void* m_clientData; // Arbitrary client data
- wxClientData* m_clientObject; // Arbitrary client object
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxCommandEvent)
- };
- // this class adds a possibility to react (from the user) code to a control
- // notification: allow or veto the operation being reported.
- class WXDLLIMPEXP_CORE wxNotifyEvent : public wxCommandEvent
- {
- public:
- wxNotifyEvent(wxEventType commandType = wxEVT_NULL, int winid = 0)
- : wxCommandEvent(commandType, winid)
- { m_bAllow = true; }
- wxNotifyEvent(const wxNotifyEvent& event)
- : wxCommandEvent(event)
- { m_bAllow = event.m_bAllow; }
- // veto the operation (usually it's allowed by default)
- void Veto() { m_bAllow = false; }
- // allow the operation if it was disabled by default
- void Allow() { m_bAllow = true; }
- // for implementation code only: is the operation allowed?
- bool IsAllowed() const { return m_bAllow; }
- virtual wxEvent *Clone() const { return new wxNotifyEvent(*this); }
- private:
- bool m_bAllow;
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxNotifyEvent)
- };
- // Scroll event class, derived form wxCommandEvent. wxScrollEvents are
- // sent by wxSlider and wxScrollBar.
- /*
- wxEVT_SCROLL_TOP
- wxEVT_SCROLL_BOTTOM
- wxEVT_SCROLL_LINEUP
- wxEVT_SCROLL_LINEDOWN
- wxEVT_SCROLL_PAGEUP
- wxEVT_SCROLL_PAGEDOWN
- wxEVT_SCROLL_THUMBTRACK
- wxEVT_SCROLL_THUMBRELEASE
- wxEVT_SCROLL_CHANGED
- */
- class WXDLLIMPEXP_CORE wxScrollEvent : public wxCommandEvent
- {
- public:
- wxScrollEvent(wxEventType commandType = wxEVT_NULL,
- int winid = 0, int pos = 0, int orient = 0);
- int GetOrientation() const { return (int) m_extraLong; }
- int GetPosition() const { return m_commandInt; }
- void SetOrientation(int orient) { m_extraLong = (long) orient; }
- void SetPosition(int pos) { m_commandInt = pos; }
- virtual wxEvent *Clone() const { return new wxScrollEvent(*this); }
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxScrollEvent)
- };
- // ScrollWin event class, derived fom wxEvent. wxScrollWinEvents
- // are sent by wxWindow.
- /*
- wxEVT_SCROLLWIN_TOP
- wxEVT_SCROLLWIN_BOTTOM
- wxEVT_SCROLLWIN_LINEUP
- wxEVT_SCROLLWIN_LINEDOWN
- wxEVT_SCROLLWIN_PAGEUP
- wxEVT_SCROLLWIN_PAGEDOWN
- wxEVT_SCROLLWIN_THUMBTRACK
- wxEVT_SCROLLWIN_THUMBRELEASE
- */
- class WXDLLIMPEXP_CORE wxScrollWinEvent : public wxEvent
- {
- public:
- wxScrollWinEvent(wxEventType commandType = wxEVT_NULL,
- int pos = 0, int orient = 0);
- wxScrollWinEvent(const wxScrollWinEvent& event) : wxEvent(event)
- { m_commandInt = event.m_commandInt;
- m_extraLong = event.m_extraLong; }
- int GetOrientation() const { return (int) m_extraLong; }
- int GetPosition() const { return m_commandInt; }
- void SetOrientation(int orient) { m_extraLong = (long) orient; }
- void SetPosition(int pos) { m_commandInt = pos; }
- virtual wxEvent *Clone() const { return new wxScrollWinEvent(*this); }
- protected:
- int m_commandInt;
- long m_extraLong;
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxScrollWinEvent)
- };
- // Mouse event class
- /*
- wxEVT_LEFT_DOWN
- wxEVT_LEFT_UP
- wxEVT_MIDDLE_DOWN
- wxEVT_MIDDLE_UP
- wxEVT_RIGHT_DOWN
- wxEVT_RIGHT_UP
- wxEVT_MOTION
- wxEVT_ENTER_WINDOW
- wxEVT_LEAVE_WINDOW
- wxEVT_LEFT_DCLICK
- wxEVT_MIDDLE_DCLICK
- wxEVT_RIGHT_DCLICK
- */
- enum wxMouseWheelAxis
- {
- wxMOUSE_WHEEL_VERTICAL,
- wxMOUSE_WHEEL_HORIZONTAL
- };
- class WXDLLIMPEXP_CORE wxMouseEvent : public wxEvent,
- public wxMouseState
- {
- public:
- wxMouseEvent(wxEventType mouseType = wxEVT_NULL);
- wxMouseEvent(const wxMouseEvent& event)
- : wxEvent(event),
- wxMouseState(event)
- {
- Assign(event);
- }
- // Was it a button event? (*doesn't* mean: is any button *down*?)
- bool IsButton() const { return Button(wxMOUSE_BTN_ANY); }
- // Was it a down event from this (or any) button?
- bool ButtonDown(int but = wxMOUSE_BTN_ANY) const;
- // Was it a dclick event from this (or any) button?
- bool ButtonDClick(int but = wxMOUSE_BTN_ANY) const;
- // Was it a up event from this (or any) button?
- bool ButtonUp(int but = wxMOUSE_BTN_ANY) const;
- // Was this event generated by the given button?
- bool Button(int but) const;
- // Get the button which is changing state (wxMOUSE_BTN_NONE if none)
- int GetButton() const;
- // Find which event was just generated
- bool LeftDown() const { return (m_eventType == wxEVT_LEFT_DOWN); }
- bool MiddleDown() const { return (m_eventType == wxEVT_MIDDLE_DOWN); }
- bool RightDown() const { return (m_eventType == wxEVT_RIGHT_DOWN); }
- bool Aux1Down() const { return (m_eventType == wxEVT_AUX1_DOWN); }
- bool Aux2Down() const { return (m_eventType == wxEVT_AUX2_DOWN); }
- bool LeftUp() const { return (m_eventType == wxEVT_LEFT_UP); }
- bool MiddleUp() const { return (m_eventType == wxEVT_MIDDLE_UP); }
- bool RightUp() const { return (m_eventType == wxEVT_RIGHT_UP); }
- bool Aux1Up() const { return (m_eventType == wxEVT_AUX1_UP); }
- bool Aux2Up() const { return (m_eventType == wxEVT_AUX2_UP); }
- bool LeftDClick() const { return (m_eventType == wxEVT_LEFT_DCLICK); }
- bool MiddleDClick() const { return (m_eventType == wxEVT_MIDDLE_DCLICK); }
- bool RightDClick() const { return (m_eventType == wxEVT_RIGHT_DCLICK); }
- bool Aux1DClick() const { return (m_eventType == wxEVT_AUX1_DCLICK); }
- bool Aux2DClick() const { return (m_eventType == wxEVT_AUX2_DCLICK); }
- // True if a button is down and the mouse is moving
- bool Dragging() const
- {
- return (m_eventType == wxEVT_MOTION) && ButtonIsDown(wxMOUSE_BTN_ANY);
- }
- // True if the mouse is moving, and no button is down
- bool Moving() const
- {
- return (m_eventType == wxEVT_MOTION) && !ButtonIsDown(wxMOUSE_BTN_ANY);
- }
- // True if the mouse is just entering the window
- bool Entering() const { return (m_eventType == wxEVT_ENTER_WINDOW); }
- // True if the mouse is just leaving the window
- bool Leaving() const { return (m_eventType == wxEVT_LEAVE_WINDOW); }
- // Returns the number of mouse clicks associated with this event.
- int GetClickCount() const { return m_clickCount; }
- // Find the logical position of the event given the DC
- wxPoint GetLogicalPosition(const wxDC& dc) const;
- // Get wheel rotation, positive or negative indicates direction of
- // rotation. Current devices all send an event when rotation is equal to
- // +/-WheelDelta, but this allows for finer resolution devices to be
- // created in the future. Because of this you shouldn't assume that one
- // event is equal to 1 line or whatever, but you should be able to either
- // do partial line scrolling or wait until +/-WheelDelta rotation values
- // have been accumulated before scrolling.
- int GetWheelRotation() const { return m_wheelRotation; }
- // Get wheel delta, normally 120. This is the threshold for action to be
- // taken, and one such action (for example, scrolling one increment)
- // should occur for each delta.
- int GetWheelDelta() const { return m_wheelDelta; }
- // Gets the axis the wheel operation concerns; wxMOUSE_WHEEL_VERTICAL
- // (most common case) or wxMOUSE_WHEEL_HORIZONTAL (for horizontal scrolling
- // using e.g. a trackpad).
- wxMouseWheelAxis GetWheelAxis() const { return m_wheelAxis; }
- // Returns the configured number of lines (or whatever) to be scrolled per
- // wheel action. Defaults to three.
- int GetLinesPerAction() const { return m_linesPerAction; }
- // Returns the configured number of columns (or whatever) to be scrolled per
- // wheel action. Defaults to three.
- int GetColumnsPerAction() const { return m_columnsPerAction; }
- // Is the system set to do page scrolling?
- bool IsPageScroll() const { return ((unsigned int)m_linesPerAction == UINT_MAX); }
- virtual wxEvent *Clone() const { return new wxMouseEvent(*this); }
- virtual wxEventCategory GetEventCategory() const { return wxEVT_CATEGORY_USER_INPUT; }
- wxMouseEvent& operator=(const wxMouseEvent& event)
- {
- if (&event != this)
- Assign(event);
- return *this;
- }
- public:
- int m_clickCount;
- wxMouseWheelAxis m_wheelAxis;
- int m_wheelRotation;
- int m_wheelDelta;
- int m_linesPerAction;
- int m_columnsPerAction;
- protected:
- void Assign(const wxMouseEvent& evt);
- private:
- DECLARE_DYNAMIC_CLASS(wxMouseEvent)
- };
- // Cursor set event
- /*
- wxEVT_SET_CURSOR
- */
- class WXDLLIMPEXP_CORE wxSetCursorEvent : public wxEvent
- {
- public:
- wxSetCursorEvent(wxCoord x = 0, wxCoord y = 0)
- : wxEvent(0, wxEVT_SET_CURSOR),
- m_x(x), m_y(y), m_cursor()
- { }
- wxSetCursorEvent(const wxSetCursorEvent& event)
- : wxEvent(event),
- m_x(event.m_x),
- m_y(event.m_y),
- m_cursor(event.m_cursor)
- { }
- wxCoord GetX() const { return m_x; }
- wxCoord GetY() const { return m_y; }
- void SetCursor(const wxCursor& cursor) { m_cursor = cursor; }
- const wxCursor& GetCursor() const { return m_cursor; }
- bool HasCursor() const { return m_cursor.IsOk(); }
- virtual wxEvent *Clone() const { return new wxSetCursorEvent(*this); }
- private:
- wxCoord m_x, m_y;
- wxCursor m_cursor;
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxSetCursorEvent)
- };
- // Keyboard input event class
- /*
- wxEVT_CHAR
- wxEVT_CHAR_HOOK
- wxEVT_KEY_DOWN
- wxEVT_KEY_UP
- wxEVT_HOTKEY
- */
- // key categories: the bit flags for IsKeyInCategory() function
- //
- // the enum values used may change in future version of wx
- // use the named constants only, or bitwise combinations thereof
- enum wxKeyCategoryFlags
- {
- // arrow keys, on and off numeric keypads
- WXK_CATEGORY_ARROW = 1,
- // page up and page down keys, on and off numeric keypads
- WXK_CATEGORY_PAGING = 2,
- // home and end keys, on and off numeric keypads
- WXK_CATEGORY_JUMP = 4,
- // tab key, on and off numeric keypads
- WXK_CATEGORY_TAB = 8,
- // backspace and delete keys, on and off numeric keypads
- WXK_CATEGORY_CUT = 16,
- // all keys usually used for navigation
- WXK_CATEGORY_NAVIGATION = WXK_CATEGORY_ARROW |
- WXK_CATEGORY_PAGING |
- WXK_CATEGORY_JUMP
- };
- class WXDLLIMPEXP_CORE wxKeyEvent : public wxEvent,
- public wxKeyboardState
- {
- public:
- wxKeyEvent(wxEventType keyType = wxEVT_NULL);
- // Normal copy ctor and a ctor creating a new event for the same key as the
- // given one but a different event type (this is used in implementation
- // code only, do not use outside of the library).
- wxKeyEvent(const wxKeyEvent& evt);
- wxKeyEvent(wxEventType eventType, const wxKeyEvent& evt);
- // get the key code: an ASCII7 char or an element of wxKeyCode enum
- int GetKeyCode() const { return (int)m_keyCode; }
- // returns true iff this event's key code is of a certain type
- bool IsKeyInCategory(int category) const;
- #if wxUSE_UNICODE
- // get the Unicode character corresponding to this key
- wxChar GetUnicodeKey() const { return m_uniChar; }
- #endif // wxUSE_UNICODE
- // get the raw key code (platform-dependent)
- wxUint32 GetRawKeyCode() const { return m_rawCode; }
- // get the raw key flags (platform-dependent)
- wxUint32 GetRawKeyFlags() const { return m_rawFlags; }
- // Find the position of the event
- void GetPosition(wxCoord *xpos, wxCoord *ypos) const
- {
- if (xpos)
- *xpos = GetX();
- if (ypos)
- *ypos = GetY();
- }
- // This version if provided only for backwards compatiblity, don't use.
- void GetPosition(long *xpos, long *ypos) const
- {
- if (xpos)
- *xpos = GetX();
- if (ypos)
- *ypos = GetY();
- }
- wxPoint GetPosition() const
- { return wxPoint(GetX(), GetY()); }
- // Get X position
- wxCoord GetX() const;
- // Get Y position
- wxCoord GetY() const;
- // Can be called from wxEVT_CHAR_HOOK handler to allow generation of normal
- // key events even though the event had been handled (by default they would
- // not be generated in this case).
- void DoAllowNextEvent() { m_allowNext = true; }
- // Return the value of the "allow next" flag, for internal use only.
- bool IsNextEventAllowed() const { return m_allowNext; }
- virtual wxEvent *Clone() const { return new wxKeyEvent(*this); }
- virtual wxEventCategory GetEventCategory() const { return wxEVT_CATEGORY_USER_INPUT; }
- // we do need to copy wxKeyEvent sometimes (in wxTreeCtrl code, for
- // example)
- wxKeyEvent& operator=(const wxKeyEvent& evt)
- {
- if ( &evt != this )
- {
- wxEvent::operator=(evt);
- // Borland C++ 5.82 doesn't compile an explicit call to an
- // implicitly defined operator=() so need to do it this way:
- *static_cast<wxKeyboardState *>(this) = evt;
- DoAssignMembers(evt);
- }
- return *this;
- }
- public:
- // Do not use these fields directly, they are initialized on demand, so
- // call GetX() and GetY() or GetPosition() instead.
- wxCoord m_x, m_y;
- long m_keyCode;
- #if wxUSE_UNICODE
- // This contains the full Unicode character
- // in a character events in Unicode mode
- wxChar m_uniChar;
- #endif
- // these fields contain the platform-specific information about
- // key that was pressed
- wxUint32 m_rawCode;
- wxUint32 m_rawFlags;
- private:
- // Set the event to propagate if necessary, i.e. if it's of wxEVT_CHAR_HOOK
- // type. This is used by all ctors.
- void InitPropagation()
- {
- if ( m_eventType == wxEVT_CHAR_HOOK )
- m_propagationLevel = wxEVENT_PROPAGATE_MAX;
- m_allowNext = false;
- }
- // Copy only the event data present in this class, this is used by
- // AssignKeyData() and copy ctor.
- void DoAssignMembers(const wxKeyEvent& evt)
- {
- m_x = evt.m_x;
- m_y = evt.m_y;
- m_hasPosition = evt.m_hasPosition;
- m_keyCode = evt.m_keyCode;
- m_rawCode = evt.m_rawCode;
- m_rawFlags = evt.m_rawFlags;
- #if wxUSE_UNICODE
- m_uniChar = evt.m_uniChar;
- #endif
- }
- // Initialize m_x and m_y using the current mouse cursor position if
- // necessary.
- void InitPositionIfNecessary() const;
- // If this flag is true, the normal key events should still be generated
- // even if wxEVT_CHAR_HOOK had been handled. By default it is false as
- // handling wxEVT_CHAR_HOOK suppresses all the subsequent events.
- bool m_allowNext;
- // If true, m_x and m_y were already initialized. If false, try to get them
- // when they're requested.
- bool m_hasPosition;
- DECLARE_DYNAMIC_CLASS(wxKeyEvent)
- };
- // Size event class
- /*
- wxEVT_SIZE
- */
- class WXDLLIMPEXP_CORE wxSizeEvent : public wxEvent
- {
- public:
- wxSizeEvent() : wxEvent(0, wxEVT_SIZE)
- { }
- wxSizeEvent(const wxSize& sz, int winid = 0)
- : wxEvent(winid, wxEVT_SIZE),
- m_size(sz)
- { }
- wxSizeEvent(const wxSizeEvent& event)
- : wxEvent(event),
- m_size(event.m_size), m_rect(event.m_rect)
- { }
- wxSizeEvent(const wxRect& rect, int id = 0)
- : m_size(rect.GetSize()), m_rect(rect)
- { m_eventType = wxEVT_SIZING; m_id = id; }
- wxSize GetSize() const { return m_size; }
- void SetSize(wxSize size) { m_size = size; }
- wxRect GetRect() const { return m_rect; }
- void SetRect(const wxRect& rect) { m_rect = rect; }
- virtual wxEvent *Clone() const { return new wxSizeEvent(*this); }
- public:
- // For internal usage only. Will be converted to protected members.
- wxSize m_size;
- wxRect m_rect; // Used for wxEVT_SIZING
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxSizeEvent)
- };
- // Move event class
- /*
- wxEVT_MOVE
- */
- class WXDLLIMPEXP_CORE wxMoveEvent : public wxEvent
- {
- public:
- wxMoveEvent()
- : wxEvent(0, wxEVT_MOVE)
- { }
- wxMoveEvent(const wxPoint& pos, int winid = 0)
- : wxEvent(winid, wxEVT_MOVE),
- m_pos(pos)
- { }
- wxMoveEvent(const wxMoveEvent& event)
- : wxEvent(event),
- m_pos(event.m_pos)
- { }
- wxMoveEvent(const wxRect& rect, int id = 0)
- : m_pos(rect.GetPosition()), m_rect(rect)
- { m_eventType = wxEVT_MOVING; m_id = id; }
- wxPoint GetPosition() const { return m_pos; }
- void SetPosition(const wxPoint& pos) { m_pos = pos; }
- wxRect GetRect() const { return m_rect; }
- void SetRect(const wxRect& rect) { m_rect = rect; }
- virtual wxEvent *Clone() const { return new wxMoveEvent(*this); }
- protected:
- wxPoint m_pos;
- wxRect m_rect;
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxMoveEvent)
- };
- // Paint event class
- /*
- wxEVT_PAINT
- wxEVT_NC_PAINT
- */
- #if wxDEBUG_LEVEL && (defined(__WXMSW__) || defined(__WXPM__))
- #define wxHAS_PAINT_DEBUG
- // see comments in src/msw|os2/dcclient.cpp where g_isPainting is defined
- extern WXDLLIMPEXP_CORE int g_isPainting;
- #endif // debug
- class WXDLLIMPEXP_CORE wxPaintEvent : public wxEvent
- {
- public:
- wxPaintEvent(int Id = 0)
- : wxEvent(Id, wxEVT_PAINT)
- {
- #ifdef wxHAS_PAINT_DEBUG
- // set the internal flag for the duration of redrawing
- g_isPainting++;
- #endif // debug
- }
- // default copy ctor and dtor are normally fine, we only need them to keep
- // g_isPainting updated in debug build
- #ifdef wxHAS_PAINT_DEBUG
- wxPaintEvent(const wxPaintEvent& event)
- : wxEvent(event)
- {
- g_isPainting++;
- }
- virtual ~wxPaintEvent()
- {
- g_isPainting--;
- }
- #endif // debug
- virtual wxEvent *Clone() const { return new wxPaintEvent(*this); }
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxPaintEvent)
- };
- class WXDLLIMPEXP_CORE wxNcPaintEvent : public wxEvent
- {
- public:
- wxNcPaintEvent(int winid = 0)
- : wxEvent(winid, wxEVT_NC_PAINT)
- { }
- virtual wxEvent *Clone() const { return new wxNcPaintEvent(*this); }
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxNcPaintEvent)
- };
- // Erase background event class
- /*
- wxEVT_ERASE_BACKGROUND
- */
- class WXDLLIMPEXP_CORE wxEraseEvent : public wxEvent
- {
- public:
- wxEraseEvent(int Id = 0, wxDC *dc = NULL)
- : wxEvent(Id, wxEVT_ERASE_BACKGROUND),
- m_dc(dc)
- { }
- wxEraseEvent(const wxEraseEvent& event)
- : wxEvent(event),
- m_dc(event.m_dc)
- { }
- wxDC *GetDC() const { return m_dc; }
- virtual wxEvent *Clone() const { return new wxEraseEvent(*this); }
- protected:
- wxDC *m_dc;
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxEraseEvent)
- };
- // Focus event class
- /*
- wxEVT_SET_FOCUS
- wxEVT_KILL_FOCUS
- */
- class WXDLLIMPEXP_CORE wxFocusEvent : public wxEvent
- {
- public:
- wxFocusEvent(wxEventType type = wxEVT_NULL, int winid = 0)
- : wxEvent(winid, type)
- { m_win = NULL; }
- wxFocusEvent(const wxFocusEvent& event)
- : wxEvent(event)
- { m_win = event.m_win; }
- // The window associated with this event is the window which had focus
- // before for SET event and the window which will have focus for the KILL
- // one. NB: it may be NULL in both cases!
- wxWindow *GetWindow() const { return m_win; }
- void SetWindow(wxWindow *win) { m_win = win; }
- virtual wxEvent *Clone() const { return new wxFocusEvent(*this); }
- private:
- wxWindow *m_win;
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxFocusEvent)
- };
- // wxChildFocusEvent notifies the parent that a child has got the focus: unlike
- // wxFocusEvent it is propagated upwards the window chain
- class WXDLLIMPEXP_CORE wxChildFocusEvent : public wxCommandEvent
- {
- public:
- wxChildFocusEvent(wxWindow *win = NULL);
- wxWindow *GetWindow() const { return (wxWindow *)GetEventObject(); }
- virtual wxEvent *Clone() const { return new wxChildFocusEvent(*this); }
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxChildFocusEvent)
- };
- // Activate event class
- /*
- wxEVT_ACTIVATE
- wxEVT_ACTIVATE_APP
- wxEVT_HIBERNATE
- */
- class WXDLLIMPEXP_CORE wxActivateEvent : public wxEvent
- {
- public:
- // Type of activation. For now we can only detect if it was by mouse or by
- // some other method and even this is only available under wxMSW.
- enum Reason
- {
- Reason_Mouse,
- Reason_Unknown
- };
- wxActivateEvent(wxEventType type = wxEVT_NULL, bool active = true,
- int Id = 0, Reason activationReason = Reason_Unknown)
- : wxEvent(Id, type),
- m_activationReason(activationReason)
- {
- m_active = active;
- }
- wxActivateEvent(const wxActivateEvent& event)
- : wxEvent(event)
- {
- m_active = event.m_active;
- m_activationReason = event.m_activationReason;
- }
- bool GetActive() const { return m_active; }
- Reason GetActivationReason() const { return m_activationReason;}
- virtual wxEvent *Clone() const { return new wxActivateEvent(*this); }
- private:
- bool m_active;
- Reason m_activationReason;
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxActivateEvent)
- };
- // InitDialog event class
- /*
- wxEVT_INIT_DIALOG
- */
- class WXDLLIMPEXP_CORE wxInitDialogEvent : public wxEvent
- {
- public:
- wxInitDialogEvent(int Id = 0)
- : wxEvent(Id, wxEVT_INIT_DIALOG)
- { }
- virtual wxEvent *Clone() const { return new wxInitDialogEvent(*this); }
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxInitDialogEvent)
- };
- // Miscellaneous menu event class
- /*
- wxEVT_MENU_OPEN,
- wxEVT_MENU_CLOSE,
- wxEVT_MENU_HIGHLIGHT,
- */
- class WXDLLIMPEXP_CORE wxMenuEvent : public wxEvent
- {
- public:
- wxMenuEvent(wxEventType type = wxEVT_NULL, int winid = 0, wxMenu* menu = NULL)
- : wxEvent(winid, type)
- { m_menuId = winid; m_menu = menu; }
- wxMenuEvent(const wxMenuEvent& event)
- : wxEvent(event)
- { m_menuId = event.m_menuId; m_menu = event.m_menu; }
- // only for wxEVT_MENU_HIGHLIGHT
- int GetMenuId() const { return m_menuId; }
- // only for wxEVT_MENU_OPEN/CLOSE
- bool IsPopup() const { return m_menuId == wxID_ANY; }
- // only for wxEVT_MENU_OPEN/CLOSE
- wxMenu* GetMenu() const { return m_menu; }
- virtual wxEvent *Clone() const { return new wxMenuEvent(*this); }
- private:
- int m_menuId;
- wxMenu* m_menu;
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxMenuEvent)
- };
- // Window close or session close event class
- /*
- wxEVT_CLOSE_WINDOW,
- wxEVT_END_SESSION,
- wxEVT_QUERY_END_SESSION
- */
- class WXDLLIMPEXP_CORE wxCloseEvent : public wxEvent
- {
- public:
- wxCloseEvent(wxEventType type = wxEVT_NULL, int winid = 0)
- : wxEvent(winid, type),
- m_loggingOff(true),
- m_veto(false), // should be false by default
- m_canVeto(true) {}
- wxCloseEvent(const wxCloseEvent& event)
- : wxEvent(event),
- m_loggingOff(event.m_loggingOff),
- m_veto(event.m_veto),
- m_canVeto(event.m_canVeto) {}
- void SetLoggingOff(bool logOff) { m_loggingOff = logOff; }
- bool GetLoggingOff() const
- {
- // m_loggingOff flag is only used by wxEVT_[QUERY_]END_SESSION, it
- // doesn't make sense for wxEVT_CLOSE_WINDOW
- wxASSERT_MSG( m_eventType != wxEVT_CLOSE_WINDOW,
- wxT("this flag is for end session events only") );
- return m_loggingOff;
- }
- void Veto(bool veto = true)
- {
- // GetVeto() will return false anyhow...
- wxCHECK_RET( m_canVeto,
- wxT("call to Veto() ignored (can't veto this event)") );
- m_veto = veto;
- }
- void SetCanVeto(bool canVeto) { m_canVeto = canVeto; }
- bool CanVeto() const { return m_canVeto; }
- bool GetVeto() const { return m_canVeto && m_veto; }
- virtual wxEvent *Clone() const { return new wxCloseEvent(*this); }
- protected:
- bool m_loggingOff,
- m_veto,
- m_canVeto;
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxCloseEvent)
- };
- /*
- wxEVT_SHOW
- */
- class WXDLLIMPEXP_CORE wxShowEvent : public wxEvent
- {
- public:
- wxShowEvent(int winid = 0, bool show = false)
- : wxEvent(winid, wxEVT_SHOW)
- { m_show = show; }
- wxShowEvent(const wxShowEvent& event)
- : wxEvent(event)
- { m_show = event.m_show; }
- void SetShow(bool show) { m_show = show; }
- // return true if the window was shown, false if hidden
- bool IsShown() const { return m_show; }
- #if WXWIN_COMPATIBILITY_2_8
- wxDEPRECATED( bool GetShow() const { return IsShown(); } )
- #endif
- virtual wxEvent *Clone() const { return new wxShowEvent(*this); }
- protected:
- bool m_show;
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxShowEvent)
- };
- /*
- wxEVT_ICONIZE
- */
- class WXDLLIMPEXP_CORE wxIconizeEvent : public wxEvent
- {
- public:
- wxIconizeEvent(int winid = 0, bool iconized = true)
- : wxEvent(winid, wxEVT_ICONIZE)
- { m_iconized = iconized; }
- wxIconizeEvent(const wxIconizeEvent& event)
- : wxEvent(event)
- { m_iconized = event.m_iconized; }
- #if WXWIN_COMPATIBILITY_2_8
- wxDEPRECATED( bool Iconized() const { return IsIconized(); } )
- #endif
- // return true if the frame was iconized, false if restored
- bool IsIconized() const { return m_iconized; }
- virtual wxEvent *Clone() const { return new wxIconizeEvent(*this); }
- protected:
- bool m_iconized;
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxIconizeEvent)
- };
- /*
- wxEVT_MAXIMIZE
- */
- class WXDLLIMPEXP_CORE wxMaximizeEvent : public wxEvent
- {
- public:
- wxMaximizeEvent(int winid = 0)
- : wxEvent(winid, wxEVT_MAXIMIZE)
- { }
- virtual wxEvent *Clone() const { return new wxMaximizeEvent(*this); }
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxMaximizeEvent)
- };
- // Joystick event class
- /*
- wxEVT_JOY_BUTTON_DOWN,
- wxEVT_JOY_BUTTON_UP,
- wxEVT_JOY_MOVE,
- wxEVT_JOY_ZMOVE
- */
- // Which joystick? Same as Windows ids so no conversion necessary.
- enum
- {
- wxJOYSTICK1,
- wxJOYSTICK2
- };
- // Which button is down?
- enum
- {
- wxJOY_BUTTON_ANY = -1,
- wxJOY_BUTTON1 = 1,
- wxJOY_BUTTON2 = 2,
- wxJOY_BUTTON3 = 4,
- wxJOY_BUTTON4 = 8
- };
- class WXDLLIMPEXP_CORE wxJoystickEvent : public wxEvent
- {
- protected:
- wxPoint m_pos;
- int m_zPosition;
- int m_buttonChange; // Which button changed?
- int m_buttonState; // Which buttons are down?
- int m_joyStick; // Which joystick?
- public:
- wxJoystickEvent(wxEventType type = wxEVT_NULL,
- int state = 0,
- int joystick = wxJOYSTICK1,
- int change = 0)
- : wxEvent(0, type),
- m_pos(),
- m_zPosition(0),
- m_buttonChange(change),
- m_buttonState(state),
- m_joyStick(joystick)
- {
- }
- wxJoystickEvent(const wxJoystickEvent& event)
- : wxEvent(event),
- m_pos(event.m_pos),
- m_zPosition(event.m_zPosition),
- m_buttonChange(event.m_buttonChange),
- m_buttonState(event.m_buttonState),
- m_joyStick(event.m_joyStick)
- { }
- wxPoint GetPosition() const { return m_pos; }
- int GetZPosition() const { return m_zPosition; }
- int GetButtonState() const { return m_buttonState; }
- int GetButtonChange() const { return m_buttonChange; }
- int GetJoystick() const { return m_joyStick; }
- void SetJoystick(int stick) { m_joyStick = stick; }
- void SetButtonState(int state) { m_buttonState = state; }
- void SetButtonChange(int change) { m_buttonChange = change; }
- void SetPosition(const wxPoint& pos) { m_pos = pos; }
- void SetZPosition(int zPos) { m_zPosition = zPos; }
- // Was it a button event? (*doesn't* mean: is any button *down*?)
- bool IsButton() const { return ((GetEventType() == wxEVT_JOY_BUTTON_DOWN) ||
- (GetEventType() == wxEVT_JOY_BUTTON_UP)); }
- // Was it a move event?
- bool IsMove() const { return (GetEventType() == wxEVT_JOY_MOVE); }
- // Was it a zmove event?
- bool IsZMove() const { return (GetEventType() == wxEVT_JOY_ZMOVE); }
- // Was it a down event from button 1, 2, 3, 4 or any?
- bool ButtonDown(int but = wxJOY_BUTTON_ANY) const
- { return ((GetEventType() == wxEVT_JOY_BUTTON_DOWN) &&
- ((but == wxJOY_BUTTON_ANY) || (but == m_buttonChange))); }
- // Was it a up event from button 1, 2, 3 or any?
- bool ButtonUp(int but = wxJOY_BUTTON_ANY) const
- { return ((GetEventType() == wxEVT_JOY_BUTTON_UP) &&
- ((but == wxJOY_BUTTON_ANY) || (but == m_buttonChange))); }
- // Was the given button 1,2,3,4 or any in Down state?
- bool ButtonIsDown(int but = wxJOY_BUTTON_ANY) const
- { return (((but == wxJOY_BUTTON_ANY) && (m_buttonState != 0)) ||
- ((m_buttonState & but) == but)); }
- virtual wxEvent *Clone() const { return new wxJoystickEvent(*this); }
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxJoystickEvent)
- };
- // Drop files event class
- /*
- wxEVT_DROP_FILES
- */
- class WXDLLIMPEXP_CORE wxDropFilesEvent : public wxEvent
- {
- public:
- int m_noFiles;
- wxPoint m_pos;
- wxString* m_files;
- wxDropFilesEvent(wxEventType type = wxEVT_NULL,
- int noFiles = 0,
- wxString *files = NULL)
- : wxEvent(0, type),
- m_noFiles(noFiles),
- m_pos(),
- m_files(files)
- { }
- // we need a copy ctor to avoid deleting m_files pointer twice
- wxDropFilesEvent(const wxDropFilesEvent& other)
- : wxEvent(other),
- m_noFiles(other.m_noFiles),
- m_pos(other.m_pos),
- m_files(NULL)
- {
- m_files = new wxString[m_noFiles];
- for ( int n = 0; n < m_noFiles; n++ )
- {
- m_files[n] = other.m_files[n];
- }
- }
- virtual ~wxDropFilesEvent()
- {
- delete [] m_files;
- }
- wxPoint GetPosition() const { return m_pos; }
- int GetNumberOfFiles() const { return m_noFiles; }
- wxString *GetFiles() const { return m_files; }
- virtual wxEvent *Clone() const { return new wxDropFilesEvent(*this); }
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxDropFilesEvent)
- };
- // Update UI event
- /*
- wxEVT_UPDATE_UI
- */
- // Whether to always send update events to windows, or
- // to only send update events to those with the
- // wxWS_EX_PROCESS_UI_UPDATES style.
- enum wxUpdateUIMode
- {
- // Send UI update events to all windows
- wxUPDATE_UI_PROCESS_ALL,
- // Send UI update events to windows that have
- // the wxWS_EX_PROCESS_UI_UPDATES flag specified
- wxUPDATE_UI_PROCESS_SPECIFIED
- };
- class WXDLLIMPEXP_CORE wxUpdateUIEvent : public wxCommandEvent
- {
- public:
- wxUpdateUIEvent(wxWindowID commandId = 0)
- : wxCommandEvent(wxEVT_UPDATE_UI, commandId)
- {
- m_checked =
- m_enabled =
- m_shown =
- m_setEnabled =
- m_setShown =
- m_setText =
- m_setChecked = false;
- }
- wxUpdateUIEvent(const wxUpdateUIEvent& event)
- : wxCommandEvent(event),
- m_checked(event.m_checked),
- m_enabled(event.m_enabled),
- m_shown(event.m_shown),
- m_setEnabled(event.m_setEnabled),
- m_setShown(event.m_setShown),
- m_setText(event.m_setText),
- m_setChecked(event.m_setChecked),
- m_text(event.m_text)
- { }
- bool GetChecked() const { return m_checked; }
- bool GetEnabled() const { return m_enabled; }
- bool GetShown() const { return m_shown; }
- wxString GetText() const { return m_text; }
- bool GetSetText() const { return m_setText; }
- bool GetSetChecked() const { return m_setChecked; }
- bool GetSetEnabled() const { return m_setEnabled; }
- bool GetSetShown() const { return m_setShown; }
- void Check(bool check) { m_checked = check; m_setChecked = true; }
- void Enable(bool enable) { m_enabled = enable; m_setEnabled = true; }
- void Show(bool show) { m_shown = show; m_setShown = true; }
- void SetText(const wxString& text) { m_text = text; m_setText = true; }
- // Sets the interval between updates in milliseconds.
- // Set to -1 to disable updates, or to 0 to update as frequently as possible.
- static void SetUpdateInterval(long updateInterval) { sm_updateInterval = updateInterval; }
- // Returns the current interval between updates in milliseconds
- static long GetUpdateInterval() { return sm_updateInterval; }
- // Can we update this window?
- static bool CanUpdate(wxWindowBase *win);
- // Reset the update time to provide a delay until the next
- // time we should update
- static void ResetUpdateTime();
- // Specify how wxWidgets will send update events: to
- // all windows, or only to those which specify that they
- // will process the events.
- static void SetMode(wxUpdateUIMode mode) { sm_updateMode = mode; }
- // Returns the UI update mode
- static wxUpdateUIMode GetMode() { return sm_updateMode; }
- virtual wxEvent *Clone() const { return new wxUpdateUIEvent(*this); }
- protected:
- bool m_checked;
- bool m_enabled;
- bool m_shown;
- bool m_setEnabled;
- bool m_setShown;
- bool m_setText;
- bool m_setChecked;
- wxString m_text;
- #if wxUSE_LONGLONG
- static wxLongLong sm_lastUpdate;
- #endif
- static long sm_updateInterval;
- static wxUpdateUIMode sm_updateMode;
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxUpdateUIEvent)
- };
- /*
- wxEVT_SYS_COLOUR_CHANGED
- */
- // TODO: shouldn't all events record the window ID?
- class WXDLLIMPEXP_CORE wxSysColourChangedEvent : public wxEvent
- {
- public:
- wxSysColourChangedEvent()
- : wxEvent(0, wxEVT_SYS_COLOUR_CHANGED)
- { }
- virtual wxEvent *Clone() const { return new wxSysColourChangedEvent(*this); }
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxSysColourChangedEvent)
- };
- /*
- wxEVT_MOUSE_CAPTURE_CHANGED
- The window losing the capture receives this message
- (even if it released the capture itself).
- */
- class WXDLLIMPEXP_CORE wxMouseCaptureChangedEvent : public wxEvent
- {
- public:
- wxMouseCaptureChangedEvent(wxWindowID winid = 0, wxWindow* gainedCapture = NULL)
- : wxEvent(winid, wxEVT_MOUSE_CAPTURE_CHANGED),
- m_gainedCapture(gainedCapture)
- { }
- wxMouseCaptureChangedEvent(const wxMouseCaptureChangedEvent& event)
- : wxEvent(event),
- m_gainedCapture(event.m_gainedCapture)
- { }
- virtual wxEvent *Clone() const { return new wxMouseCaptureChangedEvent(*this); }
- wxWindow* GetCapturedWindow() const { return m_gainedCapture; }
- private:
- wxWindow* m_gainedCapture;
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxMouseCaptureChangedEvent)
- };
- /*
- wxEVT_MOUSE_CAPTURE_LOST
- The window losing the capture receives this message, unless it released it
- it itself or unless wxWindow::CaptureMouse was called on another window
- (and so capture will be restored when the new capturer releases it).
- */
- class WXDLLIMPEXP_CORE wxMouseCaptureLostEvent : public wxEvent
- {
- public:
- wxMouseCaptureLostEvent(wxWindowID winid = 0)
- : wxEvent(winid, wxEVT_MOUSE_CAPTURE_LOST)
- {}
- wxMouseCaptureLostEvent(const wxMouseCaptureLostEvent& event)
- : wxEvent(event)
- {}
- virtual wxEvent *Clone() const { return new wxMouseCaptureLostEvent(*this); }
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxMouseCaptureLostEvent)
- };
- /*
- wxEVT_DISPLAY_CHANGED
- */
- class WXDLLIMPEXP_CORE wxDisplayChangedEvent : public wxEvent
- {
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxDisplayChangedEvent)
- public:
- wxDisplayChangedEvent()
- : wxEvent(0, wxEVT_DISPLAY_CHANGED)
- { }
- virtual wxEvent *Clone() const { return new wxDisplayChangedEvent(*this); }
- };
- /*
- wxEVT_PALETTE_CHANGED
- */
- class WXDLLIMPEXP_CORE wxPaletteChangedEvent : public wxEvent
- {
- public:
- wxPaletteChangedEvent(wxWindowID winid = 0)
- : wxEvent(winid, wxEVT_PALETTE_CHANGED),
- m_changedWindow(NULL)
- { }
- wxPaletteChangedEvent(const wxPaletteChangedEvent& event)
- : wxEvent(event),
- m_changedWindow(event.m_changedWindow)
- { }
- void SetChangedWindow(wxWindow* win) { m_changedWindow = win; }
- wxWindow* GetChangedWindow() const { return m_changedWindow; }
- virtual wxEvent *Clone() const { return new wxPaletteChangedEvent(*this); }
- protected:
- wxWindow* m_changedWindow;
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxPaletteChangedEvent)
- };
- /*
- wxEVT_QUERY_NEW_PALETTE
- Indicates the window is getting keyboard focus and should re-do its palette.
- */
- class WXDLLIMPEXP_CORE wxQueryNewPaletteEvent : public wxEvent
- {
- public:
- wxQueryNewPaletteEvent(wxWindowID winid = 0)
- : wxEvent(winid, wxEVT_QUERY_NEW_PALETTE),
- m_paletteRealized(false)
- { }
- wxQueryNewPaletteEvent(const wxQueryNewPaletteEvent& event)
- : wxEvent(event),
- m_paletteRealized(event.m_paletteRealized)
- { }
- // App sets this if it changes the palette.
- void SetPaletteRealized(bool realized) { m_paletteRealized = realized; }
- bool GetPaletteRealized() const { return m_paletteRealized; }
- virtual wxEvent *Clone() const { return new wxQueryNewPaletteEvent(*this); }
- protected:
- bool m_paletteRealized;
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxQueryNewPaletteEvent)
- };
- /*
- Event generated by dialog navigation keys
- wxEVT_NAVIGATION_KEY
- */
- // NB: don't derive from command event to avoid being propagated to the parent
- class WXDLLIMPEXP_CORE wxNavigationKeyEvent : public wxEvent
- {
- public:
- wxNavigationKeyEvent()
- : wxEvent(0, wxEVT_NAVIGATION_KEY),
- m_flags(IsForward | FromTab), // defaults are for TAB
- m_focus(NULL)
- {
- m_propagationLevel = wxEVENT_PROPAGATE_NONE;
- }
- wxNavigationKeyEvent(const wxNavigationKeyEvent& event)
- : wxEvent(event),
- m_flags(event.m_flags),
- m_focus(event.m_focus)
- { }
- // direction: forward (true) or backward (false)
- bool GetDirection() const
- { return (m_flags & IsForward) != 0; }
- void SetDirection(bool bForward)
- { if ( bForward ) m_flags |= IsForward; else m_flags &= ~IsForward; }
- // it may be a window change event (MDI, notebook pages...) or a control
- // change event
- bool IsWindowChange() const
- { return (m_flags & WinChange) != 0; }
- void SetWindowChange(bool bIs)
- { if ( bIs ) m_flags |= WinChange; else m_flags &= ~WinChange; }
- // Set to true under MSW if the event was generated using the tab key.
- // This is required for proper navogation over radio buttons
- bool IsFromTab() const
- { return (m_flags & FromTab) != 0; }
- void SetFromTab(bool bIs)
- { if ( bIs ) m_flags |= FromTab; else m_flags &= ~FromTab; }
- // the child which has the focus currently (may be NULL - use
- // wxWindow::FindFocus then)
- wxWindow* GetCurrentFocus() const { return m_focus; }
- void SetCurrentFocus(wxWindow *win) { m_focus = win; }
- // Set flags
- void SetFlags(long flags) { m_flags = flags; }
- virtual wxEvent *Clone() const { return new wxNavigationKeyEvent(*this); }
- enum wxNavigationKeyEventFlags
- {
- IsBackward = 0x0000,
- IsForward = 0x0001,
- WinChange = 0x0002,
- FromTab = 0x0004
- };
- long m_flags;
- wxWindow *m_focus;
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxNavigationKeyEvent)
- };
- // Window creation/destruction events: the first is sent as soon as window is
- // created (i.e. the underlying GUI object exists), but when the C++ object is
- // fully initialized (so virtual functions may be called). The second,
- // wxEVT_DESTROY, is sent right before the window is destroyed - again, it's
- // still safe to call virtual functions at this moment
- /*
- wxEVT_CREATE
- wxEVT_DESTROY
- */
- class WXDLLIMPEXP_CORE wxWindowCreateEvent : public wxCommandEvent
- {
- public:
- wxWindowCreateEvent(wxWindow *win = NULL);
- wxWindow *GetWindow() const { return (wxWindow *)GetEventObject(); }
- virtual wxEvent *Clone() const { return new wxWindowCreateEvent(*this); }
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxWindowCreateEvent)
- };
- class WXDLLIMPEXP_CORE wxWindowDestroyEvent : public wxCommandEvent
- {
- public:
- wxWindowDestroyEvent(wxWindow *win = NULL);
- wxWindow *GetWindow() const { return (wxWindow *)GetEventObject(); }
- virtual wxEvent *Clone() const { return new wxWindowDestroyEvent(*this); }
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxWindowDestroyEvent)
- };
- // A help event is sent when the user clicks on a window in context-help mode.
- /*
- wxEVT_HELP
- wxEVT_DETAILED_HELP
- */
- class WXDLLIMPEXP_CORE wxHelpEvent : public wxCommandEvent
- {
- public:
- // how was this help event generated?
- enum Origin
- {
- Origin_Unknown, // unrecognized event source
- Origin_Keyboard, // event generated from F1 key press
- Origin_HelpButton // event from [?] button on the title bar (Windows)
- };
- wxHelpEvent(wxEventType type = wxEVT_NULL,
- wxWindowID winid = 0,
- const wxPoint& pt = wxDefaultPosition,
- Origin origin = Origin_Unknown)
- : wxCommandEvent(type, winid),
- m_pos(pt),
- m_origin(GuessOrigin(origin))
- { }
- wxHelpEvent(const wxHelpEvent& event)
- : wxCommandEvent(event),
- m_pos(event.m_pos),
- m_target(event.m_target),
- m_link(event.m_link),
- m_origin(event.m_origin)
- { }
- // Position of event (in screen coordinates)
- const wxPoint& GetPosition() const { return m_pos; }
- void SetPosition(const wxPoint& pos) { m_pos = pos; }
- // Optional link to further help
- const wxString& GetLink() const { return m_link; }
- void SetLink(const wxString& link) { m_link = link; }
- // Optional target to display help in. E.g. a window specification
- const wxString& GetTarget() const { return m_target; }
- void SetTarget(const wxString& target) { m_target = target; }
- virtual wxEvent *Clone() const { return new wxHelpEvent(*this); }
- // optional indication of the event source
- Origin GetOrigin() const { return m_origin; }
- void SetOrigin(Origin origin) { m_origin = origin; }
- protected:
- wxPoint m_pos;
- wxString m_target;
- wxString m_link;
- Origin m_origin;
- // we can try to guess the event origin ourselves, even if none is
- // specified in the ctor
- static Origin GuessOrigin(Origin origin);
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxHelpEvent)
- };
- // A Clipboard Text event is sent when a window intercepts text copy/cut/paste
- // message, i.e. the user has cut/copied/pasted data from/into a text control
- // via ctrl-C/X/V, ctrl/shift-del/insert, a popup menu command, etc.
- // NOTE : under windows these events are *NOT* generated automatically
- // for a Rich Edit text control.
- /*
- wxEVT_TEXT_COPY
- wxEVT_TEXT_CUT
- wxEVT_TEXT_PASTE
- */
- class WXDLLIMPEXP_CORE wxClipboardTextEvent : public wxCommandEvent
- {
- public:
- wxClipboardTextEvent(wxEventType type = wxEVT_NULL,
- wxWindowID winid = 0)
- : wxCommandEvent(type, winid)
- { }
- wxClipboardTextEvent(const wxClipboardTextEvent& event)
- : wxCommandEvent(event)
- { }
- virtual wxEvent *Clone() const { return new wxClipboardTextEvent(*this); }
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxClipboardTextEvent)
- };
- // A Context event is sent when the user right clicks on a window or
- // presses Shift-F10
- // NOTE : Under windows this is a repackaged WM_CONTETXMENU message
- // Under other systems it may have to be generated from a right click event
- /*
- wxEVT_CONTEXT_MENU
- */
- class WXDLLIMPEXP_CORE wxContextMenuEvent : public wxCommandEvent
- {
- public:
- wxContextMenuEvent(wxEventType type = wxEVT_NULL,
- wxWindowID winid = 0,
- const wxPoint& pt = wxDefaultPosition)
- : wxCommandEvent(type, winid),
- m_pos(pt)
- { }
- wxContextMenuEvent(const wxContextMenuEvent& event)
- : wxCommandEvent(event),
- m_pos(event.m_pos)
- { }
- // Position of event (in screen coordinates)
- const wxPoint& GetPosition() const { return m_pos; }
- void SetPosition(const wxPoint& pos) { m_pos = pos; }
- virtual wxEvent *Clone() const { return new wxContextMenuEvent(*this); }
- protected:
- wxPoint m_pos;
- private:
- DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxContextMenuEvent)
- };
- /* TODO
- wxEVT_MOUSE_CAPTURE_CHANGED,
- wxEVT_SETTING_CHANGED, // WM_WININICHANGE (NT) / WM_SETTINGCHANGE (Win95)
- // wxEVT_FONT_CHANGED, // WM_FONTCHANGE: roll into wxEVT_SETTING_CHANGED, but remember to propagate
- // wxEVT_FONT_CHANGED to all other windows (maybe).
- wxEVT_DRAW_ITEM, // Leave these three as virtual functions in wxControl?? Platform-specific.
- wxEVT_MEASURE_ITEM,
- wxEVT_COMPARE_ITEM
- */
- #endif // wxUSE_GUI
- // ============================================================================
- // event handler and related classes
- // ============================================================================
- // struct containing the members common to static and dynamic event tables
- // entries
- struct WXDLLIMPEXP_BASE wxEventTableEntryBase
- {
- wxEventTableEntryBase(int winid, int idLast,
- wxEventFunctor* fn, wxObject *data)
- : m_id(winid),
- m_lastId(idLast),
- m_fn(fn),
- m_callbackUserData(data)
- {
- wxASSERT_MSG( idLast == wxID_ANY || winid <= idLast,
- "invalid IDs range: lower bound > upper bound" );
- }
- wxEventTableEntryBase( const wxEventTableEntryBase &entry )
- : m_id( entry.m_id ),
- m_lastId( entry.m_lastId ),
- m_fn( entry.m_fn ),
- m_callbackUserData( entry.m_callbackUserData )
- {
- // This is a 'hack' to ensure that only one instance tries to delete
- // the functor pointer. It is safe as long as the only place where the
- // copy constructor is being called is when the static event tables are
- // being initialized (a temporary instance is created and then this
- // constructor is called).
- const_cast<wxEventTableEntryBase&>( entry ).m_fn = NULL;
- }
- ~wxEventTableEntryBase()
- {
- delete m_fn;
- }
- // the range of ids for this entry: if m_lastId == wxID_ANY, the range
- // consists only of m_id, otherwise it is m_id..m_lastId inclusive
- int m_id,
- m_lastId;
- // function/method/functor to call
- wxEventFunctor* m_fn;
- // arbitrary user data associated with the callback
- wxObject* m_callbackUserData;
- private:
- wxDECLARE_NO_ASSIGN_CLASS(wxEventTableEntryBase);
- };
- // an entry from a static event table
- struct WXDLLIMPEXP_BASE wxEventTableEntry : public wxEventTableEntryBase
- {
- wxEventTableEntry(const int& evType, int winid, int idLast,
- wxEventFunctor* fn, wxObject *data)
- : wxEventTableEntryBase(winid, idLast, fn, data),
- m_eventType(evType)
- { }
- // the reference to event type: this allows us to not care about the
- // (undefined) order in which the event table entries and the event types
- // are initialized: initially the value of this reference might be
- // invalid, but by the time it is used for the first time, all global
- // objects will have been initialized (including the event type constants)
- // and so it will have the correct value when it is needed
- const int& m_eventType;
- private:
- wxDECLARE_NO_ASSIGN_CLASS(wxEventTableEntry);
- };
- // an entry used in dynamic event table managed by wxEvtHandler::Connect()
- struct WXDLLIMPEXP_BASE wxDynamicEventTableEntry : public wxEventTableEntryBase
- {
- wxDynamicEventTableEntry(int evType, int winid, int idLast,
- wxEventFunctor* fn, wxObject *data)
- : wxEventTableEntryBase(winid, idLast, fn, data),
- m_eventType(evType)
- { }
- // not a reference here as we can't keep a reference to a temporary int
- // created to wrap the constant value typically passed to Connect() - nor
- // do we need it
- int m_eventType;
- private:
- wxDECLARE_NO_ASSIGN_CLASS(wxDynamicEventTableEntry);
- };
- // ----------------------------------------------------------------------------
- // wxEventTable: an array of event entries terminated with {0, 0, 0, 0, 0}
- // ----------------------------------------------------------------------------
- struct WXDLLIMPEXP_BASE wxEventTable
- {
- const wxEventTable *baseTable; // base event table (next in chain)
- const wxEventTableEntry *entries; // bottom of entry array
- };
- // ----------------------------------------------------------------------------
- // wxEventHashTable: a helper of wxEvtHandler to speed up wxEventTable lookups.
- // ----------------------------------------------------------------------------
- WX_DEFINE_ARRAY_PTR(const wxEventTableEntry*, wxEventTableEntryPointerArray);
- class WXDLLIMPEXP_BASE wxEventHashTable
- {
- private:
- // Internal data structs
- struct EventTypeTable
- {
- wxEventType eventType;
- wxEventTableEntryPointerArray eventEntryTable;
- };
- typedef EventTypeTable* EventTypeTablePointer;
- public:
- // Constructor, needs the event table it needs to hash later on.
- // Note: hashing of the event table is not done in the constructor as it
- // can be that the event table is not yet full initialize, the hash
- // will gets initialized when handling the first event look-up request.
- wxEventHashTable(const wxEventTable &table);
- // Destructor.
- ~wxEventHashTable();
- // Handle the given event, in other words search the event table hash
- // and call self->ProcessEvent() if a match was found.
- bool HandleEvent(wxEvent& event, wxEvtHandler *self);
- // Clear table
- void Clear();
- #if wxUSE_MEMORY_TRACING
- // Clear all tables: only used to work around problems in memory tracing
- // code
- static void ClearAll();
- #endif // wxUSE_MEMORY_TRACING
- protected:
- // Init the hash table with the entries of the static event table.
- void InitHashTable();
- // Helper function of InitHashTable() to insert 1 entry into the hash table.
- void AddEntry(const wxEventTableEntry &entry);
- // Allocate and init with null pointers the base hash table.
- void AllocEventTypeTable(size_t size);
- // Grow the hash table in size and transfer all items currently
- // in the table to the correct location in the new table.
- void GrowEventTypeTable();
- protected:
- const wxEventTable &m_table;
- bool m_rebuildHash;
- size_t m_size;
- EventTypeTablePointer *m_eventTypeTable;
- static wxEventHashTable* sm_first;
- wxEventHashTable* m_previous;
- wxEventHashTable* m_next;
- wxDECLARE_NO_COPY_CLASS(wxEventHashTable);
- };
- // ----------------------------------------------------------------------------
- // wxEvtHandler: the base class for all objects handling wxWidgets events
- // ----------------------------------------------------------------------------
- class WXDLLIMPEXP_BASE wxEvtHandler : public wxObject
- , public wxTrackable
- {
- public:
- wxEvtHandler();
- virtual ~wxEvtHandler();
- // Event handler chain
- // -------------------
- wxEvtHandler *GetNextHandler() const { return m_nextHandler; }
- wxEvtHandler *GetPreviousHandler() const { return m_previousHandler; }
- virtual void SetNextHandler(wxEvtHandler *handler) { m_nextHandler = handler; }
- virtual void SetPreviousHandler(wxEvtHandler *handler) { m_previousHandler = handler; }
- void SetEvtHandlerEnabled(bool enabled) { m_enabled = enabled; }
- bool GetEvtHandlerEnabled() const { return m_enabled; }
- void Unlink();
- bool IsUnlinked() const;
- // Global event filters
- // --------------------
- // Add an event filter whose FilterEvent() method will be called for each
- // and every event processed by wxWidgets. The filters are called in LIFO
- // order and wxApp is registered as an event filter by default. The pointer
- // must remain valid until it's removed with RemoveFilter() and is not
- // deleted by wxEvtHandler.
- static void AddFilter(wxEventFilter* filter);
- // Remove a filter previously installed with AddFilter().
- static void RemoveFilter(wxEventFilter* filter);
- // Event queuing and processing
- // ----------------------------
- // Process an event right now: this can only be called from the main
- // thread, use QueueEvent() for scheduling the events for
- // processing from other threads.
- virtual bool ProcessEvent(wxEvent& event);
- // Process an event by calling ProcessEvent and handling any exceptions
- // thrown by event handlers. It's mostly useful when processing wx events
- // when called from C code (e.g. in GTK+ callback) when the exception
- // wouldn't correctly propagate to wxEventLoop.
- bool SafelyProcessEvent(wxEvent& event);
- // NOTE: uses ProcessEvent()
- // This method tries to process the event in this event handler, including
- // any preprocessing done by TryBefore() and all the handlers chained to
- // it, but excluding the post-processing done in TryAfter().
- //
- // It is meant to be called from ProcessEvent() only and is not virtual,
- // additional event handlers can be hooked into the normal event processing
- // logic using TryBefore() and TryAfter() hooks.
- //
- // You can also call it yourself to forward an event to another handler but
- // without propagating it upwards if it's unhandled (this is usually
- // unwanted when forwarding as the original handler would already do it if
- // needed normally).
- bool ProcessEventLocally(wxEvent& event);
- // Schedule the given event to be processed later. It takes ownership of
- // the event pointer, i.e. it will be deleted later. This is safe to call
- // from multiple threads although you still need to ensure that wxString
- // fields of the event object are deep copies and not use the same string
- // buffer as other wxString objects in this thread.
- virtual void QueueEvent(wxEvent *event);
- // Add an event to be processed later: notice that this function is not
- // safe to call from threads other than main, use QueueEvent()
- virtual void AddPendingEvent(const wxEvent& event)
- {
- // notice that the thread-safety problem comes from the fact that
- // Clone() doesn't make deep copies of wxString fields of wxEvent
- // object and so the same wxString could be used from both threads when
- // the event object is destroyed in this one -- QueueEvent() avoids
- // this problem as the event pointer is not used any more in this
- // thread at all after it is called.
- QueueEvent(event.Clone());
- }
- void ProcessPendingEvents();
- // NOTE: uses ProcessEvent()
- void DeletePendingEvents();
- #if wxUSE_THREADS
- bool ProcessThreadEvent(const wxEvent& event);
- // NOTE: uses AddPendingEvent(); call only from secondary threads
- #endif
- #ifdef wxHAS_CALL_AFTER
- // Asynchronous method calls: these methods schedule the given method
- // pointer for a later call (during the next idle event loop iteration).
- //
- // Notice that the method is called on this object itself, so the object
- // CallAfter() is called on must have the correct dynamic type.
- //
- // These method can be used from another thread.
- template <typename T>
- void CallAfter(void (T::*method)())
- {
- QueueEvent(
- new wxAsyncMethodCallEvent0<T>(static_cast<T*>(this), method)
- );
- }
- // Notice that we use P1 and not T1 for the parameter to allow passing
- // parameters that are convertible to the type taken by the method
- // instead of being exactly the same, to be closer to the usual method call
- // semantics.
- template <typename T, typename T1, typename P1>
- void CallAfter(void (T::*method)(T1 x1), P1 x1)
- {
- QueueEvent(
- new wxAsyncMethodCallEvent1<T, T1>(
- static_cast<T*>(this), method, x1)
- );
- }
- template <typename T, typename T1, typename T2, typename P1, typename P2>
- void CallAfter(void (T::*method)(T1 x1, T2 x2), P1 x1, P2 x2)
- {
- QueueEvent(
- new wxAsyncMethodCallEvent2<T, T1, T2>(
- static_cast<T*>(this), method, x1, x2)
- );
- }
- template <typename T>
- void CallAfter(const T& fn)
- {
- QueueEvent(new wxAsyncMethodCallEventFunctor<T>(this, fn));
- }
- #endif // wxHAS_CALL_AFTER
- // Connecting and disconnecting
- // ----------------------------
- // These functions are used for old, untyped, event handlers and don't
- // check that the type of the function passed to them actually matches the
- // type of the event. They also only allow connecting events to methods of
- // wxEvtHandler-derived classes.
- //
- // The template Connect() methods below are safer and allow connecting
- // events to arbitrary functions or functors -- but require compiler
- // support for templates.
- // Dynamic association of a member function handler with the event handler,
- // winid and event type
- void Connect(int winid,
- int lastId,
- wxEventType eventType,
- wxObjectEventFunction func,
- wxObject *userData = NULL,
- wxEvtHandler *eventSink = NULL)
- {
- DoBind(winid, lastId, eventType,
- wxNewEventFunctor(eventType, func, eventSink),
- userData);
- }
- // Convenience function: take just one id
- void Connect(int winid,
- wxEventType eventType,
- wxObjectEventFunction func,
- wxObject *userData = NULL,
- wxEvtHandler *eventSink = NULL)
- { Connect(winid, wxID_ANY, eventType, func, userData, eventSink); }
- // Even more convenient: without id (same as using id of wxID_ANY)
- void Connect(wxEventType eventType,
- wxObjectEventFunction func,
- wxObject *userData = NULL,
- wxEvtHandler *eventSink = NULL)
- { Connect(wxID_ANY, wxID_ANY, eventType, func, userData, eventSink); }
- bool Disconnect(int winid,
- int lastId,
- wxEventType eventType,
- wxObjectEventFunction func = NULL,
- wxObject *userData = NULL,
- wxEvtHandler *eventSink = NULL)
- {
- return DoUnbind(winid, lastId, eventType,
- wxMakeEventFunctor(eventType, func, eventSink),
- userData );
- }
- bool Disconnect(int winid = wxID_ANY,
- wxEventType eventType = wxEVT_NULL,
- wxObjectEventFunction func = NULL,
- wxObject *userData = NULL,
- wxEvtHandler *eventSink = NULL)
- { return Disconnect(winid, wxID_ANY, eventType, func, userData, eventSink); }
- bool Disconnect(wxEventType eventType,
- wxObjectEventFunction func,
- wxObject *userData = NULL,
- wxEvtHandler *eventSink = NULL)
- { return Disconnect(wxID_ANY, eventType, func, userData, eventSink); }
- #ifdef wxHAS_EVENT_BIND
- // Bind functions to an event:
- template <typename EventTag, typename EventArg>
- void Bind(const EventTag& eventType,
- void (*function)(EventArg &),
- int winid = wxID_ANY,
- int lastId = wxID_ANY,
- wxObject *userData = NULL)
- {
- DoBind(winid, lastId, eventType,
- wxNewEventFunctor(eventType, function),
- userData);
- }
- template <typename EventTag, typename EventArg>
- bool Unbind(const EventTag& eventType,
- void (*function)(EventArg &),
- int winid = wxID_ANY,
- int lastId = wxID_ANY,
- wxObject *userData = NULL)
- {
- return DoUnbind(winid, lastId, eventType,
- wxMakeEventFunctor(eventType, function),
- userData);
- }
- // Bind functors to an event:
- template <typename EventTag, typename Functor>
- void Bind(const EventTag& eventType,
- const Functor &functor,
- int winid = wxID_ANY,
- int lastId = wxID_ANY,
- wxObject *userData = NULL)
- {
- DoBind(winid, lastId, eventType,
- wxNewEventFunctor(eventType, functor),
- userData);
- }
- template <typename EventTag, typename Functor>
- bool Unbind(const EventTag& eventType,
- const Functor &functor,
- int winid = wxID_ANY,
- int lastId = wxID_ANY,
- wxObject *userData = NULL)
- {
- return DoUnbind(winid, lastId, eventType,
- wxMakeEventFunctor(eventType, functor),
- userData);
- }
- // Bind a method of a class (called on the specified handler which must
- // be convertible to this class) object to an event:
- template <typename EventTag, typename Class, typename EventArg, typename EventHandler>
- void Bind(const EventTag &eventType,
- void (Class::*method)(EventArg &),
- EventHandler *handler,
- int winid = wxID_ANY,
- int lastId = wxID_ANY,
- wxObject *userData = NULL)
- {
- DoBind(winid, lastId, eventType,
- wxNewEventFunctor(eventType, method, handler),
- userData);
- }
- template <typename EventTag, typename Class, typename EventArg, typename EventHandler>
- bool Unbind(const EventTag &eventType,
- void (Class::*method)(EventArg&),
- EventHandler *handler,
- int winid = wxID_ANY,
- int lastId = wxID_ANY,
- wxObject *userData = NULL )
- {
- return DoUnbind(winid, lastId, eventType,
- wxMakeEventFunctor(eventType, method, handler),
- userData);
- }
- #endif // wxHAS_EVENT_BIND
- wxList* GetDynamicEventTable() const { return m_dynamicEvents ; }
- // User data can be associated with each wxEvtHandler
- void SetClientObject( wxClientData *data ) { DoSetClientObject(data); }
- wxClientData *GetClientObject() const { return DoGetClientObject(); }
- void SetClientData( void *data ) { DoSetClientData(data); }
- void *GetClientData() const { return DoGetClientData(); }
- // implementation from now on
- // --------------------------
- // check if the given event table entry matches this event by id (the check
- // for the event type should be done by caller) and call the handler if it
- // does
- //
- // return true if the event was processed, false otherwise (no match or the
- // handler decided to skip the event)
- static bool ProcessEventIfMatchesId(const wxEventTableEntryBase& tableEntry,
- wxEvtHandler *handler,
- wxEvent& event);
- virtual bool SearchEventTable(wxEventTable& table, wxEvent& event);
- bool SearchDynamicEventTable( wxEvent& event );
- // Avoid problems at exit by cleaning up static hash table gracefully
- void ClearEventHashTable() { GetEventHashTable().Clear(); }
- void OnSinkDestroyed( wxEvtHandler *sink );
- private:
- void DoBind(int winid,
- int lastId,
- wxEventType eventType,
- wxEventFunctor *func,
- wxObject* userData = NULL);
- bool DoUnbind(int winid,
- int lastId,
- wxEventType eventType,
- const wxEventFunctor& func,
- wxObject *userData = NULL);
- static const wxEventTableEntry sm_eventTableEntries[];
- protected:
- // hooks for wxWindow used by ProcessEvent()
- // -----------------------------------------
- // this one is called before trying our own event table to allow plugging
- // in the event handlers overriding the default logic, this is used by e.g.
- // validators.
- virtual bool TryBefore(wxEvent& event);
- // This one is not a hook but just a helper which looks up the handler in
- // this object itself.
- //
- // It is called from ProcessEventLocally() and normally shouldn't be called
- // directly as doing it would ignore any chained event handlers
- bool TryHereOnly(wxEvent& event);
- // Another helper which simply calls pre-processing hook and then tries to
- // handle the event at this handler level.
- bool TryBeforeAndHere(wxEvent& event)
- {
- return TryBefore(event) || TryHereOnly(event);
- }
- // this one is called after failing to find the event handle in our own
- // table to give a chance to the other windows to process it
- //
- // base class implementation passes the event to wxTheApp
- virtual bool TryAfter(wxEvent& event);
- #if WXWIN_COMPATIBILITY_2_8
- // deprecated method: override TryBefore() instead of this one
- wxDEPRECATED_BUT_USED_INTERNALLY_INLINE(
- virtual bool TryValidator(wxEvent& WXUNUSED(event)), return false; )
- wxDEPRECATED_BUT_USED_INTERNALLY_INLINE(
- virtual bool TryParent(wxEvent& event), return DoTryApp(event); )
- #endif // WXWIN_COMPATIBILITY_2_8
- static const wxEventTable sm_eventTable;
- virtual const wxEventTable *GetEventTable() const;
- static wxEventHashTable sm_eventHashTable;
- virtual wxEventHashTable& GetEventHashTable() const;
- wxEvtHandler* m_nextHandler;
- wxEvtHandler* m_previousHandler;
- wxList* m_dynamicEvents;
- wxList* m_pendingEvents;
- #if wxUSE_THREADS
- // critical section protecting m_pendingEvents
- wxCriticalSection m_pendingEventsLock;
- #endif // wxUSE_THREADS
- // Is event handler enabled?
- bool m_enabled;
- // The user data: either an object which will be deleted by the container
- // when it's deleted or some raw pointer which we do nothing with - only
- // one type of data can be used with the given window (i.e. you cannot set
- // the void data and then associate the container with wxClientData or vice
- // versa)
- union
- {
- wxClientData *m_clientObject;
- void *m_clientData;
- };
- // what kind of data do we have?
- wxClientDataType m_clientDataType;
- // client data accessors
- virtual void DoSetClientObject( wxClientData *data );
- virtual wxClientData *DoGetClientObject() const;
- virtual void DoSetClientData( void *data );
- virtual void *DoGetClientData() const;
- // Search tracker objects for event connection with this sink
- wxEventConnectionRef *FindRefInTrackerList(wxEvtHandler *handler);
- private:
- // pass the event to wxTheApp instance, called from TryAfter()
- bool DoTryApp(wxEvent& event);
- // try to process events in all handlers chained to this one
- bool DoTryChain(wxEvent& event);
- // Head of the event filter linked list.
- static wxEventFilter* ms_filterList;
- DECLARE_DYNAMIC_CLASS_NO_COPY(wxEvtHandler)
- };
- WX_DEFINE_ARRAY_WITH_DECL_PTR(wxEvtHandler *, wxEvtHandlerArray, class WXDLLIMPEXP_BASE);
- // Define an inline method of wxObjectEventFunctor which couldn't be defined
- // before wxEvtHandler declaration: at least Sun CC refuses to compile function
- // calls through pointer to member for forward-declared classes (see #12452).
- inline void wxObjectEventFunctor::operator()(wxEvtHandler *handler, wxEvent& event)
- {
- wxEvtHandler * const realHandler = m_handler ? m_handler : handler;
- (realHandler->*m_method)(event);
- }
- // ----------------------------------------------------------------------------
- // wxEventConnectionRef represents all connections between two event handlers
- // and enables automatic disconnect when an event handler sink goes out of
- // scope. Each connection/disconnect increases/decreases ref count, and
- // when it reaches zero the node goes out of scope.
- // ----------------------------------------------------------------------------
- class wxEventConnectionRef : public wxTrackerNode
- {
- public:
- wxEventConnectionRef() : m_src(NULL), m_sink(NULL), m_refCount(0) { }
- wxEventConnectionRef(wxEvtHandler *src, wxEvtHandler *sink)
- : m_src(src), m_sink(sink), m_refCount(1)
- {
- m_sink->AddNode(this);
- }
- // The sink is being destroyed
- virtual void OnObjectDestroy( )
- {
- if ( m_src )
- m_src->OnSinkDestroyed( m_sink );
- delete this;
- }
- virtual wxEventConnectionRef *ToEventConnection() { return this; }
- void IncRef() { m_refCount++; }
- void DecRef()
- {
- if ( !--m_refCount )
- {
- // The sink holds the only external pointer to this object
- if ( m_sink )
- m_sink->RemoveNode(this);
- delete this;
- }
- }
- private:
- wxEvtHandler *m_src,
- *m_sink;
- int m_refCount;
- friend class wxEvtHandler;
- wxDECLARE_NO_ASSIGN_CLASS(wxEventConnectionRef);
- };
- // Post a message to the given event handler which will be processed during the
- // next event loop iteration.
- //
- // Notice that this one is not thread-safe, use wxQueueEvent()
- inline void wxPostEvent(wxEvtHandler *dest, const wxEvent& event)
- {
- wxCHECK_RET( dest, "need an object to post event to" );
- dest->AddPendingEvent(event);
- }
- // Wrapper around wxEvtHandler::QueueEvent(): adds an event for later
- // processing, unlike wxPostEvent it is safe to use from different thread even
- // for events with wxString members
- inline void wxQueueEvent(wxEvtHandler *dest, wxEvent *event)
- {
- wxCHECK_RET( dest, "need an object to queue event for" );
- dest->QueueEvent(event);
- }
- typedef void (wxEvtHandler::*wxEventFunction)(wxEvent&);
- typedef void (wxEvtHandler::*wxIdleEventFunction)(wxIdleEvent&);
- typedef void (wxEvtHandler::*wxThreadEventFunction)(wxThreadEvent&);
- #define wxEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxEventFunction, func)
- #define wxIdleEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxIdleEventFunction, func)
- #define wxThreadEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxThreadEventFunction, func)
- #if wxUSE_GUI
- // ----------------------------------------------------------------------------
- // wxEventBlocker: helper class to temporarily disable event handling for a window
- // ----------------------------------------------------------------------------
- class WXDLLIMPEXP_CORE wxEventBlocker : public wxEvtHandler
- {
- public:
- wxEventBlocker(wxWindow *win, wxEventType type = wxEVT_ANY);
- virtual ~wxEventBlocker();
- void Block(wxEventType type)
- {
- m_eventsToBlock.push_back(type);
- }
- virtual bool ProcessEvent(wxEvent& event);
- protected:
- wxArrayInt m_eventsToBlock;
- wxWindow *m_window;
- wxDECLARE_NO_COPY_CLASS(wxEventBlocker);
- };
- typedef void (wxEvtHandler::*wxCommandEventFunction)(wxCommandEvent&);
- typedef void (wxEvtHandler::*wxScrollEventFunction)(wxScrollEvent&);
- typedef void (wxEvtHandler::*wxScrollWinEventFunction)(wxScrollWinEvent&);
- typedef void (wxEvtHandler::*wxSizeEventFunction)(wxSizeEvent&);
- typedef void (wxEvtHandler::*wxMoveEventFunction)(wxMoveEvent&);
- typedef void (wxEvtHandler::*wxPaintEventFunction)(wxPaintEvent&);
- typedef void (wxEvtHandler::*wxNcPaintEventFunction)(wxNcPaintEvent&);
- typedef void (wxEvtHandler::*wxEraseEventFunction)(wxEraseEvent&);
- typedef void (wxEvtHandler::*wxMouseEventFunction)(wxMouseEvent&);
- typedef void (wxEvtHandler::*wxCharEventFunction)(wxKeyEvent&);
- typedef void (wxEvtHandler::*wxFocusEventFunction)(wxFocusEvent&);
- typedef void (wxEvtHandler::*wxChildFocusEventFunction)(wxChildFocusEvent&);
- typedef void (wxEvtHandler::*wxActivateEventFunction)(wxActivateEvent&);
- typedef void (wxEvtHandler::*wxMenuEventFunction)(wxMenuEvent&);
- typedef void (wxEvtHandler::*wxJoystickEventFunction)(wxJoystickEvent&);
- typedef void (wxEvtHandler::*wxDropFilesEventFunction)(wxDropFilesEvent&);
- typedef void (wxEvtHandler::*wxInitDialogEventFunction)(wxInitDialogEvent&);
- typedef void (wxEvtHandler::*wxSysColourChangedEventFunction)(wxSysColourChangedEvent&);
- typedef void (wxEvtHandler::*wxDisplayChangedEventFunction)(wxDisplayChangedEvent&);
- typedef void (wxEvtHandler::*wxUpdateUIEventFunction)(wxUpdateUIEvent&);
- typedef void (wxEvtHandler::*wxCloseEventFunction)(wxCloseEvent&);
- typedef void (wxEvtHandler::*wxShowEventFunction)(wxShowEvent&);
- typedef void (wxEvtHandler::*wxIconizeEventFunction)(wxIconizeEvent&);
- typedef void (wxEvtHandler::*wxMaximizeEventFunction)(wxMaximizeEvent&);
- typedef void (wxEvtHandler::*wxNavigationKeyEventFunction)(wxNavigationKeyEvent&);
- typedef void (wxEvtHandler::*wxPaletteChangedEventFunction)(wxPaletteChangedEvent&);
- typedef void (wxEvtHandler::*wxQueryNewPaletteEventFunction)(wxQueryNewPaletteEvent&);
- typedef void (wxEvtHandler::*wxWindowCreateEventFunction)(wxWindowCreateEvent&);
- typedef void (wxEvtHandler::*wxWindowDestroyEventFunction)(wxWindowDestroyEvent&);
- typedef void (wxEvtHandler::*wxSetCursorEventFunction)(wxSetCursorEvent&);
- typedef void (wxEvtHandler::*wxNotifyEventFunction)(wxNotifyEvent&);
- typedef void (wxEvtHandler::*wxHelpEventFunction)(wxHelpEvent&);
- typedef void (wxEvtHandler::*wxContextMenuEventFunction)(wxContextMenuEvent&);
- typedef void (wxEvtHandler::*wxMouseCaptureChangedEventFunction)(wxMouseCaptureChangedEvent&);
- typedef void (wxEvtHandler::*wxMouseCaptureLostEventFunction)(wxMouseCaptureLostEvent&);
- typedef void (wxEvtHandler::*wxClipboardTextEventFunction)(wxClipboardTextEvent&);
- #define wxCommandEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxCommandEventFunction, func)
- #define wxScrollEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxScrollEventFunction, func)
- #define wxScrollWinEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxScrollWinEventFunction, func)
- #define wxSizeEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxSizeEventFunction, func)
- #define wxMoveEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxMoveEventFunction, func)
- #define wxPaintEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxPaintEventFunction, func)
- #define wxNcPaintEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxNcPaintEventFunction, func)
- #define wxEraseEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxEraseEventFunction, func)
- #define wxMouseEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxMouseEventFunction, func)
- #define wxCharEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxCharEventFunction, func)
- #define wxKeyEventHandler(func) wxCharEventHandler(func)
- #define wxFocusEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxFocusEventFunction, func)
- #define wxChildFocusEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxChildFocusEventFunction, func)
- #define wxActivateEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxActivateEventFunction, func)
- #define wxMenuEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxMenuEventFunction, func)
- #define wxJoystickEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxJoystickEventFunction, func)
- #define wxDropFilesEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxDropFilesEventFunction, func)
- #define wxInitDialogEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxInitDialogEventFunction, func)
- #define wxSysColourChangedEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxSysColourChangedEventFunction, func)
- #define wxDisplayChangedEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxDisplayChangedEventFunction, func)
- #define wxUpdateUIEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxUpdateUIEventFunction, func)
- #define wxCloseEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxCloseEventFunction, func)
- #define wxShowEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxShowEventFunction, func)
- #define wxIconizeEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxIconizeEventFunction, func)
- #define wxMaximizeEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxMaximizeEventFunction, func)
- #define wxNavigationKeyEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxNavigationKeyEventFunction, func)
- #define wxPaletteChangedEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxPaletteChangedEventFunction, func)
- #define wxQueryNewPaletteEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxQueryNewPaletteEventFunction, func)
- #define wxWindowCreateEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxWindowCreateEventFunction, func)
- #define wxWindowDestroyEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxWindowDestroyEventFunction, func)
- #define wxSetCursorEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxSetCursorEventFunction, func)
- #define wxNotifyEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxNotifyEventFunction, func)
- #define wxHelpEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxHelpEventFunction, func)
- #define wxContextMenuEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxContextMenuEventFunction, func)
- #define wxMouseCaptureChangedEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxMouseCaptureChangedEventFunction, func)
- #define wxMouseCaptureLostEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxMouseCaptureLostEventFunction, func)
- #define wxClipboardTextEventHandler(func) \
- wxEVENT_HANDLER_CAST(wxClipboardTextEventFunction, func)
- #endif // wxUSE_GUI
- // N.B. In GNU-WIN32, you *have* to take the address of a member function
- // (use &) or the compiler crashes...
- #define wxDECLARE_EVENT_TABLE() \
- private: \
- static const wxEventTableEntry sm_eventTableEntries[]; \
- protected: \
- static const wxEventTable sm_eventTable; \
- virtual const wxEventTable* GetEventTable() const; \
- static wxEventHashTable sm_eventHashTable; \
- virtual wxEventHashTable& GetEventHashTable() const
- // N.B.: when building DLL with Borland C++ 5.5 compiler, you must initialize
- // sm_eventTable before using it in GetEventTable() or the compiler gives
- // E2233 (see http://groups.google.com/groups?selm=397dcc8a%241_2%40dnews)
- #define wxBEGIN_EVENT_TABLE(theClass, baseClass) \
- const wxEventTable theClass::sm_eventTable = \
- { &baseClass::sm_eventTable, &theClass::sm_eventTableEntries[0] }; \
- const wxEventTable *theClass::GetEventTable() const \
- { return &theClass::sm_eventTable; } \
- wxEventHashTable theClass::sm_eventHashTable(theClass::sm_eventTable); \
- wxEventHashTable &theClass::GetEventHashTable() const \
- { return theClass::sm_eventHashTable; } \
- const wxEventTableEntry theClass::sm_eventTableEntries[] = { \
- #define wxBEGIN_EVENT_TABLE_TEMPLATE1(theClass, baseClass, T1) \
- template<typename T1> \
- const wxEventTable theClass<T1>::sm_eventTable = \
- { &baseClass::sm_eventTable, &theClass<T1>::sm_eventTableEntries[0] }; \
- template<typename T1> \
- const wxEventTable *theClass<T1>::GetEventTable() const \
- { return &theClass<T1>::sm_eventTable; } \
- template<typename T1> \
- wxEventHashTable theClass<T1>::sm_eventHashTable(theClass<T1>::sm_eventTable); \
- template<typename T1> \
- wxEventHashTable &theClass<T1>::GetEventHashTable() const \
- { return theClass<T1>::sm_eventHashTable; } \
- template<typename T1> \
- const wxEventTableEntry theClass<T1>::sm_eventTableEntries[] = { \
- #define wxBEGIN_EVENT_TABLE_TEMPLATE2(theClass, baseClass, T1, T2) \
- template<typename T1, typename T2> \
- const wxEventTable theClass<T1, T2>::sm_eventTable = \
- { &baseClass::sm_eventTable, &theClass<T1, T2>::sm_eventTableEntries[0] }; \
- template<typename T1, typename T2> \
- const wxEventTable *theClass<T1, T2>::GetEventTable() const \
- { return &theClass<T1, T2>::sm_eventTable; } \
- template<typename T1, typename T2> \
- wxEventHashTable theClass<T1, T2>::sm_eventHashTable(theClass<T1, T2>::sm_eventTable); \
- template<typename T1, typename T2> \
- wxEventHashTable &theClass<T1, T2>::GetEventHashTable() const \
- { return theClass<T1, T2>::sm_eventHashTable; } \
- template<typename T1, typename T2> \
- const wxEventTableEntry theClass<T1, T2>::sm_eventTableEntries[] = { \
- #define wxBEGIN_EVENT_TABLE_TEMPLATE3(theClass, baseClass, T1, T2, T3) \
- template<typename T1, typename T2, typename T3> \
- const wxEventTable theClass<T1, T2, T3>::sm_eventTable = \
- { &baseClass::sm_eventTable, &theClass<T1, T2, T3>::sm_eventTableEntries[0] }; \
- template<typename T1, typename T2, typename T3> \
- const wxEventTable *theClass<T1, T2, T3>::GetEventTable() const \
- { return &theClass<T1, T2, T3>::sm_eventTable; } \
- template<typename T1, typename T2, typename T3> \
- wxEventHashTable theClass<T1, T2, T3>::sm_eventHashTable(theClass<T1, T2, T3>::sm_eventTable); \
- template<typename T1, typename T2, typename T3> \
- wxEventHashTable &theClass<T1, T2, T3>::GetEventHashTable() const \
- { return theClass<T1, T2, T3>::sm_eventHashTable; } \
- template<typename T1, typename T2, typename T3> \
- const wxEventTableEntry theClass<T1, T2, T3>::sm_eventTableEntries[] = { \
- #define wxBEGIN_EVENT_TABLE_TEMPLATE4(theClass, baseClass, T1, T2, T3, T4) \
- template<typename T1, typename T2, typename T3, typename T4> \
- const wxEventTable theClass<T1, T2, T3, T4>::sm_eventTable = \
- { &baseClass::sm_eventTable, &theClass<T1, T2, T3, T4>::sm_eventTableEntries[0] }; \
- template<typename T1, typename T2, typename T3, typename T4> \
- const wxEventTable *theClass<T1, T2, T3, T4>::GetEventTable() const \
- { return &theClass<T1, T2, T3, T4>::sm_eventTable; } \
- template<typename T1, typename T2, typename T3, typename T4> \
- wxEventHashTable theClass<T1, T2, T3, T4>::sm_eventHashTable(theClass<T1, T2, T3, T4>::sm_eventTable); \
- template<typename T1, typename T2, typename T3, typename T4> \
- wxEventHashTable &theClass<T1, T2, T3, T4>::GetEventHashTable() const \
- { return theClass<T1, T2, T3, T4>::sm_eventHashTable; } \
- template<typename T1, typename T2, typename T3, typename T4> \
- const wxEventTableEntry theClass<T1, T2, T3, T4>::sm_eventTableEntries[] = { \
- #define wxBEGIN_EVENT_TABLE_TEMPLATE5(theClass, baseClass, T1, T2, T3, T4, T5) \
- template<typename T1, typename T2, typename T3, typename T4, typename T5> \
- const wxEventTable theClass<T1, T2, T3, T4, T5>::sm_eventTable = \
- { &baseClass::sm_eventTable, &theClass<T1, T2, T3, T4, T5>::sm_eventTableEntries[0] }; \
- template<typename T1, typename T2, typename T3, typename T4, typename T5> \
- const wxEventTable *theClass<T1, T2, T3, T4, T5>::GetEventTable() const \
- { return &theClass<T1, T2, T3, T4, T5>::sm_eventTable; } \
- template<typename T1, typename T2, typename T3, typename T4, typename T5> \
- wxEventHashTable theClass<T1, T2, T3, T4, T5>::sm_eventHashTable(theClass<T1, T2, T3, T4, T5>::sm_eventTable); \
- template<typename T1, typename T2, typename T3, typename T4, typename T5> \
- wxEventHashTable &theClass<T1, T2, T3, T4, T5>::GetEventHashTable() const \
- { return theClass<T1, T2, T3, T4, T5>::sm_eventHashTable; } \
- template<typename T1, typename T2, typename T3, typename T4, typename T5> \
- const wxEventTableEntry theClass<T1, T2, T3, T4, T5>::sm_eventTableEntries[] = { \
- #define wxBEGIN_EVENT_TABLE_TEMPLATE7(theClass, baseClass, T1, T2, T3, T4, T5, T6, T7) \
- template<typename T1, typename T2, typename T3, typename T4, typename T5, typename T6, typename T7> \
- const wxEventTable theClass<T1, T2, T3, T4, T5, T6, T7>::sm_eventTable = \
- { &baseClass::sm_eventTable, &theClass<T1, T2, T3, T4, T5, T6, T7>::sm_eventTableEntries[0] }; \
- template<typename T1, typename T2, typename T3, typename T4, typename T5, typename T6, typename T7> \
- const wxEventTable *theClass<T1, T2, T3, T4, T5, T6, T7>::GetEventTable() const \
- { return &theClass<T1, T2, T3, T4, T5, T6, T7>::sm_eventTable; } \
- template<typename T1, typename T2, typename T3, typename T4, typename T5, typename T6, typename T7> \
- wxEventHashTable theClass<T1, T2, T3, T4, T5, T6, T7>::sm_eventHashTable(theClass<T1, T2, T3, T4, T5, T6, T7>::sm_eventTable); \
- template<typename T1, typename T2, typename T3, typename T4, typename T5, typename T6, typename T7> \
- wxEventHashTable &theClass<T1, T2, T3, T4, T5, T6, T7>::GetEventHashTable() const \
- { return theClass<T1, T2, T3, T4, T5, T6, T7>::sm_eventHashTable; } \
- template<typename T1, typename T2, typename T3, typename T4, typename T5, typename T6, typename T7> \
- const wxEventTableEntry theClass<T1, T2, T3, T4, T5, T6, T7>::sm_eventTableEntries[] = { \
- #define wxBEGIN_EVENT_TABLE_TEMPLATE8(theClass, baseClass, T1, T2, T3, T4, T5, T6, T7, T8) \
- template<typename T1, typename T2, typename T3, typename T4, typename T5, typename T6, typename T7, typename T8> \
- const wxEventTable theClass<T1, T2, T3, T4, T5, T6, T7, T8>::sm_eventTable = \
- { &baseClass::sm_eventTable, &theClass<T1, T2, T3, T4, T5, T6, T7, T8>::sm_eventTableEntries[0] }; \
- template<typename T1, typename T2, typename T3, typename T4, typename T5, typename T6, typename T7, typename T8> \
- const wxEventTable *theClass<T1, T2, T3, T4, T5, T6, T7, T8>::GetEventTable() const \
- { return &theClass<T1, T2, T3, T4, T5, T6, T7, T8>::sm_eventTable; } \
- template<typename T1, typename T2, typename T3, typename T4, typename T5, typename T6, typename T7, typename T8> \
- wxEventHashTable theClass<T1, T2, T3, T4, T5, T6, T7, T8>::sm_eventHashTable(theClass<T1, T2, T3, T4, T5, T6, T7, T8>::sm_eventTable); \
- template<typename T1, typename T2, typename T3, typename T4, typename T5, typename T6, typename T7, typename T8> \
- wxEventHashTable &theClass<T1, T2, T3, T4, T5, T6, T7, T8>::GetEventHashTable() const \
- { return theClass<T1, T2, T3, T4, T5, T6, T7, T8>::sm_eventHashTable; } \
- template<typename T1, typename T2, typename T3, typename T4, typename T5, typename T6, typename T7, typename T8> \
- const wxEventTableEntry theClass<T1, T2, T3, T4, T5, T6, T7, T8>::sm_eventTableEntries[] = { \
- #define wxEND_EVENT_TABLE() \
- wxDECLARE_EVENT_TABLE_TERMINATOR() };
- /*
- * Event table macros
- */
- // helpers for writing shorter code below: declare an event macro taking 2, 1
- // or none ids (the missing ids default to wxID_ANY)
- //
- // macro arguments:
- // - evt one of wxEVT_XXX constants
- // - id1, id2 ids of the first/last id
- // - fn the function (should be cast to the right type)
- #define wx__DECLARE_EVT2(evt, id1, id2, fn) \
- wxDECLARE_EVENT_TABLE_ENTRY(evt, id1, id2, fn, NULL),
- #define wx__DECLARE_EVT1(evt, id, fn) \
- wx__DECLARE_EVT2(evt, id, wxID_ANY, fn)
- #define wx__DECLARE_EVT0(evt, fn) \
- wx__DECLARE_EVT1(evt, wxID_ANY, fn)
- // Generic events
- #define EVT_CUSTOM(event, winid, func) \
- wx__DECLARE_EVT1(event, winid, wxEventHandler(func))
- #define EVT_CUSTOM_RANGE(event, id1, id2, func) \
- wx__DECLARE_EVT2(event, id1, id2, wxEventHandler(func))
- // EVT_COMMAND
- #define EVT_COMMAND(winid, event, func) \
- wx__DECLARE_EVT1(event, winid, wxCommandEventHandler(func))
- #define EVT_COMMAND_RANGE(id1, id2, event, func) \
- wx__DECLARE_EVT2(event, id1, id2, wxCommandEventHandler(func))
- #define EVT_NOTIFY(event, winid, func) \
- wx__DECLARE_EVT1(event, winid, wxNotifyEventHandler(func))
- #define EVT_NOTIFY_RANGE(event, id1, id2, func) \
- wx__DECLARE_EVT2(event, id1, id2, wxNotifyEventHandler(func))
- // Miscellaneous
- #define EVT_SIZE(func) wx__DECLARE_EVT0(wxEVT_SIZE, wxSizeEventHandler(func))
- #define EVT_SIZING(func) wx__DECLARE_EVT0(wxEVT_SIZING, wxSizeEventHandler(func))
- #define EVT_MOVE(func) wx__DECLARE_EVT0(wxEVT_MOVE, wxMoveEventHandler(func))
- #define EVT_MOVING(func) wx__DECLARE_EVT0(wxEVT_MOVING, wxMoveEventHandler(func))
- #define EVT_MOVE_START(func) wx__DECLARE_EVT0(wxEVT_MOVE_START, wxMoveEventHandler(func))
- #define EVT_MOVE_END(func) wx__DECLARE_EVT0(wxEVT_MOVE_END, wxMoveEventHandler(func))
- #define EVT_CLOSE(func) wx__DECLARE_EVT0(wxEVT_CLOSE_WINDOW, wxCloseEventHandler(func))
- #define EVT_END_SESSION(func) wx__DECLARE_EVT0(wxEVT_END_SESSION, wxCloseEventHandler(func))
- #define EVT_QUERY_END_SESSION(func) wx__DECLARE_EVT0(wxEVT_QUERY_END_SESSION, wxCloseEventHandler(func))
- #define EVT_PAINT(func) wx__DECLARE_EVT0(wxEVT_PAINT, wxPaintEventHandler(func))
- #define EVT_NC_PAINT(func) wx__DECLARE_EVT0(wxEVT_NC_PAINT, wxNcPaintEventHandler(func))
- #define EVT_ERASE_BACKGROUND(func) wx__DECLARE_EVT0(wxEVT_ERASE_BACKGROUND, wxEraseEventHandler(func))
- #define EVT_CHAR(func) wx__DECLARE_EVT0(wxEVT_CHAR, wxCharEventHandler(func))
- #define EVT_KEY_DOWN(func) wx__DECLARE_EVT0(wxEVT_KEY_DOWN, wxKeyEventHandler(func))
- #define EVT_KEY_UP(func) wx__DECLARE_EVT0(wxEVT_KEY_UP, wxKeyEventHandler(func))
- #if wxUSE_HOTKEY
- #define EVT_HOTKEY(winid, func) wx__DECLARE_EVT1(wxEVT_HOTKEY, winid, wxCharEventHandler(func))
- #endif
- #define EVT_CHAR_HOOK(func) wx__DECLARE_EVT0(wxEVT_CHAR_HOOK, wxCharEventHandler(func))
- #define EVT_MENU_OPEN(func) wx__DECLARE_EVT0(wxEVT_MENU_OPEN, wxMenuEventHandler(func))
- #define EVT_MENU_CLOSE(func) wx__DECLARE_EVT0(wxEVT_MENU_CLOSE, wxMenuEventHandler(func))
- #define EVT_MENU_HIGHLIGHT(winid, func) wx__DECLARE_EVT1(wxEVT_MENU_HIGHLIGHT, winid, wxMenuEventHandler(func))
- #define EVT_MENU_HIGHLIGHT_ALL(func) wx__DECLARE_EVT0(wxEVT_MENU_HIGHLIGHT, wxMenuEventHandler(func))
- #define EVT_SET_FOCUS(func) wx__DECLARE_EVT0(wxEVT_SET_FOCUS, wxFocusEventHandler(func))
- #define EVT_KILL_FOCUS(func) wx__DECLARE_EVT0(wxEVT_KILL_FOCUS, wxFocusEventHandler(func))
- #define EVT_CHILD_FOCUS(func) wx__DECLARE_EVT0(wxEVT_CHILD_FOCUS, wxChildFocusEventHandler(func))
- #define EVT_ACTIVATE(func) wx__DECLARE_EVT0(wxEVT_ACTIVATE, wxActivateEventHandler(func))
- #define EVT_ACTIVATE_APP(func) wx__DECLARE_EVT0(wxEVT_ACTIVATE_APP, wxActivateEventHandler(func))
- #define EVT_HIBERNATE(func) wx__DECLARE_EVT0(wxEVT_HIBERNATE, wxActivateEventHandler(func))
- #define EVT_END_SESSION(func) wx__DECLARE_EVT0(wxEVT_END_SESSION, wxCloseEventHandler(func))
- #define EVT_QUERY_END_SESSION(func) wx__DECLARE_EVT0(wxEVT_QUERY_END_SESSION, wxCloseEventHandler(func))
- #define EVT_DROP_FILES(func) wx__DECLARE_EVT0(wxEVT_DROP_FILES, wxDropFilesEventHandler(func))
- #define EVT_INIT_DIALOG(func) wx__DECLARE_EVT0(wxEVT_INIT_DIALOG, wxInitDialogEventHandler(func))
- #define EVT_SYS_COLOUR_CHANGED(func) wx__DECLARE_EVT0(wxEVT_SYS_COLOUR_CHANGED, wxSysColourChangedEventHandler(func))
- #define EVT_DISPLAY_CHANGED(func) wx__DECLARE_EVT0(wxEVT_DISPLAY_CHANGED, wxDisplayChangedEventHandler(func))
- #define EVT_SHOW(func) wx__DECLARE_EVT0(wxEVT_SHOW, wxShowEventHandler(func))
- #define EVT_MAXIMIZE(func) wx__DECLARE_EVT0(wxEVT_MAXIMIZE, wxMaximizeEventHandler(func))
- #define EVT_ICONIZE(func) wx__DECLARE_EVT0(wxEVT_ICONIZE, wxIconizeEventHandler(func))
- #define EVT_NAVIGATION_KEY(func) wx__DECLARE_EVT0(wxEVT_NAVIGATION_KEY, wxNavigationKeyEventHandler(func))
- #define EVT_PALETTE_CHANGED(func) wx__DECLARE_EVT0(wxEVT_PALETTE_CHANGED, wxPaletteChangedEventHandler(func))
- #define EVT_QUERY_NEW_PALETTE(func) wx__DECLARE_EVT0(wxEVT_QUERY_NEW_PALETTE, wxQueryNewPaletteEventHandler(func))
- #define EVT_WINDOW_CREATE(func) wx__DECLARE_EVT0(wxEVT_CREATE, wxWindowCreateEventHandler(func))
- #define EVT_WINDOW_DESTROY(func) wx__DECLARE_EVT0(wxEVT_DESTROY, wxWindowDestroyEventHandler(func))
- #define EVT_SET_CURSOR(func) wx__DECLARE_EVT0(wxEVT_SET_CURSOR, wxSetCursorEventHandler(func))
- #define EVT_MOUSE_CAPTURE_CHANGED(func) wx__DECLARE_EVT0(wxEVT_MOUSE_CAPTURE_CHANGED, wxMouseCaptureChangedEventHandler(func))
- #define EVT_MOUSE_CAPTURE_LOST(func) wx__DECLARE_EVT0(wxEVT_MOUSE_CAPTURE_LOST, wxMouseCaptureLostEventHandler(func))
- // Mouse events
- #define EVT_LEFT_DOWN(func) wx__DECLARE_EVT0(wxEVT_LEFT_DOWN, wxMouseEventHandler(func))
- #define EVT_LEFT_UP(func) wx__DECLARE_EVT0(wxEVT_LEFT_UP, wxMouseEventHandler(func))
- #define EVT_MIDDLE_DOWN(func) wx__DECLARE_EVT0(wxEVT_MIDDLE_DOWN, wxMouseEventHandler(func))
- #define EVT_MIDDLE_UP(func) wx__DECLARE_EVT0(wxEVT_MIDDLE_UP, wxMouseEventHandler(func))
- #define EVT_RIGHT_DOWN(func) wx__DECLARE_EVT0(wxEVT_RIGHT_DOWN, wxMouseEventHandler(func))
- #define EVT_RIGHT_UP(func) wx__DECLARE_EVT0(wxEVT_RIGHT_UP, wxMouseEventHandler(func))
- #define EVT_MOTION(func) wx__DECLARE_EVT0(wxEVT_MOTION, wxMouseEventHandler(func))
- #define EVT_LEFT_DCLICK(func) wx__DECLARE_EVT0(wxEVT_LEFT_DCLICK, wxMouseEventHandler(func))
- #define EVT_MIDDLE_DCLICK(func) wx__DECLARE_EVT0(wxEVT_MIDDLE_DCLICK, wxMouseEventHandler(func))
- #define EVT_RIGHT_DCLICK(func) wx__DECLARE_EVT0(wxEVT_RIGHT_DCLICK, wxMouseEventHandler(func))
- #define EVT_LEAVE_WINDOW(func) wx__DECLARE_EVT0(wxEVT_LEAVE_WINDOW, wxMouseEventHandler(func))
- #define EVT_ENTER_WINDOW(func) wx__DECLARE_EVT0(wxEVT_ENTER_WINDOW, wxMouseEventHandler(func))
- #define EVT_MOUSEWHEEL(func) wx__DECLARE_EVT0(wxEVT_MOUSEWHEEL, wxMouseEventHandler(func))
- #define EVT_MOUSE_AUX1_DOWN(func) wx__DECLARE_EVT0(wxEVT_AUX1_DOWN, wxMouseEventHandler(func))
- #define EVT_MOUSE_AUX1_UP(func) wx__DECLARE_EVT0(wxEVT_AUX1_UP, wxMouseEventHandler(func))
- #define EVT_MOUSE_AUX1_DCLICK(func) wx__DECLARE_EVT0(wxEVT_AUX1_DCLICK, wxMouseEventHandler(func))
- #define EVT_MOUSE_AUX2_DOWN(func) wx__DECLARE_EVT0(wxEVT_AUX2_DOWN, wxMouseEventHandler(func))
- #define EVT_MOUSE_AUX2_UP(func) wx__DECLARE_EVT0(wxEVT_AUX2_UP, wxMouseEventHandler(func))
- #define EVT_MOUSE_AUX2_DCLICK(func) wx__DECLARE_EVT0(wxEVT_AUX2_DCLICK, wxMouseEventHandler(func))
- // All mouse events
- #define EVT_MOUSE_EVENTS(func) \
- EVT_LEFT_DOWN(func) \
- EVT_LEFT_UP(func) \
- EVT_LEFT_DCLICK(func) \
- EVT_MIDDLE_DOWN(func) \
- EVT_MIDDLE_UP(func) \
- EVT_MIDDLE_DCLICK(func) \
- EVT_RIGHT_DOWN(func) \
- EVT_RIGHT_UP(func) \
- EVT_RIGHT_DCLICK(func) \
- EVT_MOUSE_AUX1_DOWN(func) \
- EVT_MOUSE_AUX1_UP(func) \
- EVT_MOUSE_AUX1_DCLICK(func) \
- EVT_MOUSE_AUX2_DOWN(func) \
- EVT_MOUSE_AUX2_UP(func) \
- EVT_MOUSE_AUX2_DCLICK(func) \
- EVT_MOTION(func) \
- EVT_LEAVE_WINDOW(func) \
- EVT_ENTER_WINDOW(func) \
- EVT_MOUSEWHEEL(func)
- // Scrolling from wxWindow (sent to wxScrolledWindow)
- #define EVT_SCROLLWIN_TOP(func) wx__DECLARE_EVT0(wxEVT_SCROLLWIN_TOP, wxScrollWinEventHandler(func))
- #define EVT_SCROLLWIN_BOTTOM(func) wx__DECLARE_EVT0(wxEVT_SCROLLWIN_BOTTOM, wxScrollWinEventHandler(func))
- #define EVT_SCROLLWIN_LINEUP(func) wx__DECLARE_EVT0(wxEVT_SCROLLWIN_LINEUP, wxScrollWinEventHandler(func))
- #define EVT_SCROLLWIN_LINEDOWN(func) wx__DECLARE_EVT0(wxEVT_SCROLLWIN_LINEDOWN, wxScrollWinEventHandler(func))
- #define EVT_SCROLLWIN_PAGEUP(func) wx__DECLARE_EVT0(wxEVT_SCROLLWIN_PAGEUP, wxScrollWinEventHandler(func))
- #define EVT_SCROLLWIN_PAGEDOWN(func) wx__DECLARE_EVT0(wxEVT_SCROLLWIN_PAGEDOWN, wxScrollWinEventHandler(func))
- #define EVT_SCROLLWIN_THUMBTRACK(func) wx__DECLARE_EVT0(wxEVT_SCROLLWIN_THUMBTRACK, wxScrollWinEventHandler(func))
- #define EVT_SCROLLWIN_THUMBRELEASE(func) wx__DECLARE_EVT0(wxEVT_SCROLLWIN_THUMBRELEASE, wxScrollWinEventHandler(func))
- #define EVT_SCROLLWIN(func) \
- EVT_SCROLLWIN_TOP(func) \
- EVT_SCROLLWIN_BOTTOM(func) \
- EVT_SCROLLWIN_LINEUP(func) \
- EVT_SCROLLWIN_LINEDOWN(func) \
- EVT_SCROLLWIN_PAGEUP(func) \
- EVT_SCROLLWIN_PAGEDOWN(func) \
- EVT_SCROLLWIN_THUMBTRACK(func) \
- EVT_SCROLLWIN_THUMBRELEASE(func)
- // Scrolling from wxSlider and wxScrollBar
- #define EVT_SCROLL_TOP(func) wx__DECLARE_EVT0(wxEVT_SCROLL_TOP, wxScrollEventHandler(func))
- #define EVT_SCROLL_BOTTOM(func) wx__DECLARE_EVT0(wxEVT_SCROLL_BOTTOM, wxScrollEventHandler(func))
- #define EVT_SCROLL_LINEUP(func) wx__DECLARE_EVT0(wxEVT_SCROLL_LINEUP, wxScrollEventHandler(func))
- #define EVT_SCROLL_LINEDOWN(func) wx__DECLARE_EVT0(wxEVT_SCROLL_LINEDOWN, wxScrollEventHandler(func))
- #define EVT_SCROLL_PAGEUP(func) wx__DECLARE_EVT0(wxEVT_SCROLL_PAGEUP, wxScrollEventHandler(func))
- #define EVT_SCROLL_PAGEDOWN(func) wx__DECLARE_EVT0(wxEVT_SCROLL_PAGEDOWN, wxScrollEventHandler(func))
- #define EVT_SCROLL_THUMBTRACK(func) wx__DECLARE_EVT0(wxEVT_SCROLL_THUMBTRACK, wxScrollEventHandler(func))
- #define EVT_SCROLL_THUMBRELEASE(func) wx__DECLARE_EVT0(wxEVT_SCROLL_THUMBRELEASE, wxScrollEventHandler(func))
- #define EVT_SCROLL_CHANGED(func) wx__DECLARE_EVT0(wxEVT_SCROLL_CHANGED, wxScrollEventHandler(func))
- #define EVT_SCROLL(func) \
- EVT_SCROLL_TOP(func) \
- EVT_SCROLL_BOTTOM(func) \
- EVT_SCROLL_LINEUP(func) \
- EVT_SCROLL_LINEDOWN(func) \
- EVT_SCROLL_PAGEUP(func) \
- EVT_SCROLL_PAGEDOWN(func) \
- EVT_SCROLL_THUMBTRACK(func) \
- EVT_SCROLL_THUMBRELEASE(func) \
- EVT_SCROLL_CHANGED(func)
- // Scrolling from wxSlider and wxScrollBar, with an id
- #define EVT_COMMAND_SCROLL_TOP(winid, func) wx__DECLARE_EVT1(wxEVT_SCROLL_TOP, winid, wxScrollEventHandler(func))
- #define EVT_COMMAND_SCROLL_BOTTOM(winid, func) wx__DECLARE_EVT1(wxEVT_SCROLL_BOTTOM, winid, wxScrollEventHandler(func))
- #define EVT_COMMAND_SCROLL_LINEUP(winid, func) wx__DECLARE_EVT1(wxEVT_SCROLL_LINEUP, winid, wxScrollEventHandler(func))
- #define EVT_COMMAND_SCROLL_LINEDOWN(winid, func) wx__DECLARE_EVT1(wxEVT_SCROLL_LINEDOWN, winid, wxScrollEventHandler(func))
- #define EVT_COMMAND_SCROLL_PAGEUP(winid, func) wx__DECLARE_EVT1(wxEVT_SCROLL_PAGEUP, winid, wxScrollEventHandler(func))
- #define EVT_COMMAND_SCROLL_PAGEDOWN(winid, func) wx__DECLARE_EVT1(wxEVT_SCROLL_PAGEDOWN, winid, wxScrollEventHandler(func))
- #define EVT_COMMAND_SCROLL_THUMBTRACK(winid, func) wx__DECLARE_EVT1(wxEVT_SCROLL_THUMBTRACK, winid, wxScrollEventHandler(func))
- #define EVT_COMMAND_SCROLL_THUMBRELEASE(winid, func) wx__DECLARE_EVT1(wxEVT_SCROLL_THUMBRELEASE, winid, wxScrollEventHandler(func))
- #define EVT_COMMAND_SCROLL_CHANGED(winid, func) wx__DECLARE_EVT1(wxEVT_SCROLL_CHANGED, winid, wxScrollEventHandler(func))
- #define EVT_COMMAND_SCROLL(winid, func) \
- EVT_COMMAND_SCROLL_TOP(winid, func) \
- EVT_COMMAND_SCROLL_BOTTOM(winid, func) \
- EVT_COMMAND_SCROLL_LINEUP(winid, func) \
- EVT_COMMAND_SCROLL_LINEDOWN(winid, func) \
- EVT_COMMAND_SCROLL_PAGEUP(winid, func) \
- EVT_COMMAND_SCROLL_PAGEDOWN(winid, func) \
- EVT_COMMAND_SCROLL_THUMBTRACK(winid, func) \
- EVT_COMMAND_SCROLL_THUMBRELEASE(winid, func) \
- EVT_COMMAND_SCROLL_CHANGED(winid, func)
- #if WXWIN_COMPATIBILITY_2_6
- // compatibility macros for the old name, deprecated in 2.8
- #define wxEVT_SCROLL_ENDSCROLL wxEVT_SCROLL_CHANGED
- #define EVT_COMMAND_SCROLL_ENDSCROLL EVT_COMMAND_SCROLL_CHANGED
- #define EVT_SCROLL_ENDSCROLL EVT_SCROLL_CHANGED
- #endif // WXWIN_COMPATIBILITY_2_6
- // Convenience macros for commonly-used commands
- #define EVT_CHECKBOX(winid, func) wx__DECLARE_EVT1(wxEVT_CHECKBOX, winid, wxCommandEventHandler(func))
- #define EVT_CHOICE(winid, func) wx__DECLARE_EVT1(wxEVT_CHOICE, winid, wxCommandEventHandler(func))
- #define EVT_LISTBOX(winid, func) wx__DECLARE_EVT1(wxEVT_LISTBOX, winid, wxCommandEventHandler(func))
- #define EVT_LISTBOX_DCLICK(winid, func) wx__DECLARE_EVT1(wxEVT_LISTBOX_DCLICK, winid, wxCommandEventHandler(func))
- #define EVT_MENU(winid, func) wx__DECLARE_EVT1(wxEVT_MENU, winid, wxCommandEventHandler(func))
- #define EVT_MENU_RANGE(id1, id2, func) wx__DECLARE_EVT2(wxEVT_MENU, id1, id2, wxCommandEventHandler(func))
- #if defined(__SMARTPHONE__)
- # define EVT_BUTTON(winid, func) EVT_MENU(winid, func)
- #else
- # define EVT_BUTTON(winid, func) wx__DECLARE_EVT1(wxEVT_BUTTON, winid, wxCommandEventHandler(func))
- #endif
- #define EVT_SLIDER(winid, func) wx__DECLARE_EVT1(wxEVT_SLIDER, winid, wxCommandEventHandler(func))
- #define EVT_RADIOBOX(winid, func) wx__DECLARE_EVT1(wxEVT_RADIOBOX, winid, wxCommandEventHandler(func))
- #define EVT_RADIOBUTTON(winid, func) wx__DECLARE_EVT1(wxEVT_RADIOBUTTON, winid, wxCommandEventHandler(func))
- // EVT_SCROLLBAR is now obsolete since we use EVT_COMMAND_SCROLL... events
- #define EVT_SCROLLBAR(winid, func) wx__DECLARE_EVT1(wxEVT_SCROLLBAR, winid, wxCommandEventHandler(func))
- #define EVT_VLBOX(winid, func) wx__DECLARE_EVT1(wxEVT_VLBOX, winid, wxCommandEventHandler(func))
- #define EVT_COMBOBOX(winid, func) wx__DECLARE_EVT1(wxEVT_COMBOBOX, winid, wxCommandEventHandler(func))
- #define EVT_TOOL(winid, func) wx__DECLARE_EVT1(wxEVT_TOOL, winid, wxCommandEventHandler(func))
- #define EVT_TOOL_DROPDOWN(winid, func) wx__DECLARE_EVT1(wxEVT_TOOL_DROPDOWN, winid, wxCommandEventHandler(func))
- #define EVT_TOOL_RANGE(id1, id2, func) wx__DECLARE_EVT2(wxEVT_TOOL, id1, id2, wxCommandEventHandler(func))
- #define EVT_TOOL_RCLICKED(winid, func) wx__DECLARE_EVT1(wxEVT_TOOL_RCLICKED, winid, wxCommandEventHandler(func))
- #define EVT_TOOL_RCLICKED_RANGE(id1, id2, func) wx__DECLARE_EVT2(wxEVT_TOOL_RCLICKED, id1, id2, wxCommandEventHandler(func))
- #define EVT_TOOL_ENTER(winid, func) wx__DECLARE_EVT1(wxEVT_TOOL_ENTER, winid, wxCommandEventHandler(func))
- #define EVT_CHECKLISTBOX(winid, func) wx__DECLARE_EVT1(wxEVT_CHECKLISTBOX, winid, wxCommandEventHandler(func))
- #define EVT_COMBOBOX_DROPDOWN(winid, func) wx__DECLARE_EVT1(wxEVT_COMBOBOX_DROPDOWN, winid, wxCommandEventHandler(func))
- #define EVT_COMBOBOX_CLOSEUP(winid, func) wx__DECLARE_EVT1(wxEVT_COMBOBOX_CLOSEUP, winid, wxCommandEventHandler(func))
- // Generic command events
- #define EVT_COMMAND_LEFT_CLICK(winid, func) wx__DECLARE_EVT1(wxEVT_COMMAND_LEFT_CLICK, winid, wxCommandEventHandler(func))
- #define EVT_COMMAND_LEFT_DCLICK(winid, func) wx__DECLARE_EVT1(wxEVT_COMMAND_LEFT_DCLICK, winid, wxCommandEventHandler(func))
- #define EVT_COMMAND_RIGHT_CLICK(winid, func) wx__DECLARE_EVT1(wxEVT_COMMAND_RIGHT_CLICK, winid, wxCommandEventHandler(func))
- #define EVT_COMMAND_RIGHT_DCLICK(winid, func) wx__DECLARE_EVT1(wxEVT_COMMAND_RIGHT_DCLICK, winid, wxCommandEventHandler(func))
- #define EVT_COMMAND_SET_FOCUS(winid, func) wx__DECLARE_EVT1(wxEVT_COMMAND_SET_FOCUS, winid, wxCommandEventHandler(func))
- #define EVT_COMMAND_KILL_FOCUS(winid, func) wx__DECLARE_EVT1(wxEVT_COMMAND_KILL_FOCUS, winid, wxCommandEventHandler(func))
- #define EVT_COMMAND_ENTER(winid, func) wx__DECLARE_EVT1(wxEVT_COMMAND_ENTER, winid, wxCommandEventHandler(func))
- // Joystick events
- #define EVT_JOY_BUTTON_DOWN(func) wx__DECLARE_EVT0(wxEVT_JOY_BUTTON_DOWN, wxJoystickEventHandler(func))
- #define EVT_JOY_BUTTON_UP(func) wx__DECLARE_EVT0(wxEVT_JOY_BUTTON_UP, wxJoystickEventHandler(func))
- #define EVT_JOY_MOVE(func) wx__DECLARE_EVT0(wxEVT_JOY_MOVE, wxJoystickEventHandler(func))
- #define EVT_JOY_ZMOVE(func) wx__DECLARE_EVT0(wxEVT_JOY_ZMOVE, wxJoystickEventHandler(func))
- // All joystick events
- #define EVT_JOYSTICK_EVENTS(func) \
- EVT_JOY_BUTTON_DOWN(func) \
- EVT_JOY_BUTTON_UP(func) \
- EVT_JOY_MOVE(func) \
- EVT_JOY_ZMOVE(func)
- // Idle event
- #define EVT_IDLE(func) wx__DECLARE_EVT0(wxEVT_IDLE, wxIdleEventHandler(func))
- // Update UI event
- #define EVT_UPDATE_UI(winid, func) wx__DECLARE_EVT1(wxEVT_UPDATE_UI, winid, wxUpdateUIEventHandler(func))
- #define EVT_UPDATE_UI_RANGE(id1, id2, func) wx__DECLARE_EVT2(wxEVT_UPDATE_UI, id1, id2, wxUpdateUIEventHandler(func))
- // Help events
- #define EVT_HELP(winid, func) wx__DECLARE_EVT1(wxEVT_HELP, winid, wxHelpEventHandler(func))
- #define EVT_HELP_RANGE(id1, id2, func) wx__DECLARE_EVT2(wxEVT_HELP, id1, id2, wxHelpEventHandler(func))
- #define EVT_DETAILED_HELP(winid, func) wx__DECLARE_EVT1(wxEVT_DETAILED_HELP, winid, wxHelpEventHandler(func))
- #define EVT_DETAILED_HELP_RANGE(id1, id2, func) wx__DECLARE_EVT2(wxEVT_DETAILED_HELP, id1, id2, wxHelpEventHandler(func))
- // Context Menu Events
- #define EVT_CONTEXT_MENU(func) wx__DECLARE_EVT0(wxEVT_CONTEXT_MENU, wxContextMenuEventHandler(func))
- #define EVT_COMMAND_CONTEXT_MENU(winid, func) wx__DECLARE_EVT1(wxEVT_CONTEXT_MENU, winid, wxContextMenuEventHandler(func))
- // Clipboard text Events
- #define EVT_TEXT_CUT(winid, func) wx__DECLARE_EVT1(wxEVT_TEXT_CUT, winid, wxClipboardTextEventHandler(func))
- #define EVT_TEXT_COPY(winid, func) wx__DECLARE_EVT1(wxEVT_TEXT_COPY, winid, wxClipboardTextEventHandler(func))
- #define EVT_TEXT_PASTE(winid, func) wx__DECLARE_EVT1(wxEVT_TEXT_PASTE, winid, wxClipboardTextEventHandler(func))
- // Thread events
- #define EVT_THREAD(id, func) wx__DECLARE_EVT1(wxEVT_THREAD, id, wxThreadEventHandler(func))
- // ----------------------------------------------------------------------------
- // Helper functions
- // ----------------------------------------------------------------------------
- // This is an ugly hack to allow the use of Bind() instead of Connect() inside
- // the library code if the library was built with support for it, here is how
- // it is used:
- //
- // class SomeEventHandlingClass : wxBIND_OR_CONNECT_HACK_BASE_CLASS
- // public SomeBaseClass
- // {
- // public:
- // SomeEventHandlingClass(wxWindow *win)
- // {
- // // connect to the event for the given window
- // wxBIND_OR_CONNECT_HACK(win, wxEVT_SOMETHING, wxSomeEventHandler,
- // SomeEventHandlingClass::OnSomeEvent, this);
- // }
- //
- // private:
- // void OnSomeEvent(wxSomeEvent&) { ... }
- // };
- //
- // This is *not* meant to be used by library users, it is only defined here
- // (and not in a private header) because the base class must be visible from
- // other public headers, please do NOT use this in your code, it will be
- // removed from future wx versions without warning.
- #ifdef wxHAS_EVENT_BIND
- #define wxBIND_OR_CONNECT_HACK_BASE_CLASS
- #define wxBIND_OR_CONNECT_HACK_ONLY_BASE_CLASS
- #define wxBIND_OR_CONNECT_HACK(win, evt, handler, func, obj) \
- win->Bind(evt, &func, obj)
- #else // wxHAS_EVENT_BIND
- #define wxBIND_OR_CONNECT_HACK_BASE_CLASS public wxEvtHandler,
- #define wxBIND_OR_CONNECT_HACK_ONLY_BASE_CLASS : public wxEvtHandler
- #define wxBIND_OR_CONNECT_HACK(win, evt, handler, func, obj) \
- win->Connect(evt, handler(func), NULL, obj)
- #endif // wxHAS_EVENT_BIND
- #if wxUSE_GUI
- // Find a window with the focus, that is also a descendant of the given window.
- // This is used to determine the window to initially send commands to.
- WXDLLIMPEXP_CORE wxWindow* wxFindFocusDescendant(wxWindow* ancestor);
- #endif // wxUSE_GUI
- // ----------------------------------------------------------------------------
- // Compatibility macro aliases
- // ----------------------------------------------------------------------------
- // deprecated variants _not_ requiring a semicolon after them and without wx prefix
- // (note that also some wx-prefixed macro do _not_ require a semicolon because
- // it's not always possible to force the compire to require it)
- #define DECLARE_EVENT_TABLE_ENTRY(type, winid, idLast, fn, obj) \
- wxDECLARE_EVENT_TABLE_ENTRY(type, winid, idLast, fn, obj)
- #define DECLARE_EVENT_TABLE_TERMINATOR() wxDECLARE_EVENT_TABLE_TERMINATOR()
- #define DECLARE_EVENT_TABLE() wxDECLARE_EVENT_TABLE();
- #define BEGIN_EVENT_TABLE(a,b) wxBEGIN_EVENT_TABLE(a,b)
- #define BEGIN_EVENT_TABLE_TEMPLATE1(a,b,c) wxBEGIN_EVENT_TABLE_TEMPLATE1(a,b,c)
- #define BEGIN_EVENT_TABLE_TEMPLATE2(a,b,c,d) wxBEGIN_EVENT_TABLE_TEMPLATE2(a,b,c,d)
- #define BEGIN_EVENT_TABLE_TEMPLATE3(a,b,c,d,e) wxBEGIN_EVENT_TABLE_TEMPLATE3(a,b,c,d,e)
- #define BEGIN_EVENT_TABLE_TEMPLATE4(a,b,c,d,e,f) wxBEGIN_EVENT_TABLE_TEMPLATE4(a,b,c,d,e,f)
- #define BEGIN_EVENT_TABLE_TEMPLATE5(a,b,c,d,e,f,g) wxBEGIN_EVENT_TABLE_TEMPLATE5(a,b,c,d,e,f,g)
- #define BEGIN_EVENT_TABLE_TEMPLATE6(a,b,c,d,e,f,g,h) wxBEGIN_EVENT_TABLE_TEMPLATE6(a,b,c,d,e,f,g,h)
- #define END_EVENT_TABLE() wxEND_EVENT_TABLE()
- // other obsolete event declaration/definition macros; we don't need them any longer
- // but we keep them for compatibility as it doesn't cost us anything anyhow
- #define BEGIN_DECLARE_EVENT_TYPES()
- #define END_DECLARE_EVENT_TYPES()
- #define DECLARE_EXPORTED_EVENT_TYPE(expdecl, name, value) \
- extern expdecl const wxEventType name;
- #define DECLARE_EVENT_TYPE(name, value) \
- DECLARE_EXPORTED_EVENT_TYPE(WXDLLIMPEXP_CORE, name, value)
- #define DECLARE_LOCAL_EVENT_TYPE(name, value) \
- DECLARE_EXPORTED_EVENT_TYPE(wxEMPTY_PARAMETER_VALUE, name, value)
- #define DEFINE_EVENT_TYPE(name) const wxEventType name = wxNewEventType();
- #define DEFINE_LOCAL_EVENT_TYPE(name) DEFINE_EVENT_TYPE(name)
- // alias for backward compatibility with 2.9.0:
- #define wxEVT_COMMAND_THREAD wxEVT_THREAD
- // other old wxEVT_COMMAND_* constants
- #define wxEVT_COMMAND_BUTTON_CLICKED wxEVT_BUTTON
- #define wxEVT_COMMAND_CHECKBOX_CLICKED wxEVT_CHECKBOX
- #define wxEVT_COMMAND_CHOICE_SELECTED wxEVT_CHOICE
- #define wxEVT_COMMAND_LISTBOX_SELECTED wxEVT_LISTBOX
- #define wxEVT_COMMAND_LISTBOX_DOUBLECLICKED wxEVT_LISTBOX_DCLICK
- #define wxEVT_COMMAND_CHECKLISTBOX_TOGGLED wxEVT_CHECKLISTBOX
- #define wxEVT_COMMAND_MENU_SELECTED wxEVT_MENU
- #define wxEVT_COMMAND_TOOL_CLICKED wxEVT_TOOL
- #define wxEVT_COMMAND_SLIDER_UPDATED wxEVT_SLIDER
- #define wxEVT_COMMAND_RADIOBOX_SELECTED wxEVT_RADIOBOX
- #define wxEVT_COMMAND_RADIOBUTTON_SELECTED wxEVT_RADIOBUTTON
- #define wxEVT_COMMAND_SCROLLBAR_UPDATED wxEVT_SCROLLBAR
- #define wxEVT_COMMAND_VLBOX_SELECTED wxEVT_VLBOX
- #define wxEVT_COMMAND_COMBOBOX_SELECTED wxEVT_COMBOBOX
- #define wxEVT_COMMAND_TOOL_RCLICKED wxEVT_TOOL_RCLICKED
- #define wxEVT_COMMAND_TOOL_DROPDOWN_CLICKED wxEVT_TOOL_DROPDOWN
- #define wxEVT_COMMAND_TOOL_ENTER wxEVT_TOOL_ENTER
- #define wxEVT_COMMAND_COMBOBOX_DROPDOWN wxEVT_COMBOBOX_DROPDOWN
- #define wxEVT_COMMAND_COMBOBOX_CLOSEUP wxEVT_COMBOBOX_CLOSEUP
- #define wxEVT_COMMAND_TEXT_COPY wxEVT_TEXT_COPY
- #define wxEVT_COMMAND_TEXT_CUT wxEVT_TEXT_CUT
- #define wxEVT_COMMAND_TEXT_PASTE wxEVT_TEXT_PASTE
- #define wxEVT_COMMAND_TEXT_UPDATED wxEVT_TEXT
- #endif // _WX_EVENT_H_
|