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.
tdelibs/interfaces/ktexteditor/variableinterface.h

73 lines
2.3 KiB

/*
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License version 2 as published by the Free Software Foundation.
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
Library General Public License for more details.
You should have received a copy of the GNU Library General Public License
along with this library; see the file COPYING.LIB. If not, write to
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301, USA.
---
Copyright (C) 2004, Anders Lund <anders@alweb.dk>
*/
#ifndef _KTEXTEDITOR_VARIABLE_INTERFACE_H_
#define _KTEXTEDITOR_VARIABLE_INTERFACE_H_
#include <tdelibs_export.h>
class TQString;
namespace KTextEditor {
/**
* This interface is designed to provide access to "document variables",
* for example variables defined in files like "kate: variable value;"
* or the emacs style "-*- variable: value -*-".
*
* The purpose is to allow KTE plugins to use variables.
* A document implementing this interface should return values for variable
* that it does not otherwise know how to use, since they could be of interrest
* to plugins. A document implementing this interface must emit the variableChanged()
* signal whenever a variable is set that it will return a value for.
*
* @short KTextEditor interface to Document Variables
*/
class KTEXTEDITOR_EXPORT VariableInterface
{
public:
VariableInterface();
virtual ~VariableInterface();
unsigned int variableInterfaceNumber();
/**
* @return the value of the variable @p name, or an empty string if the
* variable is not set or has no value.
*/
virtual TQString variable( const TQString &name ) const = 0;
//
// signals!!
//
public:
/**
* Signal: emitted when a variable is set
*/
virtual void variableChanged( const TQString &variable, const TQString &value ) = 0;
private:
static unsigned int globalVariableInterfaceNumber;
unsigned int myVariableInterfaceNumber;
};
KTEXTEDITOR_EXPORT VariableInterface *variableInterface( class Document * );
} // namespace KTextEditor
#endif //_KTEXTEDITOR_VARIABLE_INTERFACE_H_