Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdevelop@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 324 insertions, 0 deletions

diff --git a/languages/cpp/cppcodecompletion.h b/languages/cpp/cppcodecompletion.h
new file mode 100644
index 00000000..0eb49908
--- /dev/null
+++ b/languages/cpp/cppcodecompletion.h
@@ -0,0 +1,324 @@
+/***************************************************************************
+                        cppcodecompletion.h  -  description
+                           -------------------
+  begin                : Sat Jul 21 2001
+  copyright            : (C) 2001 by Victor R�er
+  email                : victor_roeder@gmx.de
+  copyright            : (C) 2002,2003 by Roberto Raggi
+  email                : roberto@kdevelop.org
+***************************************************************************/
+
+/***************************************************************************
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ ***************************************************************************/
+
+#ifndef __CPPCODECOMPLETION_H__
+#define __CPPCODECOMPLETION_H__
+
+#include "cppsupportpart.h"
+#include "declarationinfo.h"
+
+#include <ast.h>
+#include <codemodel.h>
+#include <set>
+
+#include <ktexteditor/viewcursorinterface.h>
+#include <ktexteditor/editinterface.h>
+#include <ktexteditor/codecompletioninterface.h>
+#include <ktexteditor/texthintinterface.h>
+#include <ktexteditor/cursorinterface.h>
+#include <ktexteditor/view.h>
+
+#include <qobject.h>
+#include <qmutex.h>
+#include <qstringlist.h>
+#include <qtimer.h>
+#include <qguardedptr.h>
+#include <qregexp.h>
+
+#include "driver.h"
+///A little debugging class
+#include <qpopupmenu.h>
+class PopupTracker : public QObject {
+	Q_OBJECT
+public:
+	static PopupTracker* pt;
+	
+	static uint pendingPopups;
+	
+	static QPopupMenu* createPopup( QWidget* parent ) {
+		if( !pt ) pt = new PopupTracker();
+		QPopupMenu* m = new QPopupMenu( parent );
+		++pendingPopups;
+		connect( m, SIGNAL(destroyed()), pt, SLOT(destroyedPopup()) );
+		return m;
+	}
+	
+	static void print() {
+		if( pendingPopups )
+			kdDebug( 9007 ) << "PopupTracker: " << pendingPopups << " popups are still alive" << endl;
+	}
+	
+public slots:
+	void destroyedPopup() {
+		--pendingPopups;
+	}
+};
+
+
+class CodeCompletionEntry;
+class CodeInformationRepository;
+class SimpleContext;
+class SimpleType;
+class SimpleTypeNamespace;
+class CppCodeCompletionData;
+class SimpleTypeConfiguration;
+class TypeDesc;
+struct PopupFillerHelpStruct;
+struct PopupClassViewFillerHelpStruct;
+class SimpleTypeImpl;
+class TranslationUnitAST;
+namespace CppEvaluation
+{
+  class EvaluationResult;
+}
+struct ExpressionInfo;
+
+typedef KSharedPtr<SimpleTypeImpl> TypePointer;
+
+class CppCodeCompletion : public QObject
+{
+	Q_OBJECT
+public:
+    friend class SimpleType;
+	enum CompletionMode
+	{
+	    NormalCompletion,
+	    SignalCompletion,
+	    SlotCompletion,
+	    VirtualDeclCompletion
+	};
+	enum MemberAccessOp
+	{
+		NoOp,
+		DotOp,
+		ArrowOp
+	};
+    
+public:
+	CppCodeCompletion( CppSupportPart* part );
+	virtual ~CppCodeCompletion();
+
+	CodeInformationRepository* repository()
+	{
+		return m_repository;
+	}
+	CompletionMode completionMode() const
+	{
+		return m_completionMode;
+	}
+
+	QString createTypeInfoString( int line, int column );
+	
+    QString replaceCppComments( const QString& contents );
+    int expressionAt( const QString& text, int index );
+	QStringList splitExpression( const QString& text );
+	
+    CppEvaluation::EvaluationResult evaluateExpression( ExpressionInfo expr, SimpleContext* ctx );
+
+    CppEvaluation::EvaluationResult evaluateExpressionAt( int line, int column, SimpleTypeConfiguration& conf, bool ifUnknownSetType = false );
+    
+    void contextEvaluationMenus ( QPopupMenu *popup, const Context *context, int line, int col );
+
+	CppSupportPart* cppSupport() const;
+
+    HashedStringSet getIncludeFiles( const QString& file = QString() );
+
+    static CppCodeCompletion* instance() {
+      return m_instance;
+    }
+
+    ///Adds a string that will be ticked through the status-bar
+    void addStatusText( QString text, int timeout );
+    void clearStatusText();
+
+    QString activeFileName() const {
+      return m_activeFileName;
+    }
+  
+public slots:
+	/**
+	 * @param invokedOnDemand if true and there is exactly one matching entry
+	 *        complete the match immediately without showing the completion box.
+	 *        This is only true, when the users invokes the completion himself
+	 *        (eg presses the completion shortcut CTRL+space)
+	 */
+	void completeText( bool invokedOnDemand = false );
+private slots:
+    void emptyCache();
+	void slotPartAdded( KParts::Part *part );
+	void slotActivePartChanged( KParts::Part *part );
+	void slotArgHintHidden();
+	void slotCompletionBoxHidden();
+	void slotTextChanged();
+	void slotFileParsed( const QString& fileName );
+	void slotCodeModelUpdated( const QString& fileName );
+    void slotTimeout();
+    void slotStatusTextTimeout();
+    void computeFileEntryList();
+    bool isTypeExpression( const QString& expr );
+	void slotTextHint( int line, int col, QString &text );
+    void popupAction( int number );
+	void popupDefinitionAction( int number );
+    void popupClassViewAction( int number );
+	void synchronousParseReady( const QString& file, ParsedFilePointer unit );
+	void slotJumpToDefCursorContext();
+	void slotJumpToDeclCursorContext();
+	
+private:
+	enum FunctionType { Declaration, Definition };
+	
+    TypePointer createGlobalNamespace();
+	bool functionContains( FunctionDom f , int line, int col );
+	void getFunctionBody( FunctionDom f , int& line, int& col );
+	void selectItem( ItemDom item );
+    void addTypePopups( QPopupMenu* parent, TypeDesc d, QString depthAdd, QString prefix = "" );
+    void addTypeClassPopups( QPopupMenu* parent, TypeDesc d, QString depthAdd, QString prefix = "" );
+  QValueList<QStringList> computeSignatureList( CppEvaluation::EvaluationResult function );
+	void integratePart( KParts::Part* part );
+	void setupCodeInformationRepository();
+	FunctionDefinitionAST* functionDefinition( AST* node );
+	void computeRecoveryPoints( ParsedFilePointer unit );
+	void computeRecoveryPointsLocked();
+	void jumpCursorContext( FunctionType );
+	bool getIncludeInfo( int line, QString& includeFileName, QString& includeFilePath, bool& usedProjectFiles );
+	
+    enum EvaluateExpressionOptions {
+        IncludeStandardExpressions = 1,
+        IncludeTypeExpression = 2,
+        CompletionOption = 4, ///Cut off the last word because it is incomplete
+	    SearchInFunctions = 8,
+        SearchInClasses = 16,
+        DefaultAsTypeExpression = 32, ///This makes the evaluation interpret any unidentified expression as a type-expression
+        DefaultEvaluationOptions = 1 | 2 | 8 | 16,
+        DefaultCompletionOptions = 1 | 4 | 8 | 16
+    };
+    
+    bool mayBeTypeTail( int line, int column, QString& append, bool inFunction = false );
+    bool canBeTypePrefix( const QString& prefix, bool inFunction = false );
+    
+
+    ExpressionInfo findExpressionAt( int line, int col, int startLine, int startCol, bool inFunction = false );
+	SimpleContext* computeFunctionContext( FunctionDom f, int line, int col, SimpleTypeConfiguration& conf );
+    
+    CppEvaluation::EvaluationResult evaluateExpressionType( int line, int column, SimpleTypeConfiguration& conf, EvaluateExpressionOptions opt = DefaultCompletionOptions  );
+    SimpleType unTypeDef( SimpleType scope , QMap<QString, QString>& typedefs );
+    
+  //    QString buildSignature( TypePointer currType );
+    SimpleType typeOf( QValueList<Tag>& tags, MemberAccessOp accessOp );
+    
+	/// @todo remove isInstance
+	void computeCompletionEntryList( QValueList<CodeCompletionEntry>& entryList, SimpleContext* ctx, bool isInstance, int depth = 0 );
+	void computeCompletionEntryList( SimpleType type, QValueList<CodeCompletionEntry>&
+                entryList, const QStringList& typeList, SimpleTypeNamespace* ns, std::set<HashedString>& ignore, bool isInstance, int depth = 0  );
+	void computeCompletionEntryList( SimpleType type, QValueList<CodeCompletionEntry>&
+                entryList, const QStringList& typeList, bool isInstance, int depth = 0  );
+	void computeCompletionEntryList( SimpleType type, QValueList<CodeCompletionEntry>& entryList, QValueList<Tag>& tags, bool isInstance, int depth  );
+	void computeCompletionEntryList( SimpleType type, QValueList<CodeCompletionEntry>& entryList, ClassDom klass, bool isInstance, int depth   );
+	void computeCompletionEntryList( SimpleType type, QValueList<CodeCompletionEntry>& entryList, NamespaceDom scope, bool isInstance, int depth   );
+	void computeCompletionEntryList( SimpleType type, QValueList<CodeCompletionEntry>& entryList, const FunctionList& methods, bool isInstance, int depth );
+	void computeCompletionEntryList( SimpleType type, QValueList<CodeCompletionEntry>& entryList, const VariableList& attributes, bool isInstance, int depth );
+	void computeCompletionEntryList( QString parent, SimpleType type, QValueList<CodeCompletionEntry>& entryList, const ClassList& lst, bool isInstance, int depth );
+	void computeCompletionEntryList( QString parent, SimpleType type, QValueList<CodeCompletionEntry>& entryList, const TypeAliasList& lst, bool isInstance, int depth );
+	void computeCompletionEntryList( SimpleType type, QValueList<CodeCompletionEntry>& entryList, const NamespaceList& lst, bool isInstance, int depth );
+
+	SimpleContext* computeContext( FunctionDefinitionAST* ast, int line, int col, int lineOffset, int colOffset );
+	void computeContext( SimpleContext*& ctx, StatementAST* ast, int line, int col );
+	void computeContext( SimpleContext*& ctx, StatementListAST* ast, int line, int col );
+	void computeContext( SimpleContext*& ctx, IfStatementAST* ast, int line, int col );
+	void computeContext( SimpleContext*& ctx, ForStatementAST* ast, int line, int col );
+	void computeContext( SimpleContext*& ctx, DoStatementAST* ast, int line, int col );
+	void computeContext( SimpleContext*& ctx, WhileStatementAST* ast, int line, int col );
+	void computeContext( SimpleContext*& ctx, SwitchStatementAST* ast, int line, int col );
+	void computeContext( SimpleContext*& ctx, TryBlockStatementAST* ast, int line, int col );
+	void computeContext( SimpleContext*& ctx, CatchStatementListAST* ast, int line, int col );
+	void computeContext( SimpleContext*& ctx, CatchStatementAST* ast, int line, int col );
+	void computeContext( SimpleContext*& ctx, DeclarationStatementAST* ast, int line, int col );
+	void computeContext( SimpleContext*& ctx, ConditionAST* ast, int line, int col );
+	bool inContextScope( AST* ast, int line, int col, bool checkStart = true, bool checkEnd = true );
+
+	QString getText( int startLine, int startColumn, int endLine, int endColumn, int omitLine = -1 );
+	
+    
+private:
+    
+    friend class SimpleTypeCatalog;
+    friend class SimpleTypeCodeModel;
+    friend class SimpleTypeImpl;
+    friend class ExpressionEvaluation;
+    friend class PopupFillerHelpStruct;
+    friend class PopupClassViewFillerHelpStruct;
+    QGuardedPtr<CppSupportPart> m_pSupport;
+	QTimer* m_ccTimer;
+    QTimer* m_showStatusTextTimer;
+    QValueList<QPair<int, QString> > m_statusTextList;
+
+    void fitContextItem( int nLine, int nColumn );
+	void needRecoveryPoints();
+    
+	QString m_activeFileName;
+	KTextEditor::ViewCursorInterface* m_activeCursor;
+	KTextEditor::EditInterface* m_activeEditor;
+    KTextEditor::TextHintInterface* m_activeHintInterface;
+	KTextEditor::CodeCompletionInterface* m_activeCompletion;
+	KTextEditor::View* m_activeView;
+	
+	bool m_bArgHintShow;
+	bool m_bCompletionBoxShow;
+	bool m_blockForKeyword;
+	bool m_demandCompletion;
+
+	unsigned int m_ccLine;
+	unsigned int m_ccColumn;
+    static CppCodeCompletion* m_instance;
+
+	CodeInformationRepository* m_repository;
+	CppCodeCompletionData* d;
+	CompletionMode m_completionMode;
+
+	QTime m_lastHintTime;
+
+    //If more then the given count of comments were requested, all following ones will be blank.(Performance-reasons)
+    void setMaxComments( int count );
+    
+    QString commentFromItem( const SimpleType& parent, const ItemDom& item );
+    QString commentFromTag( const SimpleType& parent, Tag& tag );
+        
+    ItemDom m_cachedFromContext;  ///Can be a function or a class, representing the position from where the last completion was started. Necessary as long as all imports are put into the global namespace.
+	
+	QRegExp m_includeRx;
+	QRegExp m_cppCodeCommentsRx;
+	QRegExp m_codeCompleteChRx;
+	QRegExp m_codeCompleteCh2Rx;
+    QValueList<KTextEditor::CompletionEntry> m_fileEntryList;
+
+    int m_maxComments;
+    
+    typedef QMap<int, DeclarationInfo> PopupActions;
+    typedef QMap<int, ItemDom> PopupClassViewActions;
+    PopupActions m_popupActions;
+    PopupActions m_popupDefinitionActions;
+    PopupClassViewActions m_popupClassViewActions;
+	
+	// we need something to plug actions that are not in any menu 
+	// into in order for their shortcuts to work
+	QWidget m_DummyActionWidget;
+};
+
+#endif 
+// kate: indent-mode csands; tab-width 4;