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
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
|
#pragma once
/*
help.hpp
Помощь
*/
/*
Copyright (c) 1996 Eugene Roshal
Copyright (c) 2000 Far Group
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
3. The name of the authors may not be used to endorse or promote products
derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
#include "frame.hpp"
#include "keybar.hpp"
#include "array.hpp"
#include "chgmmode.hpp"
class CallBackStack;
#define HelpBeginLink L'<'
#define HelpEndLink L'>'
#define HelpFormatLink L"<%ls/>%ls"
#define HELPMODE_CLICKOUTSIDE 0x20000000 // было нажатие мыши вне хелпа?
struct StackHelpData
{
DWORD Flags; // флаги
int TopStr; // номер верхней видимой строки темы
int CurX,CurY; // координаты (???)
FARString strHelpMask; // значение маски
FARString strHelpPath; // путь к хелпам
FARString strHelpTopic; // текущий топик
FARString strSelTopic; // выделенный топик (???)
void Clear()
{
Flags=0;
TopStr=0;
CurX=CurY=0;
strHelpMask.Clear();
strHelpPath.Clear();
strHelpTopic.Clear();
strSelTopic.Clear();
}
};
enum HELPDOCUMENTSHELPTYPE
{
HIDX_PLUGINS, // Индекс плагинов
HIDX_DOCUMS, // Индекс документов
};
enum
{
FHELPOBJ_ERRCANNOTOPENHELP = 0x80000000,
};
class HelpRecord
{
public:
wchar_t *HelpStr;
HelpRecord(const wchar_t *HStr=nullptr)
{
HelpStr = nullptr;
if (HStr )
HelpStr = wcsdup(HStr);
};
const HelpRecord& operator=(const HelpRecord &rhs)
{
if (this != &rhs)
{
HelpStr = wcsdup(rhs.HelpStr);
}
return *this;
};
bool operator==(const HelpRecord &rhs) const
{
return !StrCmpI(HelpStr,rhs.HelpStr);
};
int operator<(const HelpRecord &rhs) const
{
return StrCmpI(HelpStr,rhs.HelpStr) < 0;
};
~HelpRecord()
{
if (HelpStr) free(HelpStr);
}
};
class Help:public Frame
{
private:
ChangeMacroMode CMM;
BOOL ErrorHelp; // TRUE - ошибка! Например - нет такого топика
SaveScreen *TopScreen; // область сохранения под хелпом
KeyBar HelpKeyBar; // кейбар
CallBackStack *Stack; // стек возврата
FARString strFullHelpPathName;
StackHelpData StackData;
TArray<HelpRecord> HelpList; // "хелп" в памяти.
int StrCount; // количество строк в теме
int FixCount; // количество строк непрокручиваемой области
int FixSize; // Размер непрокручиваемой области
int TopicFound; // TRUE - топик найден
int IsNewTopic; // это новый топик?
int MouseDown;
FARString strCtrlColorChar; // CtrlColorChar - опция! для спецсимвола-
// символа - для атрибутов
int CurColor; // CurColor - текущий цвет отрисовки
int CtrlTabSize; // CtrlTabSize - опция! размер табуляции
FARString strCurPluginContents; // помним PluginContents (для отображения в заголовке)
DWORD LastStartPos;
DWORD StartPos;
FARString strCtrlStartPosChar;
FARString strLastSearchStr;
int LastSearchCase = 0, LastSearchWholeWords = 0, LastSearchRegexp = 0;
private:
virtual void DisplayObject();
int ReadHelp(const wchar_t *Mask=nullptr);
void AddLine(const wchar_t *Line);
void AddTitle(const wchar_t *Title);
void HighlightsCorrection(FARString &strStr);
void FastShow();
void DrawWindowFrame();
void OutString(const wchar_t *Str);
int StringLen(const wchar_t *Str);
void CorrectPosition();
int IsReferencePresent();
void MoveToReference(int Forward,int CurScreen);
void ReadDocumentsHelp(int TypeIndex);
void Search(FILE *HelpFile,uintptr_t nCodePage);
int JumpTopic(const wchar_t *JumpTopic=nullptr);
const HelpRecord* GetHelpItem(int Pos);
public:
Help(const wchar_t *Topic,const wchar_t *Mask=nullptr,DWORD Flags=0);
virtual ~Help();
public:
virtual void Hide();
virtual int ProcessKey(int Key);
virtual int ProcessMouse(MOUSE_EVENT_RECORD *MouseEvent);
virtual void InitKeyBar();
BOOL GetError() {return ErrorHelp;}
virtual void SetScreenPosition();
virtual void OnChangeFocus(int focus); // вызывается при смене фокуса
virtual void ResizeConsole();
virtual int FastHide(); // Введена для нужд CtrlAltShift
virtual const wchar_t *GetTypeName() {return L"[Help]";}
virtual int GetTypeAndName(FARString &strType, FARString &strName);
virtual int GetType() { return MODALTYPE_HELP; }
virtual int64_t VMProcess(int OpCode,void *vParam,int64_t iParam);
static FARString &MkTopic(INT_PTR PluginNumber,const wchar_t *HelpTopic,FARString &strTopic);
};
|