KiCad PCB EDA Suite
Loading...
Searching...
No Matches
kiway_express.h
Go to the documentation of this file.
1/*
2 * This program source code file is part of KiCad, a free EDA CAD application.
3 *
4 * Copyright (C) 2014 SoftPLC Corporation, Dick Hollenbeck <[email protected]>
5 * Copyright (C) 2014-202 KiCad Developers, see AUTHORS.TXT for contributors.
6 *
7 * This program is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License
9 * as published by the Free Software Foundation; either version 2
10 * of the License, or (at your option) any later version.
11 *
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
16 *
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, you may find one here:
19 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
20 * or you may search the http://www.gnu.org website for the version 2 license,
21 * or you may write to the Free Software Foundation, Inc.,
22 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
23 */
24
25#ifndef KIWAY_EXPRESS_H_
26#define KIWAY_EXPRESS_H_
27
28// @see http://wiki.wxwidgets.org/Custom_Events_Tutorial
29#include <frame_type.h>
30#include <mail_type.h>
31#include <kicommon.h>
32#include <wx/string.h>
33#include <wx/event.h>
34
35
39class KICOMMON_API KIWAY_EXPRESS : public wxEvent
40{
41public:
45 FRAME_T Dest() { return m_destination; }
46
51 {
52 return (MAIL_T) GetId(); // re-purposed control id.
53 }
54
58 std::string& GetPayload() { return m_payload; }
59 void SetPayload( const std::string& aPayload ) { m_payload = aPayload; }
60
61 KIWAY_EXPRESS* Clone() const override { return new KIWAY_EXPRESS( *this ); }
62
63 //KIWAY_EXPRESS() {}
64
65 KIWAY_EXPRESS( FRAME_T aDestination, MAIL_T aCommand, std::string& aPayload,
66 wxWindow* aSource = nullptr );
67
68 KIWAY_EXPRESS( const KIWAY_EXPRESS& anOther );
69
73 static const wxEventType wxEVENT_ID;
74
75 //DECLARE_DYNAMIC_CLASS( KIWAY_EXPRESS )
76
77private:
79 std::string& m_payload;
80
81 // possible new ideas here.
82};
83
84
85typedef void ( wxEvtHandler::*kiwayExpressFunction )( KIWAY_EXPRESS& );
86
88#define kiwayExpressHandler( func ) wxEVENT_HANDLER_CAST( kiwayExpressFunction, func )
89
91#define EVT_KIWAY_EXPRESS( func ) \
92 wx__DECLARE_EVT0( KIWAY_EXPRESS::wxEVENT_ID, kiwayExpressHandler( func ) )
93
94#endif // KIWAY_EXPRESS_H_
Carry a payload from one KIWAY_PLAYER to another within a PROJECT.
Definition: kiway_express.h:40
KIWAY_EXPRESS * Clone() const override
Definition: kiway_express.h:61
FRAME_T m_destination
could have been a bitmap indicating multiple recipients.
Definition: kiway_express.h:78
void SetPayload(const std::string &aPayload)
Definition: kiway_express.h:59
static const wxEventType wxEVENT_ID
The wxEventType argument to wxEvent() and identifies an event class in a hurry.
Definition: kiway_express.h:73
std::string & GetPayload()
Return the payload, which can be any text but it typically self identifying s-expression.
Definition: kiway_express.h:58
std::string & m_payload
very often s-expression text, but not always.
Definition: kiway_express.h:79
MAIL_T Command()
Returns the MAIL_T associated with this mail.
Definition: kiway_express.h:50
FRAME_T Dest()
Return the destination player id of the message.
Definition: kiway_express.h:45
FRAME_T
The set of EDA_BASE_FRAME derivatives, typically stored in EDA_BASE_FRAME::m_Ident.
Definition: frame_type.h:33
#define KICOMMON_API
Definition: kicommon.h:28
void(wxEvtHandler::* kiwayExpressFunction)(KIWAY_EXPRESS &)
Definition: kiway_express.h:85
MAIL_T
The set of mail types sendable via KIWAY::ExpressMail() and supplied as the aCommand parameter to tha...
Definition: mail_type.h:38