You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
151 lines
4.3 KiB
151 lines
4.3 KiB
/***************************************************************************
|
|
* This file is part of the KDE project
|
|
* copyright (C) 2005 by Sebastian Sauer (mail@dipe.org)
|
|
* copyright (C) 2005 by Tobi Krebs (tobi.krebs@gmail.com)
|
|
*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Library General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
* This program 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
|
|
* Library General Public License for more details.
|
|
* You should have received a copy of the GNU Library General Public License
|
|
* along with this program; see the file COPYING. If not, write to
|
|
* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
* Boston, MA 02110-1301, USA.
|
|
***************************************************************************/
|
|
|
|
#ifndef KOMACRO_METAMETHOD_H
|
|
#define KOMACRO_METAMETHOD_H
|
|
|
|
#include <tqstring.h>
|
|
#include <tqvaluelist.h>
|
|
#include <ksharedptr.h>
|
|
|
|
#include "komacro_export.h"
|
|
|
|
struct TQUObject;
|
|
|
|
namespace KoMacro {
|
|
|
|
// forward declarations.
|
|
class Variable;
|
|
class MetaObject;
|
|
class MetaParameter;
|
|
class MetaProxy;
|
|
|
|
/**
|
|
* Class to provide abstract methods for the undocumented
|
|
* TQt3 TQUObject-API functionality.
|
|
*
|
|
* The design tried to limit future porting to TQt4 by providing a
|
|
* somewhat similar API to the TQt4 TQMeta* stuff.
|
|
*/
|
|
class KOMACRO_EXPORT MetaMethod : public KShared
|
|
{
|
|
public:
|
|
|
|
/**
|
|
* The type of method this @a MetaMethod provides
|
|
* access to.
|
|
*/
|
|
enum Type {
|
|
Signal, /// The @a MetaMethod points to a TQt signal.
|
|
Slot, /// The @a MetaMethod points to a TQt slot.
|
|
Unknown /// The @a MetaMethod is not known.
|
|
};
|
|
|
|
/**
|
|
* Constructor.
|
|
*
|
|
* @param signature The signature this @a MetaMethod has. This
|
|
* includes the tagname and the arguments and could look like
|
|
* "myslot(const TQString&, int)".
|
|
* @param type The @a MetaMethod::Type the @a MethodMethod
|
|
* has.
|
|
* @param object The @a MetaObject this @a MethodMethod
|
|
* belongs to. Each @a MethodMethod is associated with
|
|
* exactly one @a MetaObject .
|
|
*/
|
|
explicit MetaMethod(const TQString& signature, Type type = Unknown, KSharedPtr<MetaObject> object = 0);
|
|
|
|
/**
|
|
* Destructor.
|
|
*/
|
|
~MetaMethod();
|
|
|
|
/**
|
|
* @return the @a MetaObject instance this @a MethodMethod
|
|
* belongs to.
|
|
*/
|
|
KSharedPtr<MetaObject> const object() const;
|
|
|
|
/**
|
|
* @return the signature this @a MetaMethod has. It could
|
|
* be something like "mySlot(const TQString&,int)".
|
|
*/
|
|
const TQString signature() const;
|
|
|
|
/**
|
|
* @return the signatures tagname this @a MetaMethod has.
|
|
* At the signature "mySlot(const TQString&,int)" the
|
|
* tagname would be "mySlot".
|
|
*/
|
|
const TQString signatureTag() const;
|
|
|
|
/**
|
|
* @return the signatures arguments this @a MetaMethod has.
|
|
* At the signature "mySlot(const TQString&,int)" the
|
|
* arguments are "const TQString&,int".
|
|
*/
|
|
const TQString signatureArguments() const;
|
|
|
|
/**
|
|
* @return the @a Type of method this @a MetaMethod provides
|
|
* access to.
|
|
*/
|
|
Type type() const;
|
|
|
|
/**
|
|
* @return the signature arguments as parsed list of
|
|
* @a MetaParameter instances.
|
|
*/
|
|
TQValueList< KSharedPtr<MetaParameter> > arguments() const;
|
|
|
|
/**
|
|
* Translate the passed @p arguments list of @a Variable instances
|
|
* into a TQt3 TQUObject* array.
|
|
*/
|
|
TQUObject* toTQUObject(TQValueList< KSharedPtr<Variable> > arguments);
|
|
|
|
/**
|
|
* Translate the passed @p uo TQUObject reference into an internal used
|
|
* @a Variable instances.
|
|
*/
|
|
KSharedPtr<Variable> toVariable(TQUObject* uo);
|
|
|
|
/**
|
|
* Translate the passed @p uo TQUObject array into an internal used
|
|
* list of @a Variable instances.
|
|
*/
|
|
TQValueList< KSharedPtr<Variable> > toVariableList(TQUObject* uo);
|
|
|
|
/**
|
|
* Invoke the @a MetaMethod with the optional arguments
|
|
* @p arguments and return a variable.
|
|
*/
|
|
KSharedPtr<Variable> invoke(TQValueList< KSharedPtr<Variable> > arguments);
|
|
|
|
private:
|
|
/// @internal d-pointer class.
|
|
class Private;
|
|
/// @internal d-pointer instance.
|
|
Private* const d;
|
|
};
|
|
|
|
}
|
|
|
|
#endif
|