This repository has been archived by the owner on Oct 6, 2020. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 0
/
plug_func.h
228 lines (194 loc) · 9.86 KB
/
plug_func.h
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
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
/*
nazwa="plug Functions"
data="2002-11-01"
ver="0.6.16.x"
info="Zestaw makr i funkcji pomocniczych."
*/
#ifndef PLUGFUNCH
#define PLUGFUNCH
/**\file
Zestaw makr i funkcji pomocniczych . <br><br>
Musi byæ include'owany po plug_export.h.
*/
/**
\addtogroup imi_action_
\{
*/
/**\defgroup action_makra Funkcje pomocnicze.
\{
*/
/** Do wstawienia w switch'u akcji. Jeœli akcja nie zosta³a wywo³ana z kodem ACTN_ACTION - wychodzi. */
#define ACTIONONLY(notify) if (notify->code != ACTN_ACTION) return 0
/** Pusta akcja. */
#define NOACTION sUIAction(0,0)
/** Sprawdza czy cCtrl::isRunning() zwraca true, jeœli nie, wychodzi. */
#define ISRUNNING() if (!Ctrl->isRunning()) {Ctrl->setError(IMERROR_SHUTDOWN); return 0;}
/// Dodaje akcjê.
/// \blank
int UIActionAdd(int _parent , int _id , int _status=0 , const char * _txt = 0 , int _p1=0 , short _w=0 , short _h=0 , int _p2=0 , int _param=0);
/// Wstawia akcjê.
/// \blank
inline int UIActionInsert(int _parent , int _id , int _pos , int _status=0 , const char * _txt = 0 , int _p1=0 , short _w=0 , short _h=0 , int _p2=0 , int _param=0);
/// Dodaje akcjê do konfiguracji.
/// \blank
int UIActionCfgAdd(int _parent , int _id , int _status=0 , const char * _txt = 0 , int _p1=0 , short _x=0 , short _y=0 , short _w=0 , short _h=0 , int _p2=0 , int _param=0);
/// Wstawia akcjê do konfiguracji.
/// \blank
int UIActionCfgInsert(int _parent , int _id , int _pos , int _status=0 , const char * _txt = 0 , int _p1=0 , short _x=0 , short _y=0 , short _w=0 , short _h=0 , int _p2=0 , int _param=0);
/// Dodaje grupê.
/// \blank
int UIGroupAdd(int _parent , int _id , int _status=0 , const char * _txt = 0 , int _p1=0 , short _w=0 , short _h=0 , int _p2=0 , int _param=0);
/// Wstawia grupê.
/// \blank
int UIGroupInsert(int _parent , int _id , int _pos , int _status=0 , const char * _txt = 0 , int _p1=0 , short _w=0 , short _h=0 , int _p2=0 , int _param=0);
/// Zwraca pozycjê w grupie.
/// \blank
int UIActionGetPos(int _parent , int _id);
/// Pobiera akcje.
/// \blank
int UIActionSet(sUIActionInfo & nfo);
/// Ustawia akcje.
/// \blank
int UIActionGet(sUIActionInfo & nfo);
/// Ustawia status.
/// \blank
int UIActionSetStatus(sUIAction act , int status , int mask = -1);
/// \blank
int UIActionGetStatus(sUIAction act);
/// Zwraca uchwyt grupy
void * UIGroupHandle(sUIAction act);
/// Zwraca uchwyt akcji
void * UIActionHandle(sUIAction act);
/** Zwraca uchwyt akcji dla kontrolek z ACTR_SETCNT
W niektórych przypadkach pozwala na pobranie uchwytu
bez zmieniania kontaktu przypisanego do akcji...
*/
void * UIActionHandleDirect(sUIAction act);
int UIActionCall(sUIActionNotify_base * an);
int UIActionSetStatus(int parent , int id , int status , int mask = -1);
/// Ustawia text.
/// \blank
int UIActionSetText(sUIAction act , const char * txt);
int UIActionSetText(int parent , int id , const char * txt);
/// Ustawia wartosc kontrolki w konfiguracji.
/// \blank
int UIActionCfgSetValue(sUIAction act , const char * val , bool convert = true);
/// Pobiera wartosc kontrolki z konfiguracji.
/// \blank
const char * UIActionCfgGetValue(sUIAction act , char * val , int size , bool convert = true);
///\}
/** Dodaje standardowy zestaw akcji z boxem informacyjnym.
*
* \param parent Identyfikator akcji-rodzica
* \param title Tytu³ boxa
* \param info TreϾ informacji (html)
* \param ico URL ikonki/obrazka
* \param height Wysokoœæ treœci (Najlepiej podaæ ujemn¹ liczbê wierszy przy minimalnej szerokoœci...)
* \param icoWidth Szerokoœæ ikonki (domyœlnie 32)
* \param icoHeight Wysokoœæ ikonki (domyœlnie taka sama jak szerokoœæ)
*/
void UIActionCfgAddInfoBox(unsigned int parent, const char * title, const char * info, const char * ico, int height = 0, int icoWidth=0, int icoHeight=0);
/** Dodaje standardowy zestaw akcji z boxem informacyjnym.
*
* \param parent Identyfikator akcji-rodzica
* \param title Tytu³ boxa
* \param info TreϾ informacji (html)
* \param ico identyfikator ikonki na liœcie IML_16, lub IML_32
* \param height Wysokoœæ treœci (Najlepiej podaæ ujemn¹ liczbê wierszy przy minimalnej szerokoœci...)
* \param icoSize Szerokoœæ/Wysokoœæ ikonki (domyœlnie 32)
*/
void UIActionCfgAddInfoBox(unsigned int parent, const char * title, const char * info, unsigned int ico, int height = 0, int icoSize=32);
/** Dodaje standardowy zestaw akcji z boxem opisuj¹cym wtyczkê.
* \param parent Identyfikator akcji-rodzica
* \param info Tekst (html) z informacj¹ o wtyczce
* \param ico URL do ikonki
* \param height Wysokoœæ tekstu. Najlepiej podaæ ujemn¹ liczbê wierszy przy minimalnej szerokoœci...
* \param name Nazwa wtyczki do wyœwietlenia. Je¿eli pominiesz ten parametr, zarówno nazwa jak i wersja zostan¹ pobrane automatycznie.
*/
void UIActionCfgAddPluginInfoBox(unsigned int parent, const char * info, const char * ico = 0, int height = 0, const char * name=0);
/** Dodaje standardowy zestaw akcji z boxem opisuj¹cym wtyczkê i przyciskiem z logiem i tipem z dodatkowymi informacjami.
* \param parent Identyfikator akcji-rodzica
* \param info Tekst (html) z informacj¹ o funkcjonalnoœci
* \param about_info Tekst (html) z dodatkowymi informacjami o wtyczce
* \param ico URL do ikonki
* \param height Wysokoœæ tekstu. Najlepiej podaæ ujemn¹ liczbê wierszy przy minimalnej szerokoœci...
* \param name Nazwa wtyczki do wyœwietlenia. Je¿eli pominiesz ten parametr, zarówno nazwa jak i wersja zostan¹ pobrane automatycznie.
*/
void UIActionCfgAddPluginInfoBox2(unsigned int parent, const char * info, const char * about_info, const char * ico = 0, int height = 0, const char * name=0, bool frame = true);
/// \} // imi_action
/** @defgroup icon_makra Funkcje do ikonek
@{
*/
/** \brief \no */
int IconRegister(IML_enum target , int ID , const char * URL);
/** \brief \no */
int IconRegister(IML_enum target , int ID , HINSTANCE inst , int icoID , int type = 1);
/** \brief \no */
int IconRegister(IML_enum target , int ID , HANDLE image, int type = 1);
/** \brief \no */
int IconRegisterList(IML_enum target , int count , int * IDList , HANDLE image , HANDLE mask=0 , int w = 0);
#ifdef _INC_COMMCTRL
/** \brief \no */
int IconRegisterList(IML_enum target , int count , int * IDList , HIMAGELIST ImageList);
#endif
/** @} */
/** \blank \no */
bool GetExtParam(const char * ext , const char * name , char * valueBuff , size_t buffSize);
/** \blank \no */
bool SetExtParam(const char * ext , const char * name , const char * value , char * extBuff , size_t buffSize);
#ifdef _STRING_
/** \blank \no */
std::string GetExtParam(const std::string ext , const std::string name);
/** \blank \no */
std::string SetExtParam(const std::string ext , const std::string name , const std::string value);
/** Zwraca wartoœæ parametrów przekazywanych do kontrolek konfiguracji w sUIActionInfo::txt
*/
std::string GetActParam(const std::string & txt , const std::string & param);
/** Ustawia wartoœæ parametrów przekazywanych do kontrolek konfiguracji w sUIActionInfo::txt */
std::string SetActParam(const std::string & txt , const std::string & param , const std::string & value);
bool ActParamExists(const std::string & txt , const std::string & param);
bool ParamSpecialChar(unsigned char ch);
#endif
/** Ustawia status kontaktu. */
int CntSetStatus(unsigned int cntID , unsigned int status , const char * info = 0);
/** Powinno byæ uruchomione zaraz przed zmian¹ statusu wtyczki. */
int PlugStatusChange(unsigned int status , const char * info = 0);
/** Zapisuje wartoœæ tekstow¹ kontaktu w tablicy, lub oknie "Wiêcej" w zale¿noœci od @a toWindow.
Przydatne przy #IM_CNT_DOWNLOAD...
@param toWindow (bool) czy ma zapisywaæ do okna
*/
void CntSetInfoValue(bool toWindow , int cntID , int colID , const char * value);
/** Pobiera wartoœæ tekstow¹ kontaktu w tablicy, lub oknie "Wiêcej" w zale¿noœci od @a fromWindow.
Przydatne przy #IM_CNT_UPLOAD...
@param fromWindow (bool) czy ma pobieraæ z okna
*/
const char * CntGetInfoValue(bool fromWindow , int cntID , int colID);
/** Tworzy kolumnê w konfiguracji (@ref #IMC_SETCOL) */
int SetColumn(tTable table , int id , int type , int def , const char * name=0);
/** Tworzy kolumnê w konfiguracji (@ref #IMC_SETCOL) */
inline int SetColumn(tTable table , int id , int type , const char * def , const char * name=0) {
return SetColumn(table , id , type , (int)def , name);
}
/** Tworzy kopie cMessage.
Wykorzystywane, gdy po odebraniu np. #IM_MSG_SEND wysy³amy wiadomoœæ
w osobnym w¹tku. Tworzymy kopiê w IMessageProcess, a zwalniamy
na koñcu w¹tku. F-cja alokuje ca³¹ strukturê!
*/
cMessage * messageDuplicate(cMessage * m);
/** Zwalnia cMessage (to co zaalokowa³ messageDuplicate. */
void messageFree(cMessage * m, bool deleteObject = true);
void testResult(const char * title, int should, int got, bool swap = false);
void testResult(const char * title, const char * should, const char * got, bool swap = false);
inline void testResult(int should, int got, bool swap = false) {
testResult("", should, got, swap);
}
inline void testResult(const char * should, const char * got, bool swap = false) {
testResult("", should, got, swap);
}
/** Zamienia cztery parametry wersji w liczbe typu long. */
#define VERSION_TO_NUM(maj,min,rls,bld) ((((maj)&0xF)<<28) | (((min)&0xFF)<<20) | (((rls)&0xFF)<<12) | ((bld)&0xFFF))
#define VERSION_MAJ(ver) (((ver)>>28)&0xF)
#define VERSION_MIN(ver) (((ver)>>20)&0xFF)
#define VERSION_RLS(ver) (((ver)>>12)&0xFF)
#define VERSION_BLD(ver) ((ver)&0xFFF)
#endif