|
| 1 | +<style type="text/css"> |
| 2 | +code{ |
| 3 | + font-family: "Consolas", monospace; |
| 4 | +} |
| 5 | +pre{ |
| 6 | + border: 1px solid #ddd; |
| 7 | + border-left: 3px solid #f36d33; |
| 8 | + overflow: auto; |
| 9 | + padding: 1em 1.5em; |
| 10 | + display: block; |
| 11 | +} |
| 12 | +Blockquote{ |
| 13 | + border-left: 3px solid #d0d0d0; |
| 14 | + padding-left: 0.5em; |
| 15 | + margin-left:1em; |
| 16 | +} |
| 17 | +Blockquote p{ |
| 18 | + margin: 0; |
| 19 | +} |
| 20 | +table{ |
| 21 | + border:1px solid; |
| 22 | + border-collapse:collapse; |
| 23 | +} |
| 24 | +th{ padding:5px; |
| 25 | + border:1px solid; |
| 26 | +} |
| 27 | +td{ |
| 28 | + padding:5px; |
| 29 | + border:1px solid; |
| 30 | +} |
| 31 | +</style> |
| 32 | +<h1>DBAwareLabeledComponents</h1> |
| 33 | +<p><a href="https://opensource.org/licenses/Apache-2.0"><img src="https://img.shields.io/badge/License-Apache%202.0-yellowgreen.svg" alt="License"/></a></p> |
| 34 | +<p>An extended TDBGrid plus classic Delphi-VCL Editors with Boundary-Label (DB-Aware and Standard) including NumberBox</p> |
| 35 | +<h3>Actual official version 1.3.2 (VCL)</h3> |
| 36 | +<p>An advanced TDbGrid component:</p> |
| 37 | +<p>TLabeledDbGrid is an advanced version of classic TDbGrid with a boundary Label, plus some extra features:</p> |
| 38 | +<ul> |
| 39 | +<li>ShowSortOrder: shows an indicator of sorting column</li> |
| 40 | +<li>Embedeed CheckBox for boolean fields</li> |
| 41 | +<li>Incremental search, when typing into a ReadOnly DbGrid</li> |
| 42 | +<li>Alternate row-color</li> |
| 43 | +<li>Custom row-colors</li> |
| 44 | +<li>Show sort order</li> |
| 45 | +<li>Incremental search</li> |
| 46 | +<li>Lines per Rows (to show memo fields with multiple lines)</li> |
| 47 | +<li>RowMargin (to enlarge heigh of any row)</li> |
| 48 | +</ul> |
| 49 | +<p>*Example of a TLabeledDbGrid (with some extended functionality like inplace checkbox and sorting) with the label aligned TopCenter (inside the client area of the grid aligned alClient).</p> |
| 50 | +<p><img src="./Images/DemoDataAwareDbGridTopCenter.png" alt="Preview Thumbnails Dark"/></p> |
| 51 | +<p>This library contains also the classic VCL editors (standard and data-aware) with the addition of a “label” attached to the component itself (like the native component TLabeledEdit).</p> |
| 52 | +<p>It is no longer necessary to keep the Label “connected” and “aligned” by hand to the editor: on every component you can specify 3 simple properties:</p> |
| 53 | +<ul> |
| 54 | +<li>BoundCaption</li> |
| 55 | +<li>BoundLabel.Labelposition (default lpTopLeft)</li> |
| 56 | +<li>BoundLabel.LabelSpacing (default 1)</li> |
| 57 | +</ul> |
| 58 | +<p>The label can be positioned with 12 alignements: |
| 59 | +<strong>lpTopLeft, lpTopCenter, lpTopRight, lpBottomLeft, lpBottomCenter, lpBottomRight, lpLeftTop, lpLeftMiddle, lpLeftBottom, lpRightTop, lpRightMiddle, lpRightBottom</strong></p> |
| 60 | +<h2>TLabeledButtonEdit:</h2> |
| 61 | +<p>Also available for D10.3 to latest, TLabeledButtonEdit and TLabeledDBButtonEdit are a classic editors with a button inside (on the right). For Date Fields the button opens automatically a Popup-Calendar.</p> |
| 62 | +<p><em>Look at those examples, showing all the components with different Label alignments: the demo is available into Demo Folder</em></p> |
| 63 | +<table> |
| 64 | + <tr> |
| 65 | + <th>Sample</th> |
| 66 | + <th>Description</th> |
| 67 | + </tr> |
| 68 | + <tr> |
| 69 | + <td><img src="./Images/DemoDataAwareDbGridLinesPerRow3.png" alt="DemoDataAwareDbGridLinesPerRow3"/></td> |
| 70 | + <td>Example of LabeledDbGrid with LinesPerRow = 3 to show multiline content of memo fields</td> |
| 71 | + </tr> |
| 72 | + <tr> |
| 73 | + <td><img src="./Images/DemoDataAwareDbGridRowMargin15.png" alt="DemoDataAwareDbGridRowMargin15"/></td> |
| 74 | + <td>Example of LabeledDbGrid with RowMargin = 15 to to change height of grid Row. Fully compatible with Styles (light and dark)</td> |
| 75 | + </tr> |
| 76 | + <tr> |
| 77 | + <td><img src="./Images/DemoDataAwareTopLeft.png" alt="DemoDataAwareTopLeft"/></td> |
| 78 | + <td>Example of collection of Dataaware components with label aligned to “TopLeft”</td> |
| 79 | + </tr> |
| 80 | + <tr> |
| 81 | + <td><img src="./Images/DemoDataAwareNumberEditorsLeftMiddle.png" alt="DemoDataAwareNumberEditorsLeftMiddle"/></td> |
| 82 | + <td>Example of LabeledDBCurrencyEdit and LabeledDBNumberBox (only for 10.4.2): Dataware components for numeric input (from right to left) with label aligned to “LeftMiddle”</td> |
| 83 | + </tr> |
| 84 | + <tr> |
| 85 | + <td><img src="./Images/DemoNonDataAwareTopRight.png" alt="Preview Thumbnails Dark"/></td> |
| 86 | + <td>Example of collection of Standard components with label aligned to “TopRight”</td> |
| 87 | + </tr> |
| 88 | + <tr> |
| 89 | + <td><img src="./Images/DemoColorsImagesBottomCenter.png" alt="Preview Thumbnails Dark"/></td> |
| 90 | + <td>Example of collection of components with label aligned to “BottomCenter”</td> |
| 91 | + </tr> |
| 92 | + <tr> |
| 93 | + <td><img src="./Images/DemoNumberInputStyled.png" alt="Preview Thumbnails Dark"/></td> |
| 94 | + <td>All components are fully VCL styles compatible</td> |
| 95 | + </tr> |
| 96 | +</table> |
| 97 | +<p>A complete Demo is available in Demo Folder.</p> |
| 98 | +<h2>Support for new NumberBox component</h2> |
| 99 | +<p><strong>TNumberBox</strong> component (available from D10.4.2) is the new component for advanced numeric input. In this library you can find:</p> |
| 100 | +<ul> |
| 101 | +<li>TDBNumberBox: the standard component with classic DataAeware support (DataSource + DataField) without Label.</li> |
| 102 | +<li>TLabeledNumberBox: a TNumberBox component with boudary label</li> |
| 103 | +<li>TLabeledDBNumberBox: a TDBNumberBox with boudary label</li> |
| 104 | +</ul> |
| 105 | +<h3>Available from Delphi XE3 to Delphi 12 (32bit and 64bit platforms)</h3> |
| 106 | +<p><img src="./Images/SupportingDelphi.jpg" alt="Delphi Support"/></p> |
| 107 | +<p>Related links: https://www.embarcadero.com/ - https://learndelphi.org/</p> |
| 108 | +<h2>INSTALLATION</h2> |
| 109 | +<p>Clone repository, open Package Group “PackageGroup.groupproj” of your Delphi version located in:</p> |
| 110 | +<p><em>DBAwareLabeledComponents\Packages\DXXX</em></p> |
| 111 | +<p>Build RunTime package: DBAwareLabeledComponents.dproj</p> |
| 112 | +<p>Install DesignTime package: dclDBAwareLabeledComponents.dproj</p> |
| 113 | +<p><strong>Remember to add those folders to Search Path:</strong></p> |
| 114 | +<p><em>{InstallDir}\Source</em></p> |
| 115 | +<h3>DOCUMENTATION</h3> |
| 116 | +<p>Coming soon, into Wiki section.</p> |
| 117 | +<h3>RELEASE NOTES</h3> |
| 118 | +<p>08 Jul 2024: ver.1.3.2</p> |
| 119 | +<ul> |
| 120 | +<li>Fixed error when adding TLabeledNumberBox to a form.</li> |
| 121 | +</ul> |
| 122 | +<p>13 Jan 2024: ver.1.3.1</p> |
| 123 | +<ul> |
| 124 | +<li>Fixed DbGrid rendering</li> |
| 125 | +<li>Updated Copyright</li> |
| 126 | +</ul> |
| 127 | +<h3>RELEASE NOTES</h3> |
| 128 | +<p>21 Aug 2023: ver.1.3.0</p> |
| 129 | +<ul> |
| 130 | +<li>Added support for Delphi 12</li> |
| 131 | +<li>Added WrapAllText, ColMoving and IncrementalSearchType to TLabeledDbGrid</li> |
| 132 | +<li>Fixed 64Bit issue for TLabeledDBComboBox</li> |
| 133 | +</ul> |
| 134 | +<p>05 Sep 2022: ver.1.2.2</p> |
| 135 | +<ul> |
| 136 | +<li>Refactoring of rendering TLabeledDBGrid to fix some problems when dgRowSelect is active</li> |
| 137 | +</ul> |
| 138 | +<p>19 Aug 2022: ver.1.2.1</p> |
| 139 | +<ul> |
| 140 | +<li>Fixed checkbox drawing in “Windows” style, using rowmargin and/or LinesPerRow</li> |
| 141 | +<li>Fixed drawing cell right aligned</li> |
| 142 | +<li>Fixed Setting custom cursor for Grid</li> |
| 143 | +</ul> |
| 144 | +<p>15 Jun 2022: ver.1.2.0</p> |
| 145 | +<ul> |
| 146 | +<li>Added TLabeledButtonEdit and TLabeledDBButtonEdit (from Delphi 10.1)</li> |
| 147 | +<li>Updated Demo with TLabeledButtonEdit and TLabeledDBButtonEdit examples</li> |
| 148 | +<li>Added Packages for Delphi 10.1 and Delphi XE8</li> |
| 149 | +</ul> |
| 150 | +<p>17 May 2022: ver.1.1.0</p> |
| 151 | +<ul> |
| 152 | +<li>Added LinesPerRow and RowMargin to TLabeledDbGrid</li> |
| 153 | +<li>Updated Demo with full features of TLabeledDbGrid</li> |
| 154 | +<li>Changed LibSuffix for Packages (D10.4 and D11)</li> |
| 155 | +<li>Renamed Package Description to “Ethea: Dataaware Labeled Components”</li> |
| 156 | +</ul> |
| 157 | +<p>10 Oct 2021:</p> |
| 158 | +<ul> |
| 159 | +<li>Fixed LabeledDbGrid for Rendering selected cell with Windows 11</li> |
| 160 | +<li>Fixex LabeledDbGrid columns draw in High-DPI app</li> |
| 161 | +</ul> |
| 162 | +<p>03 Sep 2021:</p> |
| 163 | +<ul> |
| 164 | +<li>Added support for Delphi 11</li> |
| 165 | +</ul> |
| 166 | +<p>25 Apr 2021: version 1.0.0</p> |
| 167 | +<p>Components released:</p> |
| 168 | +<p>only for D10.4.2 and above</p> |
| 169 | +<ul> |
| 170 | +<li>TDBNumberBox</li> |
| 171 | +<li>TLabeledNumberBox</li> |
| 172 | +<li>TLabeledDBNumberBox</li> |
| 173 | +</ul> |
| 174 | +<p>only for D10.1 and above</p> |
| 175 | +<ul> |
| 176 | +<li>TLabeledDBButtonEdit</li> |
| 177 | +<li>TLabeledButtonEdit</li> |
| 178 | +</ul> |
| 179 | +<p>for all Delphi versions (from XE3)</p> |
| 180 | +<ul> |
| 181 | +<li>TLabeledColorGrid</li> |
| 182 | +<li>TLabeledCurrencyEdit</li> |
| 183 | +<li>TLabeledDBCurrencyEdit</li> |
| 184 | +<li>TLabeledSpinEdit</li> |
| 185 | +<li>TLabeledRichEdit</li> |
| 186 | +<li>TLabeledCheckListBox</li> |
| 187 | +<li>TLabeledEditEx (similar to TLabeledEdit)</li> |
| 188 | +<li>TLabeledComboBox</li> |
| 189 | +<li>TLabeledListBox</li> |
| 190 | +<li>TLabeledMemo</li> |
| 191 | +<li>TLabeledDBEdit</li> |
| 192 | +<li>TLabeledDBLabel</li> |
| 193 | +<li>TLabeledDBComboBox</li> |
| 194 | +<li>TLabeledDBListBox</li> |
| 195 | +<li>TLabeledDBMemo</li> |
| 196 | +<li>TLabeledDBImage</li> |
| 197 | +<li>TLabeledDBLookupListBox</li> |
| 198 | +<li>TLabeledDBLookupComboBox</li> |
| 199 | +<li>TLabeledDbGrid</li> |
| 200 | +<li>TLabeledDBRichEdit</li> |
| 201 | +<li>TLabeledDBCtrlGrid</li> |
| 202 | +<li>TLabeledDBListView</li> |
| 203 | +<li>TLabeledMaskEdit</li> |
| 204 | +<li>TLabeledRadioGroup</li> |
| 205 | +<li>TLabeledImage</li> |
| 206 | +<li>TLabeledColorBox</li> |
| 207 | +</ul> |
0 commit comments