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
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
|
//////////////////////////////////////////////////////////////////////////////
//////////////////////////////////////////////////////////////////////////////
//
// copyright : (C) 2008 by Eran Ifrah
// file name : context_base.h
//
// -------------------------------------------------------------------------
// A
// _____ _ _ _ _
// / __ \ | | | | (_) |
// | / \/ ___ __| | ___| | _| |_ ___
// | | / _ \ / _ |/ _ \ | | | __/ _ )
// | \__/\ (_) | (_| | __/ |___| | || __/
// \____/\___/ \__,_|\___\_____/_|\__\___|
//
// F i l e
//
// 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 CONTEXT_BASE_H
#define CONTEXT_BASE_H
#include "entry.h"
#include "lexer_configuration.h"
#include "macros.h"
#include "smart_ptr.h"
#include "wx/filename.h"
#include "wx/string.h"
#include <set>
#include <vector>
#include <wx/stc/stc.h>
class clEditor;
/**
* \ingroup LiteEditor
* \brief This class defines the language context of the editor
*
* \version 1.0
* first version
*
* \date 04-30-2007
*
* \author Eran
*
*/
class ContextBase : public wxEvtHandler
{
protected:
clEditor* m_container;
wxString m_name;
wxString m_selectedWord;
std::vector<wxMenuItem*> m_dynItems;
wxStringSet_t m_completionTriggerStrings;
protected:
void SetName(const wxString& name) { m_name = name; }
void DoApplySettings(LexerConf::Ptr_t lexPtr);
void PrependMenuItem(wxMenu* menu, const wxString& text, wxObjectEventFunction func, int eventId = -1);
void PrependMenuItem(wxMenu* menu, const wxString& text, int id);
void PrependMenuItemSeparator(wxMenu* menu);
/**
* @brief search for the next 'what' in the editor
*/
int FindNext(const wxString& what, int& pos, bool wholePage = false);
/**
* @brief search for the next 'what' in the editor
*/
int FindPrev(const wxString& what, int& pos, bool wholePage = false);
public:
// ctor-dtor
ContextBase(clEditor* container);
ContextBase(const wxString& name);
virtual ~ContextBase();
/**
* @brief user typed '@' inside a block comment. Code complete possible keywords
*/
virtual void BlockCommentComplete();
/**
* @brief return true if str is a string that should trigger a code completion
*/
virtual bool IsStringTriggerCodeComplete(const wxString& str) const;
/**
* @brief when the context is requested to display a code completion for keywords
* this functions determines which keyword set to display ( there are up to 5, indexed from: 0-4)
*/
virtual int GetActiveKeywordSet() const { return 0; }
/**
* Return the context parent control
*/
clEditor& GetCtrl() { return *m_container; }
clEditor& GetCtrl() const { return *m_container; }
/**
* Return the context name
*/
const wxString& GetName() const { return m_name; }
// every Context derived class must implement the following methods
virtual ContextBase* NewInstance(clEditor* container) = 0;
virtual void ApplySettings() = 0;
// functions with default implementation:
virtual bool IsDefaultContext() const { return true; }
virtual void OnCallTipClick(wxStyledTextEvent& event) { event.Skip(); }
virtual void OnCalltipCancel(){};
virtual void OnDwellEnd(wxStyledTextEvent& event) { event.Skip(); }
virtual void OnDbgDwellEnd(wxStyledTextEvent& event) { event.Skip(); }
virtual void OnDbgDwellStart(wxStyledTextEvent& event) { event.Skip(); }
virtual void OnKeyDown(wxKeyEvent& event) { event.Skip(); }
virtual void AddMenuDynamicContent(wxMenu* WXUNUSED(menu)) {}
virtual void RemoveMenuDynamicContent(wxMenu* WXUNUSED(menu)) {}
virtual void OnSciUpdateUI(wxStyledTextEvent& WXUNUSED(event)) {}
virtual void OnFileSaved() {}
virtual void OnEnterHit() {}
virtual void RetagFile() {}
virtual void OnUserTypedXChars(const wxString& word);
virtual wxString CallTipContent() { return wxEmptyString; }
virtual void SetActive() {}
virtual bool IsCommentOrString(long WXUNUSED(pos)) { return false; }
/**
* @brief return true if the caret is at a block comment
*/
virtual bool IsAtBlockComment() const { return false; }
/**
* @brief return true if the caret is at a line comment
*/
virtual bool IsAtLineComment() const { return false; }
virtual void AutoIndent(const wxChar&);
virtual void AutoAddComment();
virtual bool CompleteWord() { return false; }
virtual bool CodeComplete(long pos = wxNOT_FOUND)
{
wxUnusedVar(pos);
return false;
}
virtual bool GetHoverTip(int pos) { return false; }
virtual bool GotoDefinition() { return false; }
virtual TagEntryPtr GetTagAtCaret(bool scoped, bool impl) { return NULL; }
virtual wxString GetCurrentScopeName() { return wxEmptyString; }
virtual void SemicolonShift() {}
virtual int DoGetCalltipParamterIndex();
// ctrl-click style navigation support
virtual bool GetHyperlinkRange(int& start, int& end);
// override this method if you wish to provide context based right click menu
virtual wxMenu* GetMenu();
/**
* @brief process any idle actions by the context
*/
virtual void ProcessIdleActions() {}
int PositionBeforeCurrent() const;
};
typedef SmartPtr<ContextBase> ContextBasePtr;
#endif // CONTEXT_BASE_H
|
