Skip to content

Commit 8928bc7

Browse files
Update README.md
1 parent 84ed915 commit 8928bc7

File tree

1 file changed

+102
-2
lines changed

1 file changed

+102
-2
lines changed

README.md

Lines changed: 102 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,102 @@
1-
# DBAwareLabeledComponents
2-
Delphi-VCL Labeled Editors (DB-Aware and Standard) including NumberBox, plus Extended DbGrid
1+
# DBAwareLabeledComponents [![License](https://img.shields.io/badge/License-Apache%202.0-yellowgreen.svg)](https://opensource.org/licenses/Apache-2.0)
2+
3+
Classic Delphi-VCL Editors plus a Boundary-Label (DB-Aware and Standard) including NumberBox, plus an Extended DbGrid
4+
5+
### Actual official version 1.0.0 (VCL)
6+
7+
With this small library of VCL components it is possible to have the classic VCL editors (standard and data-aware) with the addition of a "label" attached to the component itself (like the native component TLabeledEdit).
8+
9+
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:
10+
- BoundCaption
11+
- BoundLabel.Labelposition (default lpTopLeft)
12+
- BoundCaption.LabelSpacing (default 1)
13+
14+
*Look at those examples, showing all the components with different Label alignments:*
15+
16+
| Sample | Description |
17+
| ------ | ----------- |
18+
| ![DemoDataAwareTopLeft](./Images/DemoDataAwareTopLeft.png) | Example of collection of Dataaware components with label aligned to "TopLeft" |
19+
| ![DemoDataAwareNumberEditorsLeftMiddle](./Images/DemoDataAwareNumberEditorsLeftMiddle.png) | Example of LabeledDBCurrencyEdit and LabeledDBNumberBox (only for 10.4.2): Dataware components for numeric input (from right to left) with label aligned to "LeftMiddle" |
20+
| ![Preview Thumbnails Dark](./Images/DemoDataAwareDbGridTopCenter.png) | Example of a DbGrid (with some extended functionality like inplace checkbox and sorting) with the label aligned TopCenter (notice that the grid is aligned alClient and the Label is rendered inside the client area) |
21+
| ![Preview Thumbnails Dark](./Images/DemoNonDataAwareTopRight.png) | Example of collection of Standard components with label aligned to "TopRight" |
22+
| ![Preview Thumbnails Dark](./Images/DemoColorsImagesBottomCenter.png) | Example of collection of components with label aligned to "BottomCenter" |
23+
| ![Preview Thumbnails Dark](./Images/DemoNumberInputStyled.png) | All components are fully VCL styles compatible |
24+
25+
## Support for new NumberBox component
26+
27+
**TNumberBox** component (available from D10.4.2) is the new component for advanced numeric input. In this library you can find:
28+
- TDBNumberBox: the standard component with classic DataAeware support (DataSource + DataField) without Label.
29+
- TLabeledNumberBox: a TNumberBox component with boudary label
30+
- TLabeledDBNumberBox: a TDBNumberBox with boudary label
31+
32+
## An advanced TDbGrid component
33+
34+
TLabeledDbGrid is an advanced version of classic TDbGrid with the boundary Label, plus some extra features:
35+
- ShowSortOrder: shows an indicator of sorting column
36+
- Embedeed CheckBox for boolean fields
37+
- Incremental search, when typing into a ReadOnly DbGrid
38+
- Alternate row-color
39+
- Custom row-colors
40+
41+
### Available from Delphi XE3 to Delphi 10.4 (32bit and 64bit platforms)
42+
43+
![Delphi 10.4 Sydney Support](./Images/SupportingDelphi.jpg)
44+
45+
Related links: https://www.embarcadero.com/ - https://learndelphi.org/
46+
47+
## INSTALLATION
48+
49+
Clone repository, open Package Group "PackageGroup.groupproj" of your Delphi version located in:
50+
51+
_DBAwareLabeledComponents\Packages\DXXX_
52+
53+
Build RunTime package: DBAwareLabeledComponents.dproj
54+
55+
Install DesignTime package: dclDBAwareLabeledComponents.dproj
56+
57+
**Remember to add those folders to Search Path:**
58+
59+
_{InstallDir}\Source_
60+
61+
### DOCUMENTATION
62+
63+
Coming soon, into Wiki section.
64+
65+
### RELEASE NOTES
66+
25 Apr 2021: version 1.0.0
67+
68+
Components released:
69+
70+
only for D10.4.2
71+
- TDBNumberBox
72+
- TLabeledNumberBox
73+
- TLabeledDBNumberBox
74+
75+
for all Delphi versions (from XE3)
76+
- TLabeledColorGrid
77+
- TLabeledCurrencyEdit
78+
- TLabeledDBCurrencyEdit
79+
- TLabeledSpinEdit
80+
- TLabeledRichEdit
81+
- TLabeledCheckListBox
82+
- TLabeledEditEx
83+
- TLabeledComboBox
84+
- TLabeledListBox
85+
- TLabeledMemo
86+
- TLabeledDBEdit
87+
- TLabeledDBLabel
88+
- TLabeledDBComboBox
89+
- TLabeledDBListBox
90+
- TLabeledDBMemo
91+
- TLabeledDBImage
92+
- TLabeledDBLookupListBox
93+
- TLabeledDBLookupComboBox
94+
- TLabeledDbGrid
95+
- TLabeledDBRichEdit
96+
- TLabeledDBCtrlGrid
97+
- TLabeledDBListView
98+
- TLabeledMaskEdit
99+
- TLabeledRadioGroup
100+
- TLabeledImage
101+
- TLabeledColorBox
102+

0 commit comments

Comments
 (0)