Google Git
Sign in
goma / wine / ee65d59cf6866932b659bec7d2a609078e38fb02 / . / documentation / dlls.sgml
blob: a1a763368d9b6a6d37005546462e7cc8d9b06e16 [file] [log] [blame]
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]1 <chapter id="dlls">
2 <title>Wine Builtin DLLs Overview</title>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]3 <para>A more detailed look at Wine's builtin DLLs...</para>
4
5 <sect1 id="common-controls">
6 <title>Common Controls</title>
7
8 <!-- FIXME: Huh? Subtitle element not available here?!? -->
9 <bridgehead renderas="sect3">
10 Their development status and their UNDOCUMENTED features and functions
11 </bridgehead>
12
13 <para>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]14 Written by &name-eric-kohl; <email>&email-eric-kohl;</email>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]15 </para>
16 <para>
17 (Extracted from <filename>wine/documentation/common_controls</filename>)
18 </para>
19
20
21 <sect2>
22 <title>1. Introduction</title>
23
24 <para>
25 The information provided herein is based on the dll version
26 4.72 which is included in MS Internet Explorer 4.01.
27 </para>
28 <para>
29 All information about common controls should be collected in this document.
30 </para>
31 <para>
32 All Wine programmers are encouraged to add their knowledge to this document.
33 </para>
34 </sect2>
35
36 <sect2>
37 <title>2. General Information</title>
38
39 <para>
40 Further information about common controls can be found in
41 the MS Platform SDK and the MS Internet Client SDK (most
42 recent). Information from these SDK's will NOT be repeated
43 here. Only information which can NOT be found in these SDK's
44 will be collected here. Some information in the SDK's
45 mentioned above is (intentionally???) WRONG. Corrections to
46 wrong information will be collected here too.
47 </para>
48
49 <sect3>
50 <title>2.1 Structure sizes of different common control versions</title>
51
52 <para>
53 The common controls have been continously improved in the
54 past. Some of the orignal structures had to be extended
55 and their size changed. Most of the common control
56 structures include their size as the first parameter. If a
57 control gets the wrong size in a message or function a
58 failure is very likely to occur. To avoid this, MS defined
59 new constants that reflect the structure size of older
60 <filename>COMCTL32.DLL</filename> versions. The following
61 list shows the structure size constants that are currently
62 defined in the original <filename>COMCTL32.DLL</filename>.
63 </para>
64 <note>
65 <para>
66 Some stuctures are NOT defined in wine's COMCTL32 yet.
67 </para>
68 </note>
69
70 <variablelist>
71 <varlistentry>
72 <term><varname>HDITEM_V1_SIZE</varname>:</term>
73 <listitem>
74 <para>The size of the <structname>HDITEM</structname>
75 structure in version 4.00.</para>
76 </listitem>
77 </varlistentry>
78 <varlistentry>
79 <term><varname>LVCOLUMN_V1_SIZE</varname>:</term>
80 <listitem>
81 <para>The size of the
82 <structname>LVCOLUMN</structname> structure in
83 version 4.00.</para>
84 </listitem>
85 </varlistentry>
86 <varlistentry>
87 <term><varname>LVHITTESTINFO_V1_SIZE</varname>:</term>
88 <listitem>
89 <para>The size of the
90 <structname>LVHITTESTINFO</structname> structure in
91 version 4.00.</para>
92 </listitem>
93 </varlistentry>
94 <varlistentry>
95 <term><varname>LVITEM_V1_SIZE</varname>:</term>
96 <listitem>
97 <para>The size of the <structname>LVITEM</structname>
98 structure in version 4.00.</para>
99 </listitem>
100 </varlistentry>
101 <varlistentry>
102 <term><varname>NMLVCUSTOMDRAW_V3_SIZE</varname>:</term>
103 <listitem>
104 <para>The size of the
105 <structname>NMLVCUSTOMDRAW</structname> structure in
106 version 4.70.</para>
107 </listitem>
108 </varlistentry>
109 <varlistentry>
110 <term><varname>NMTTDISPINFO_V1_SIZE</varname>:</term>
111 <listitem>
112 <para>The size of the
113 <structname>NMTTDISPINFO</structname> structure in
114 version 4.00.</para>
115 </listitem>
116 </varlistentry>
117 <varlistentry>
118 <term><varname>NMTVCUSTOMDRAW_V3_SIZE</varname>:</term>
119 <listitem>
120 <para>The size of the
121 <structname>NMTVCUSTOMDRAW</structname> structure in
122 version 4.70.</para>
123 </listitem>
124 </varlistentry>
125 <varlistentry>
126 <term><varname>PROPSHEETHEADER_V1_SIZE</varname>:</term>
127 <listitem>
128 <para>The size of the
129 <structname>PROPSHEETHEADER</structname> structure
130 in version 4.00.</para>
131 </listitem>
132 </varlistentry>
133 <varlistentry>
134 <term><varname>PROPSHEETPAGE_V1_SIZE</varname>:</term>
135 <listitem>
136 <para>The size of the
137 <structname>PROPSHEETPAGE</structname> structure in
138 version 4.00.</para>
139 </listitem>
140 </varlistentry>
141 <varlistentry>
142 <term><varname>REBARBANDINFO_V3_SIZE</varname>:</term>
143 <listitem>
144 <para>The size of the
145 <structname>REBARBANDINFO</structname> structure in
146 version 4.70.</para>
147 </listitem>
148 </varlistentry>
149 <varlistentry>
150 <term><varname>TTTOOLINFO_V1_SIZE</varname>:</term>
151 <listitem>
152 <para>The size of the
153 <structname>TOOLINFO</structname> structure in
154 version 4.00.</para>
155 </listitem>
156 </varlistentry>
157 <varlistentry>
158 <term><varname>TVINSERTSTRUCT_V1_SIZE</varname>:</term>
159 <listitem>
160 <para>The size of the
161 <structname>TVINSERTSTRUCT</structname> structure in
162 version 4.00.</para>
163 </listitem>
164 </varlistentry>
165 </variablelist>
166 </sect3>
167 </sect2>
168
169 <sect2>
170 <title>3. Controls</title>
171
172 <para>
173 This section describes the development status of the common controls.
174 </para>
175
176 <sect3>
177 <title>3.1 Animation Control</title>
178
179 <variablelist>
180 <varlistentry>
181 <term>Author:</term>
182 <listitem>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]183 <para>
184 Dummy written by &name-eric-kohl; <email>&email-eric-kohl;</email>
185 </para>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]186 </listitem>
187 </varlistentry>
188 <varlistentry>
189 <term>Status:</term>
190 <listitem>
191 <para>Dummy control. No functionality.</para>
192 </listitem>
193 </varlistentry>
194 <varlistentry>
195 <term> Notes:</term>
196 <listitem>
197 <para>Author needed!! Any volunteers??</para>
198 </listitem>
199 </varlistentry>
200 </variablelist>
201 </sect3>
202
203 <sect3>
204 <title>3.2 Combo Box Ex Control</title>
205
206 <variablelist>
207 <varlistentry>
208 <term>Author:</term>
209 <listitem>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]210 <para>
211 Dummy written by &name-eric-kohl; <email>&email-eric-kohl;</email>
212 </para>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]213 </listitem>
214 </varlistentry>
215 <varlistentry>
216 <term>Status:</term>
217 <listitem>
218 <para>Dummy control. No functionality.</para>
219 </listitem>
220 </varlistentry>
221 <varlistentry>
222 <term>Notes:</term>
223 <listitem>
224 <para>Author needed!! Any volunteers??</para>
225 </listitem>
226 </varlistentry>
227 </variablelist>
228 </sect3>
229
230 <sect3>
231 <title>3.3 Date and Time Picker Control</title>
232
233 <variablelist>
234 <varlistentry>
235 <term>Author:</term>
236 <listitem>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]237 <para>
238 Dummy written by &name-eric-kohl; <email>&email-eric-kohl;</email>
239 </para>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]240 </listitem>
241 </varlistentry>
242 <varlistentry>
243 <term>Status:</term>
244 <listitem>
245 <para>Dummy control. No functionality.</para>
246 </listitem>
247 </varlistentry>
248 <varlistentry>
249 <term>Notes:</term>
250 <listitem>
251 <para>Author needed!! Any volunteers??</para>
252 </listitem>
253 </varlistentry>
254 </variablelist>
255 </sect3>
256
257 <sect3>
258 <title>3.4 Drag List Box Control</title>
259
260 <variablelist>
261 <varlistentry>
262 <term>Author:</term>
263 <listitem>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]264 <para>
265 Dummy written by &name-eric-kohl; <email>&email-eric-kohl;</email>
266 </para>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]267 </listitem>
268 </varlistentry>
269 <varlistentry>
270 <term>Status:</term>
271 <listitem>
272 <para>Dummy control. No functionality.</para>
273 </listitem>
274 </varlistentry>
275 <varlistentry>
276 <term>Notes:</term>
277 <listitem>
278 <para>Author needed!! Any volunteers??</para>
279 </listitem>
280 </varlistentry>
281 </variablelist>
282 </sect3>
283
284 <sect3>
285 <title>3.5 Flat Scroll Bar Control</title>
286
287 <variablelist>
288 <varlistentry>
289 <term>Author:</term>
290 <listitem>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]291 <para>
292 Dummy written by &name-alex-priem; <email>&email-alex-priem;</email>
293 </para>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]294 </listitem>
295 </varlistentry>
296 <varlistentry>
297 <term>Status:</term>
298 <listitem>
299 <para>Dummy control. No functionality.</para>
300 </listitem>
301 </varlistentry>
302 <varlistentry>
303 <term>Notes:</term>
304 <listitem>
305 <para>Author needed!! Any volunteers??</para>
306 </listitem>
307 </varlistentry>
308 </variablelist>
309 </sect3>
310
311 <sect3>
312 <title>3.6 Header Control</title>
313
314 <variablelist>
315 <varlistentry>
316 <term>Author:</term>
317 <listitem>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]318 <para>
319 Dummy written by &name-eric-kohl; <email>&email-eric-kohl;</email>
320 </para>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]321 </listitem>
322 </varlistentry>
323 <varlistentry>
324 <term>Status:</term>
325 <listitem>
326 <itemizedlist>
327 <listitem>
328 <para>Almost finished.</para>
329 </listitem>
330 <listitem>
331 <para>Unicode notifications are not supported (WM_NOTIFYFORMAT).</para>
332 </listitem>
333 <listitem>
334 <para>Order array not supported.</para>
335 </listitem>
336 </itemizedlist>
337 </listitem>
338 </varlistentry>
339 </variablelist>
340 </sect3>
341
342 <sect3>
343 <title>3.7 Hot Key Control</title>
344
345 <variablelist>
346 <varlistentry>
347 <term>Author:</term>
348 <listitem>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]349 <para>
350 Written by &name-eric-kohl; <email>&email-eric-kohl;</email>
351 </para>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]352 </listitem>
353 </varlistentry>
354 <varlistentry>
355 <term>Status:</term>
356 <listitem>
357 <para>Dummy control. No functionality.</para>
358 </listitem>
359 </varlistentry>
360 <varlistentry>
361 <term>Notes:</term>
362 <listitem>
363 <para>Author needed!! Any volunteers??</para>
364 </listitem>
365 </varlistentry>
366 </variablelist>
367 </sect3>
368
369 <sect3>
370 <title>3.8 Image List (no control)</title>
371
372 <variablelist>
373 <varlistentry>
374 <term>Author:</term>
375 <listitem>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]376 <para>
377 Dummy written by &name-eric-kohl; <email>&email-eric-kohl;</email>
378 </para>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]379 </listitem>
380 </varlistentry>
381 <varlistentry>
382 <term>Status:</term>
383 <listitem>
384 <para>Almost finished.</para>
385 </listitem>
386 </varlistentry>
387 </variablelist>
388 </sect3>
389
390 <sect3>
391 <title>3.9 IP Address Control</title>
392
393 <variablelist>
394 <varlistentry>
395 <term>Author:</term>
396 <listitem>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]397 <para>
398 Dummy written by &name-eric-kohl; <email>&email-eric-kohl;</email>,
399 &name-alex-priem; <email>&email-alex-priem;</email>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]400 </para>
401 </listitem>
402 </varlistentry>
403 <varlistentry>
404 <term>Status:</term>
405 <listitem>
406 <para>Under construction.</para>
407 </listitem>
408 </varlistentry>
409 </variablelist>
410 </sect3>
411
412 <sect3>
413 <title>3.10 List View Control</title>
414
415 <variablelist>
416 <varlistentry>
417 <term>Author:</term>
418 <listitem>
419 <para>Dummy written by: </para>
420 <itemizedlist>
421 <listitem>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]422 <para>
423 Written by &name-eric-kohl; <email>&email-eric-kohl;</email>
424 </para>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]425 </listitem>
426 <listitem>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]427 <para>&name-luc-tourangeau; <email>&email-luc-tourangeau;</email></para>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]428 </listitem>
429 <listitem>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]430 <para>&name-koen-deforche; <email>&email-koen-deforche;</email></para>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]431 </listitem>
432 <listitem>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]433 <para>&name-francis-beaudet; <email>&email-francis-beaudet;</email>
434 and the "Corel Team"</para>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]435 </listitem>
436 </itemizedlist>
437 </listitem>
438 </varlistentry>
439
440 <varlistentry>
441 <term>Status:</term>
442 <listitem>
443 <para>Under construction.</para>
444 </listitem>
445 </varlistentry>
446 <varlistentry>
447 <term>Notes:</term>
448 <listitem>
449 <para>
450 Basic data structure with related messages are
451 supported. No painting supported yet.
452 </para>
453 </listitem>
454 </varlistentry>
455 </variablelist>
456 </sect3>
457
458 <sect3>
459 <title>3.11 Month Calendar Control</title>
460
461 <variablelist>
462 <varlistentry>
463 <term>Author:</term>
464 <listitem>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]465 <para>
466 Written by &name-eric-kohl; <email>&email-eric-kohl;</email>
467 </para>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]468 </listitem>
469 </varlistentry>
470 <varlistentry>
471 <term>Status:</term>
472 <listitem>
473 <para>Dummy control. No functionality.</para>
474 </listitem>
475 </varlistentry>
476 <varlistentry>
477 <term>Notes:</term>
478 <listitem>
479 <para>Author needed!! Any volunteers??</para>
480 </listitem>
481 </varlistentry>
482 </variablelist>
483 </sect3>
484
485 <sect3>
486 <title>3.12 Native font control</title>
487
488 <variablelist>
489 <varlistentry>
490 <term>Author:</term>
491 <listitem>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]492 <para>
493 Written by &name-eric-kohl; <email>&email-eric-kohl;</email>
494 </para>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]495 </listitem>
496 </varlistentry>
497 <varlistentry>
498 <term>Status:</term>
499 <listitem>
500 <para>Dummy control. No functionality.</para>
501 </listitem>
502 </varlistentry>
503 <varlistentry>
504 <term>Notes:</term>
505 <listitem>
506 <para>Author needed!! Any volunteers??</para>
507 </listitem>
508 </varlistentry>
509 </variablelist>
510 </sect3>
511
512 <sect3>
513 <title>3.13 Pager Control</title>
514
515 <variablelist>
516 <varlistentry>
517 <term>Author:</term>
518 <listitem>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]519 <para>
520 Written by &name-eric-kohl; <email>&email-eric-kohl;</email>
521 </para>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]522 </listitem>
523 </varlistentry>
524 <varlistentry>
525 <term>Status:</term>
526 <listitem>
527 <para>
528 Under construction. Many missing features.
529 </para>
530 </listitem>
531 </varlistentry>
532 <varlistentry>
533 <term>Notes:</term>
534 <listitem>
535 <para>Author needed!! Any volunteers??</para>
536 </listitem>
537 </varlistentry>
538 </variablelist>
539 </sect3>
540
541 <sect3>
542 <title>3.14 Progress Bar Control</title>
543
544 <variablelist>
545 <varlistentry>
546 <term>Author:</term>
547 <listitem>
548 <para>
549 Original implementation by Dimitrie O. Paun. Fixes
550 and improvements by Eric Kohl.
551 </para>
552 </listitem>
553 </varlistentry>
554 <varlistentry>
555 <term>Status:</term>
556 <listitem>
557 <para>Finished!</para>
558 </listitem>
559 </varlistentry>
560 </variablelist>
561 </sect3>
562
563 <sect3>
564 <title>3.15 Property Sheet</title>
565
566 <variablelist>
567 <varlistentry>
568 <term>Author:</term>
569 <listitem>
570 <para>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]571 &name-anders-carlsson; <email>&email-anders-carlsson;</email> and
572 &name-francis-beaudet; <email>&email-francis-beaudet;</email>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]573 </para>
574 </listitem>
575 </varlistentry>
576 <varlistentry>
577 <term>Status:</term>
578 <listitem>
579 <para>Development in progress.</para>
580 </listitem>
581 </varlistentry>
582 <varlistentry>
583 <term>Notes:</term>
584 <listitem>
585 <para>Tab control must be implemented first.</para>
586 </listitem>
587 </varlistentry>
588 </variablelist>
589 </sect3>
590
591 <sect3>
592 <title>3.16 Rebar Control (Cool Bar)</title>
593
594 <variablelist>
595 <varlistentry>
596 <term>Author:</term>
597 <listitem>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]598 <para>
599 Written by &name-eric-kohl; <email>&email-eric-kohl;</email>
600 </para>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]601 </listitem>
602 </varlistentry>
603 <varlistentry>
604 <term>Status:</term>
605 <listitem>
606 <para>Development in progress. Many bugs and missing features.</para>
607 </listitem>
608 </varlistentry>
609 <varlistentry>
610 <term>Notes:</term>
611 <listitem>
612 <para>Author needed!! Any volunteers??</para>
613 </listitem>
614 </varlistentry>
615 </variablelist>
616 </sect3>
617
618 <sect3>
619 <title>3.17 Status Bar Control</title>
620
621 <variablelist>
622 <varlistentry>
623 <term>Author:</term>
624 <listitem>
625 <para>
626 Original implementation by Bruce Milner. Fixes and
627 improvements by Eric Kohl.
628 </para>
629 </listitem>
630 </varlistentry>
631 <varlistentry>
632 <term>Status:</term>
633 <listitem>
634 <para>Almost finished.</para>
635 </listitem>
636 </varlistentry>
637 <varlistentry>
638 <term>Notes:</term>
639 <listitem>
640 <para>Tooltip integration is almost complete.</para>
641 </listitem>
642 </varlistentry>
643 </variablelist>
644 </sect3>
645
646 <sect3>
647 <title>3.18 Tab Control</title>
648
649 <variablelist>
650 <varlistentry>
651 <term>Author:</term>
652 <listitem>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]653 <para>
654 &name-anders-carlsson; <email>&email-anders-carlsson;</email>
655 </para>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]656 </listitem>
657 </varlistentry>
658 <varlistentry>
659 <term>Status:</term>
660 <listitem>
661 <para>Development in progress.</para>
662 </listitem>
663 </varlistentry>
664 </variablelist>
665 </sect3>
666
667 <sect3>
668 <title>3.19 Toolbar Control</title>
669
670 <variablelist>
671 <varlistentry>
672 <term>Author:</term>
673 <listitem>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]674 <para>
675 Written by &name-eric-kohl; <email>&email-eric-kohl;</email>
676 </para>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]677 </listitem>
678 </varlistentry>
679 <varlistentry>
680 <term>Status:</term>
681 <listitem>
682 <para>
683 Development in progress. Basic functionality is
684 almost done. (dll version 4.0)
685 </para>
686 </listitem>
687 </varlistentry>
688 </variablelist>
689 </sect3>
690
691 <sect3>
692 <title>3.20 Tooltip Control</title>
693
694 <variablelist>
695 <varlistentry>
696 <term>Author:</term>
697 <listitem>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]698 <para>
699 Written by &name-eric-kohl; <email>&email-eric-kohl;</email>
700 </para>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]701 </listitem>
702 </varlistentry>
703 <varlistentry>
704 <term>Status:</term>
705 <listitem>
706 <para>Almost finished.</para>
707 </listitem>
708 </varlistentry>
709 <varlistentry>
710 <term>Notes:</term>
711 <listitem>
712 <para>Unicode support is incomplete
713 (<constant>WM_NOTIFYFORMAT</constant>).</para>
714 </listitem>
715 </varlistentry>
716 </variablelist>
717 </sect3>
718
719 <sect3>
720 <title>3.21 Trackbar Control</title>
721
722 <variablelist>
723 <varlistentry>
724 <term>Author:</term>
725 <listitem>
726 <para>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]727 Written by &name-eric-kohl; <email>&email-eric-kohl;</email> and
728 &name-alex-priem; <email>&email-alex-priem;</email>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]729 </para>
730 </listitem>
731 </varlistentry>
732 <varlistentry>
733 <term>Status:</term>
734 <listitem>
735 <para>Under construction.</para>
736 </listitem>
737 </varlistentry>
738 </variablelist>
739 </sect3>
740
741 <sect3>
742 <title>3.22 Tree View Control</title>
743
744 <variablelist>
745 <varlistentry>
746 <term>Author:</term>
747 <listitem>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]748 <para>
749 Written by &name-eric-kohl; <email>&email-eric-kohl;</email> and
750 &name-alex-priem; <email>&email-alex-priem;</email>, fixes by
751 &name-aric-stewart; <email>&email-aric-stewart;</email>
752 </para>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]753 </listitem>
754 </varlistentry>
755 <varlistentry>
756 <term>Status:</term>
757 <listitem>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]758 <para>Quite usable already.</para>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]759 </listitem>
760 </varlistentry>
761 </variablelist>
762 </sect3>
763
764 <sect3>
765 <title>3.23 Updown Control</title>
766
767 <variablelist>
768 <varlistentry>
769 <term>Author:</term>
770 <listitem>
771 <para>
772 Original implementation by Dimitrie O. Paun.
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]773 Some minor changes by &name-eric-kohl; <email>&email-eric-kohl;</email>.
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]774 </para>
775 </listitem>
776 </varlistentry>
777 <varlistentry>
778 <term>Status:</term>
779 <listitem>
780 <para>Unknown.</para>
781 </listitem>
782 </varlistentry>
783 </variablelist>
784
785 <note>
786 <title>Notes</title>
787 <para>
788 Have a look at <filename>controls/updown.c</filename>
789 for a list of bugs and missing features.
790 </para>
791 <para>
792 The status is unknown, because I did not have a close
793 look at this control. One test-program looked quite
794 good, but in Win95's <filename>cdplayer.exe</filename>
795 the control does not show at all.
796 </para>
797 <para>
798 Any volunteers??
799 </para>
800 </note>
801 </sect3>
802 </sect2>
803
804 <sect2>
805 <title>4. Additional Information</title>
806
807 <para>
808 Has to be written...
809 </para>
810 </sect2>
811
812 <sect2>
813 <title>5. Undocumented features</title>
814
815 <para>
816 There are quite a lot of undocumented functions like:
817 </para>
818 <itemizedlist>
819 <listitem>
820 <para>DSA (Dynamic Storage Array) functions.</para>
821 </listitem>
822 <listitem>
823 <para>DPA (Dynamic Pointer Array) functions.</para>
824 </listitem>
825 <listitem>
826 <para>MRU ("Most Recently Used" List) functions.</para>
827 </listitem>
828 <listitem>
829 <para>other unknown functions.</para>
830 </listitem>
831 </itemizedlist>
832
833 <para>
834 Have a look at <filename>relay32/comctl32.spec</filename>.
835 </para>
836
837 <sect3>
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]838 <title>5.1 Dynamic Storage Array (DSA)</title>
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]839
840 <para>
841 The DSA functions are used to store and manage dynamic
842 arrays of fixed size memory blocks. They are used by
843 <filename>TASKMAN.EXE</filename>, Explorer, IE4 and other
844 Programs and DLL's that are "parts of the Windows
845 Operating System". The implementation should be complete.
846 </para>
847 <para>
848 Have a look at the source code to get more information.
849 </para>
850 </sect3>
851
852 <sect3>
853 <title>5.2 Dynamic Pointer Array (DPA)</title>
854
855 <para>
856 Similar to the DSA functions, but they just store
857 pointers. They are used by Explorer, IE4 and other
858 Programs and DLL's that are "parts of the Windows
859 Operating System". The implementation should be complete.
860 </para>
861 <para>
862 Have a look at the source code to get more information.
863 </para>
864 </sect3>
865
866 <sect3>
867 <title>5.3 "Most Recently Used" - List (MRU)</title>
868
869 <para>
870 Only stubs are implemented to keep Explorer from bailing out.
871 </para>
872 <para>
873 No more information available at this time!
874 </para>
875 </sect3>
876
877 <sect3>
878 <title>5.4 MenuHelp</title>
879
880 <para>
881 Has to be written...
882 </para>
883 </sect3>
884
885 <sect3>
886 <title>5.5 GetEffectiveClientRect</title>
887
888 <para>
889 Has to be written...
890 </para>
891 </sect3>
892
893 <sect3>
894 <title>5.6 ShowHideMenuCtl</title>
895
896 <para>
897 The official documentation provided by MS is incomplete.
898 </para>
899
900 <variablelist>
901 <varlistentry>
902 <term><varname>lpInfo</varname>:</term>
903 <listitem>
904 <blockquote>
905 <para>
906 Both values of the first pair must be the handle
907 to the applications main menu.
908 </para>
909 </blockquote>
910 </listitem>
911 </varlistentry>
912 </variablelist>
913 </sect3>
914
915 <sect3>
916 <title>5.7 Other undocumented functions</title>
917
918 <para>
919 Several other undocumented functions are used by IE4.
920 </para>
921 <para>
922 String functions: (will be written...)
923 </para>
924 </sect3>
925 </sect2>
926
927 <sect2>
928 <title>6. Epilogue</title>
929
930 <para>
931 You see, much work has still to be done. If you are
932 interested in writing a control send me an e-mail. If you
933 like to fix bugs or add some functionality send an e-mail to
934 the author of the control.
935 </para>
936 </sect2>
937 </sect1>
938 </chapter>
939
940<!-- Keep this comment at the end of the file
941Local variables:
942mode: sgml
John R. Sheetsd9e064f2000-12-13 21:52:37 +0000[diff] [blame]943sgml-parent-document:("wine-doc.sgml" "set" "book" "part" "chapter" "")
John R. Sheets1e8e5ba2000-08-08 01:24:00 +0000[diff] [blame]944End:
945-->