/usr/include/fox-1.6/FXGUISignal.h is in libfox-1.6-dev 1.6.49-2ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 | /********************************************************************************
* *
* S i g n a l G U I T h r e a d *
* *
*********************************************************************************
* Copyright (C) 2005,2006 by Jeroen van der Zijp. All Rights Reserved. *
*********************************************************************************
* This library is free software; you can redistribute it and/or *
* modify it under the terms of the GNU Lesser General Public *
* License as published by the Free Software Foundation; either *
* version 2.1 of the License, or (at your option) any later version. *
* *
* This library is distributed in the hope that it will be useful, *
* but WITHOUT ANY WARRANTY; without even the implied warranty of *
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU *
* Lesser General Public License for more details. *
* *
* You should have received a copy of the GNU Lesser General Public *
* License along with this library; if not, write to the Free Software *
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. *
*********************************************************************************
* $Id: FXGUISignal.h,v 1.6.2.1 2006/05/24 12:08:45 fox Exp $ *
********************************************************************************/
#ifndef FXGUISIGNAL_H
#define FXGUISIGNAL_H
#ifndef FXOBJECT_H
#include "FXObject.h"
#endif
namespace FX {
class FXApp;
/**
* An FXGUISignal manages a waitable object which is used to awaken the
* main user-interface thread from a worker thread. When a FXGUISignal is
* constructed, it automatically calls addInput() function to register itself
* as the message handler for the SEL_IO_READ message from FXApp. Likewise,
* when FXGUISignal is destroyed, it calls removeInput() to remove itself as
* the message handler for the SEL_IO_READ message from FXApp.
* When a worker thread calls the signal() API, the waitable object managed by
* FXGUISignal is set to the signaled state, after which the worker thread
* continues execution immediately.
* Meanwhile, the main user-interface thread is awakened because one of its
* inputs has become signaled. It invokes the onSignal handler of FXGUISignal,
* which clears the waitable object's state and subsequently dispatches to the
* target of FXGUISignal through the SEL_IO_READ message.
* Thus, the SEL_IO_READ handler in FXGUISignal is executed in the context of
* the user-interface thread, allowing any user-interaction without blocking
* a worker thread.
* In a typical scenario, a worker thread updates some common data structure,
* then notifies the main user-interface thread (via the FXGUISignal) to update
* the user interface and perform some appropriate action.
*/
class FXAPI FXGUISignal : public FXObject {
FXDECLARE(FXGUISignal)
private:
FXApp *app; // Application
protected:
FXObject *target; // Target object
void *data; // User data
FXSelector message; // Message id
private:
#ifndef WIN32
FXInputHandle fd[2];
#else
FXInputHandle event;
#endif
protected:
FXGUISignal();
private:
FXGUISignal(const FXGUISignal&);
FXGUISignal& operator=(const FXGUISignal&);
public:
enum{
ID_IO_READ=0,
ID_LAST
};
public:
long onSignal(FXObject*,FXSelector,void*);
public:
/// Constructor
FXGUISignal(FXApp* a,FXObject* tgt=NULL,FXSelector sel=0,void* ptr=NULL);
/// Get application
FXApp* getApp() const { return app; }
/// Set the message target object
void setTarget(FXObject *t){ target=t; }
/// Get the message target object, if any
FXObject* getTarget() const { return target; }
/// Set the message identifier
void setSelector(FXSelector sel){ message=sel; }
/// Get the message identifier
FXSelector getSelector() const { return message; }
/// Set user data pointer
void setData(void *ptr){ data=ptr; }
/// Get user data pointer
void* getData() const { return data; }
/**
* Signal the event; this API may be called by the worker thread
* to send a message to the user-interface thread.
*/
void signal();
/// Destructor
virtual ~FXGUISignal();
};
}
#endif
|