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
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
|
COMMON CONTROLS
their development status
and their UNDOCUMENTED features and functions
-----------------------------------------------------
1. Introduction
---------------
The information provided herein is based on the dll version 4.72 which
is included in MS Internet Explorer 4.01.
All information about common controls should be collected in this document.
All Wine programmers are encouraged to add their knowledge to this document.
2. General Information
----------------------
Further information about common controls can be found in the MS Platform SDK
and the MS Internet Client SDK (most recent). Information from these SDK's
will NOT be repeated here. Only information which can NOT be found in these
SDK's will be collected here. Some information in the SDK's mentioned above
is (intentionally???) WRONG. Corrections to wrong information will be
collected here too.
2.1 Structure sizes of different common control versions
--------------------------------------------------------
The common controls have been continously improved in the past. Some of the
orignal structures had to be extended and their size changed. Most of the
common control structures include their size as the first parameter. If
a control gets the wrong size in a message or function a failure is very
likely to occur. To avoid this, MS defined new constants that reflect the
structure size of older COMCTL32.DLL versions. The following list shows the
structure size constants that are currently defined in the original
COMCTL32.DLL.
NOTE: Some stuctures are NOT defined in wine's COMCTL32 yet.
HDITEM_V1_SIZE:
The size of the HDITEM structure in version 4.00.
LVCOLUMN_V1_SIZE:
The size of the LVCOLUMN structure in version 4.00.
LVHITTESTINFO_V1_SIZE:
The size of the LVHITTESTINFO structure in version 4.00.
LVITEM_V1_SIZE:
The size of the LVITEM structure in version 4.00.
NMLVCUSTOMDRAW_V3_SIZE:
The size of the NMLVCUSTOMDRAW structure in version 4.70.
NMTTDISPINFO_V1_SIZE:
The size of the NMTTDISPINFO structure in version 4.00.
NMTVCUSTOMDRAW_V3_SIZE:
The size of the NMTVCUSTOMDRAW structure in version 4.70.
PROPSHEETHEADER_V1_SIZE:
The size of the PROPSHEETHEADER structure in version 4.00.
PROPSHEETPAGE_V1_SIZE:
The size of the PROPSHEETPAGE structure in version 4.00.
REBARBANDINFO_V3_SIZE:
The size of the REBARBANDINFO structure in version 4.70.
TTTOOLINFO_V1_SIZE:
The size of the TOOLINFO structure in version 4.00.
TVINSERTSTRUCT_V1_SIZE:
The size of the TVINSERTSTRUCT structure in version 4.00.
3. Controls
-----------
This paragraph describes the development status of the common controls.
3.1 Animation Control
---------------------
Author:
Dummy written by Eric Kohl. <ekohl@abo.rhein-zeitung.de>
Status:
Dummy control. No functionality.
Notes:
Author needed!! Any volunteers??
3.2 Combo Box Ex Control
------------------------
Author:
Dummy written by Eric Kohl. <ekohl@abo.rhein-zeitung.de>
Status:
Dummy control. No functionality.
Notes:
Author needed!! Any volunteers??
3.3 Date and Time Picker Control
--------------------------------
Author:
Dummy written by Eric Kohl. <ekohl@abo.rhein-zeitung.de>
Status:
Dummy control. No functionality.
Notes:
Author needed!! Any volunteers??
3.4 Drag List Box Control
-------------------------
Author:
Dummy written by Eric Kohl. <ekohl@abo.rhein-zeitung.de>
Status:
Dummy control. No functionality.
Notes:
Author needed!! Any volunteers??
3.5 Flat Scroll Bar Control
---------------------------
Author:
Dummy written by Alex Priem. <alexp@sci.kun.nl>
Status:
Dummy control. No functionality.
Notes:
Author needed!! Any volunteers??
3.6 Header Control
------------------
Author:
Eric Kohl <ekohl@abo.rhein-zeitung.de>
Status:
Almost finished.
Unicode notifications are not supported (WM_NOTIFYFORMAT).
Order array not supported.
3.7 Hot Key Control
-------------------
Author:
Dummy written by Eric Kohl. <ekohl@abo.rhein-zeitung.de>
Status:
Dummy control. No functionality.
Notes:
Author needed!! Any volunteers??
3.8 Image List (no control)
---------------------------
Author:
Eric Kohl <ekohl@abo.rhein-zeitung.de>
Status:
Almost finished.
3.9 IP Address Control
----------------------
Author:
Dummy written by Eric Kohl. <ekohl@abo.rhein-zeitung.de>
Alex Priem <alexp@sci.kun.nl>
Status:
Under construction.
3.10 List View Control
----------------------
Author:
Dummy written by Eric Kohl. <ekohl@abo.rhein-zeitung.de>
Luc Tourangeau <luc@macadamian.com>
Koen Deforche <jozef@kotnet.org>
Francis Beaudet <francis@macadamian.com> and the "Corel-Team"
Status:
Under construction.
Notes:
Basic data structure with related messages are supported.
No painting supported yet.
3.11 Month Calendar Control
---------------------------
Author:
Dummy written by Eric Kohl. <ekohl@abo.rhein-zeitung.de>
Status:
Dummy control. No functionality.
Notes:
Author needed!! Any volunteers??
3.12 Native font control
------------------------
Author:
Dummy written by Eric Kohl. <ekohl@abo.rhein-zeitung.de>
Status:
Dummy control. No functionality.
Notes:
Author needed!! Any volunteers??
3.13 Pager Control
------------------
Author:
Dummy written by Eric Kohl. <ekohl@abo.rhein-zeitung.de>
Status:
Under construction.
Many missing features.
Notes:
Author needed!! Any volunteers??
3.14 Progress Bar Control
-------------------------
Author:
Original implementation by Dimitrie O. Paun.
Fixes and improvements by Eric Kohl.
Status:
Finished!
3.15 Property Sheet
-------------------
Author:
Anders Carlsson <anders.carlsson@linux.nu>
Francis Beaudet <francis@macadamian.com>
Status:
Development in progress.
Notes:
Tab control must be implemented first.
3.16 Rebar Control (Cool Bar)
-----------------------------
Author:
Eric Kohl <ekohl@abo.rhein-zeitung.de>
Status:
Development in progress.
Many bugs and missing features.
Notes:
Author needed!! Any volunteers??
3.17 Status Bar Control
-----------------------
Author:
Original implementation by Bruce Milner.
Fixes and improvements by Eric Kohl.
Status:
Almost finished.
Notes:
Tooltip integration is almost complete.
3.18 Tab Control
----------------
Author:
Anders Carlsson <anders.carlsson@linux.nu>
Status:
Development in progress.
3.19 Toolbar Control
--------------------
Author:
Eric Kohl <ekohl@abo.rhein-zeitung.de>
Status:
Development in progress.
Basic functionality is almost done. (dll version 4.0)
3.20 Tooltip Control
--------------------
Author:
Eric Kohl <ekohl@abo.rhein-zeitung.de>
Status:
Almost finished.
Notes:
Unicode support is incomplete (WM_NOTIFYFORMAT).
3.21 Trackbar Control
---------------------
Author:
Dummy written by Eric Kohl <ekohl@abo.rhein-zeitung.de>
Alex Priem <alexp@sci.kun.nl>
Status:
Under construction.
3.22 Tree View Control
----------------------
Author:
Dummy written by Eric Kohl.
Alex Priem <alexp@sci.kun.nl>
Status:
Under construction.
3.23 Updown Control
-------------------
Author:
Original implementation by Dimitrie O. Paun.
Some minor changes by Eric Kohl <ekohl@abo.rhein-zeitung.de>.
Status:
Unknown.
Notes:
Have a look at controls/updown.c for a list of bugs and missing
features.
The status is unknown, because I did not have a close look at this
control. One test-program looked quite good, but in Win95's
cdplayer.exe the control does not show at all.
Any volunteers??
4. Additional Information
-------------------------
Has to be written...
5. Undocumented features
------------------------
There are quite a lot of undocumented functions like:
- DSA (Dynamic Storage Array) functions.
- DPA (Dynamic Pointer Array) functions.
- MRU ("Most Recently Used" List) functions.
- other unknown functions.
Have a look at relay32/comctl32.spec.
5.1 Dymnamic Storage Array (DSA)
---------------------------------
The DSA functions are used to store and manage dynamic arrays of fixed size
memory blocks. They are used by TASKMAN.EXE, Explorer, IE4 and other
Programs and DLL's that are "parts of the Windows Operating System".
The implementation should be complete.
Have a look at the source code to get more information.
5.2 Dynamic Pointer Array (DPA)
------------------------------------
Similar to the DSA functions, but they just store pointers. They are used by
Explorer, IE4 and other Programs and DLL's that are "parts of the Windows
Operating System". The implementation should be complete.
Have a look at the source code to get more information.
5.3 "Most Recently Used" - List (MRU)
-------------------------------------
Only stubs are implemented to keep Explorer from bailing out.
No more information available at this time!
5.4 MenuHelp
------------
Has to be written...
5.5 GetEffectiveClientRect
--------------------------
Has to be written...
5.6 ShowHideMenuCtl
-------------------
The official documentation provided by MS is incomplete.
lpInfo:
...
Both values of the first pair must be the handle to the applications main
menu.
...
5.7 Other undocumented functions
--------------------------------
Several other undocumented functions are used by IE4.
String functions:
(will be written...)
6. Epilogue
-----------
You see, much work has still to be done. If you are interested in writing
a control send me an e-mail. If you like to fix bugs or add some
functionality send an e-mail to the author of the control.
Eric Kohl <ekohl@abo.rhein-zeitung.de>
|
