MultiDoc: what changed
Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | ### About | |
| 2 | 2 | ||
| 3 | 3 | MultiDoc is a Lazarus component to replace the standard MDI interface. | |
| 4 | 4 | ||
| 5 | 5 | This component permit to write pseudo-MDI application with Lazarus. It is not a real implementation of the MDI interface but it give to your application the capability to use many resizable sub-form. | |
| 6 | 6 | ||
| 7 | 7 | There are two components: | |
| 8 | 8 | ||
| 9 | 9 | - TMultiDoc : the main form docking area. | |
| 10 | 10 | - TChildDoc : the child container with resizeable border and button. | |
| 11 | 11 | ||
| 12 | 12 | I do them with a [graphical software](/wiki-images/3/3c/Media%3AMultidoc_skychart.jpg) in mind but they are probably useful for a range of applications. | |
| 13 | 13 | ||
| 14 | 14 | ### Screen Shot | |
| 15 | 15 | ||
| 16 | - | ||
| 17 | - | ||
| 18 | - | ||
| 19 | - | ||
| 16 | + |  | |
| 20 | 17 | ||
| 21 | 18 | ### Author | |
| 22 | 19 | ||
| 23 | 20 | Patrick Chevalley | |
| 24 | 21 | ||
| 25 | 22 | ### License | |
| 26 | 23 | ||
| 27 | 24 | Modified LGPL, see readme.txt | |
| 28 | 25 | ||
| 29 | 26 | ### Download | |
| 30 | 27 | ||
| 31 | 28 | The component in version 0.1 and 0.2 and a demonstration program can be found on the [Lazarus-CCR sourceforge site](http://sourceforge.net/project/showfiles.php?group_id=92177&package_id=176905). | |
| 32 | 29 | ||
| 33 | 30 | The component in version 0.3 and 0.3.1 can be found [here](http://br.geocities.com/hipernetjr/lmdi/index.html). *(link is broken, is someone having the file can upload somewhere?)* but could be find [here](http://br.oocities.com/hipernetjr/lmdi/index_ptbr.html) :-) | |
| 34 | 31 | ||
| 35 | 32 | Another download link of MultiDoc & LMDI (working in June 2017): <https://github.com/mehmetulukaya/laz-components> | |
| 36 | 33 | ||
| 37 | 34 | **Last available version from SVN:** A number of small fix where added to version 0.2 over the last years. If you use this version that not depend on LMDI you can get the most current version from the Skychart project.\ | |
| 38 | 35 | Type the following command:\ | |
| 39 | 36 | ||
| 40 | 37 | <nowiki>svn co http://svn.code.sf.net/p/skychart/code/tags/V36/skychart/component/multidoc multidoc</nowiki> | |
| 41 | 38 | ||
| 42 | 39 | **New Multiframe component:** | |
| 43 | 40 | ||
| 44 | 41 | Since 2012 I replace the use of this component in Skychart project by Multiframe.\ | |
| 45 | 42 | It work almost the same but use frames for the child windows, so it no more require the main TPanel trick. | |
| 46 | 43 | ||
| 47 | 44 | To get this component:\ | |
| 48 | 45 | ||
| 49 | 46 | <nowiki>svn co http://svn.code.sf.net/p/skychart/code/trunk/skychart/component/multiframe multiframe </nowiki> | |
| 50 | 47 | ||
| 51 | 48 | ### Change Log | |
| 52 | 49 | ||
| 53 | 50 | - The Multiframe SVN [changelog](http://sourceforge.net/p/skychart/code/3050/log/?path=/trunk/skychart/component/multiframe) can be read on Sourceforge. | |
| 54 | 51 | - Since 2012 this component is replaced by [Multiframe](http://sourceforge.net/p/skychart/code/HEAD/tree/trunk/skychart/component/multiframe/), using docked frames for the same functionality. | |
| 55 | 52 | - The SVN [changelog](http://sourceforge.net/p/skychart/code/2149/log/?path=/trunk/skychart/component/multidoc) can be read on Sourceforge. | |
| 56 | 53 | - Version 0.3.1 2008/01/01 Fixed the following: | |
| 57 | 54 | 1. Moved to public section some properties, to avoid exceptions in design-time | |
| 58 | 55 | - Version 0.3 2007/12/31 Fixed the following: | |
| 59 | 56 | 1. This version was developed by Júnior Gonçalves and depends on the [[LMDI]] package | |
| 60 | 57 | 2. Through of {\$IFDEF}'s the component compiles into Lazarus/Delphi unchanged | |
| 61 | 58 | 3. Great move. Now the mouse not "escape" while the cursor is dragged (Tested in GTK2 (Windows) and Windows XP) | |
| 62 | 59 | 4. ChildDoc is now derived from TFormPanel (see suite [[LMDI]]) | |
| 63 | 60 | 5. No more code necessary on each component to focus child form | |
| 64 | 61 | 6. It is possible to change the "skin" of the title bar, according to the OS (see component TTitleBar) | |
| 65 | 62 | - Version 0.2 2007/01/06 Fix the following: | |
| 66 | 63 | 1. BorderWidth property not working | |
| 67 | 64 | 2. Wrong button order | |
| 68 | 65 | 3. Center the cursor to the title bar when moving the panel | |
| 69 | 66 | 4. Gtk2 and FPC 2.1.1 compatibility | |
| 70 | 67 | 5. Crash when closing a child using the close button | |
| 71 | 68 | 6. Change licensing to modified LGPL | |
| 72 | 69 | - Version 0.1 2006/01/20 First beta release. | |
| 73 | 70 | ||
| 74 | 71 | ### Dependencies / System Requirements | |
| 75 | 72 | ||
| 76 | 73 | This component is exclusively derived from high level standard component (TPanel, TCustomSplitter, TSpeedButton). It must work on all the Lazarus platform without change. | |
| 77 | 74 | ||
| 78 | 75 | Tested on Linux and Windows. | |
| 79 | 76 | ||
| 80 | 77 | ### Notes | |
| 81 | 78 | ||
| 82 | 79 | You are not limited to show the docking area in the full main form. You can place the TMultiDoc anywhere you want or use multiple one! A combination with a TNotebook may give something similar to a multi-desktop. | |
| 83 | 80 | ||
| 84 | 81 | ### Installation | |
| 85 | 82 | ||
| 86 | 83 | - Compile and install multidocpackage.lpk | |
| 87 | 84 | - Open the example demo/demomultidoc.lpi | |
| 88 | 85 | ||
| 89 | 86 | This example can be used as a skeleton for a new application. | |
| 90 | 87 | ||
| 91 | 88 | ### Usage | |
| 92 | 89 | ||
| 93 | 90 | At design time: | |
| 94 | 91 | ||
| 95 | 92 | - On the application main form place a TMultiDoc. | |
| 96 | 93 | - Create a child form with a main TPanel. | |
| 97 | 94 | - Put all the object you want for the child to the panel, write the event, etc... | |
| 98 | 95 | - Do not rely on some TForm event as this form is never show. | |
| 99 | 96 | ||
| 100 | 97 | At run time: | |
| 101 | 98 | ||
| 102 | 99 | - Create a new child from TMultiDoc.NewChild | |
| 103 | 100 | - Create a child form with the new childdoc as owner. | |
| 104 | 101 | - Assign the main panel to the Dockedpanel property. | |
| 105 | 102 | ||
| 106 | 103 | ### Convert a Delphi MDI application | |
| 107 | 104 | ||
| 108 | 105 | Converting a MDI application is simplified by the availability of the same component for Delphi and Kylix. | |
| 109 | 106 | ||
| 110 | 107 | Convert first your application to MultiDoc in Delphi,then convert to Lazarus. This require some work but among the advantage you avoid the ugly XP border around your child forms. | |
| 111 | 108 | ||
| 112 | 109 | Replace the standard MDI function as below: | |
| 113 | 110 | ||
| 114 | 111 | ` MDIChildCount -> MultiDoc1.ChildCount`\ | |
| 115 | 112 | ` ActiveMdiChild -> MultiDoc1.ActiveObject`\ | |
| 116 | 113 | ` or MultiDoc1.ActiveChild`\ | |
| 117 | 114 | ` MDIChildren[i] -> MultiDoc1.Childs[i].DockedObject`\ | |
| 118 | 115 | ` or MultiDoc1.Childs[i]`\ | |
| 119 | 116 | ||
| 120 | 117 | The Delphi component is include in the package. Unzip multidoc-delphi.zip and install MultiDocD6.dpk or MultiDocK3.dpk. | |
| 121 | 118 | ||
| 122 | 119 | --- | |
| 123 | 120 | *From the Free Pascal wiki, page "MultiDoc", as it stood on 2017-06-19 after a change by Wp, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* | |
| 124 | 121 | Category: Components | |
| 125 | 122 | Category: Lazarus-CCR |