git.oblomov.eu Git - wine/blob - documentation/dlls.sgml

   1   <chapter id="dlls">
   2     <title>Wine Builtin DLLs Overview</title>
   3     <para>A more detailed look at Wine's built-in 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>
  14         Written by &name-eric-kohl; <email>&email-eric-kohl;</email>
  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>
 183                 <para>
 184                   Dummy written by &name-eric-kohl; <email>&email-eric-kohl;</email>
 185                 </para>
 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>
 210                 <para>
 211                   Dummy written by &name-eric-kohl; <email>&email-eric-kohl;</email>
 212                 </para>
 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>
 237                 <para>
 238                   Dummy written by &name-eric-kohl; <email>&email-eric-kohl;</email>
 239                 </para>
 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>
 264                 <para>
 265                   Dummy written by &name-eric-kohl; <email>&email-eric-kohl;</email>
 266                 </para>
 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>
 291                 <para>
 292                   Dummy written by &name-alex-priem; <email>&email-alex-priem;</email>
 293                 </para>
 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>
 318                 <para>
 319                   Dummy written by &name-eric-kohl; <email>&email-eric-kohl;</email>
 320                 </para>
 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>
 349                 <para>
 350                   Written by &name-eric-kohl; <email>&email-eric-kohl;</email>
 351                 </para>
 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>
 376                 <para>
 377                   Dummy written by &name-eric-kohl; <email>&email-eric-kohl;</email>
 378                 </para>
 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>
 397                  <para>
 398                   Dummy written by &name-eric-kohl; <email>&email-eric-kohl;</email>,
 399                   &name-alex-priem; <email>&email-alex-priem;</email>
 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>
 422                     <para>
 423                       Written by &name-eric-kohl; <email>&email-eric-kohl;</email>
 424                     </para>
 425                   </listitem>
 426                   <listitem>
 427                     <para>&name-luc-tourangeau; <email>&email-luc-tourangeau;</email></para>
 428                   </listitem>
 429                   <listitem>
 430                     <para>&name-koen-deforche; <email>&email-koen-deforche;</email></para>
 431                   </listitem>
 432                   <listitem>
 433                     <para>&name-francis-beaudet; <email>&email-francis-beaudet;</email>
 434                       and the "Corel Team"</para>
 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>
 465                 <para>
 466                   Written by &name-eric-kohl; <email>&email-eric-kohl;</email>
 467                 </para>
 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>
 492                 <para>
 493                   Written by &name-eric-kohl; <email>&email-eric-kohl;</email>
 494                 </para>
 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>
 519                 <para>
 520                   Written by &name-eric-kohl; <email>&email-eric-kohl;</email>
 521                 </para>
 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>
 571                   &name-anders-carlsson; <email>&email-anders-carlsson;</email> and
 572                   &name-francis-beaudet; <email>&email-francis-beaudet;</email>
 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>
 598                 <para>
 599                   Written by &name-eric-kohl; <email>&email-eric-kohl;</email>
 600                 </para>
 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>
 653                 <para>
 654                   &name-anders-carlsson; <email>&email-anders-carlsson;</email>
 655                 </para>
 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>
 674                 <para>
 675                   Written by &name-eric-kohl; <email>&email-eric-kohl;</email>
 676                 </para>
 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>
 698                 <para>
 699                   Written by &name-eric-kohl; <email>&email-eric-kohl;</email>
 700                 </para>
 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>
 727                   Written by &name-eric-kohl; <email>&email-eric-kohl;</email> and
 728                   &name-alex-priem; <email>&email-alex-priem;</email>
 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>
 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>
 753               </listitem>
 754             </varlistentry>
 755             <varlistentry>
 756               <term>Status:</term>
 757               <listitem>
 758                 <para>Quite usable already.</para>
 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.
 773                   Some minor changes by &name-eric-kohl; <email>&email-eric-kohl;</email>.
 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>
 838           <title>5.1 Dynamic Storage Array (DSA)</title>
 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
 941 Local variables:
 942 mode: sgml
 943 sgml-parent-document:("wine-devel.sgml" "set" "book" "part" "chapter" "")
 944 End:
 945 -->