From 4a63d093a6b082a65cdf3dc1c0c49b3d93744339 Mon Sep 17 00:00:00 2001 From: wp_xxyyzz Date: Sun, 12 May 2019 16:04:59 +0000 Subject: [PATCH] TParadoxDataset: Update package file and readme for release version. git-svn-id: https://svn.code.sf.net/p/lazarus-ccr/svn@6910 8e941d3f-bd1b-0410-a28a-d453659cc2b4 --- components/tparadoxdataset/lazparadoxpkg.lpk | 4 +- components/tparadoxdataset/readme.txt | 88 ++++++++++++++++++-- 2 files changed, 84 insertions(+), 8 deletions(-) diff --git a/components/tparadoxdataset/lazparadoxpkg.lpk b/components/tparadoxdataset/lazparadoxpkg.lpk index b35f05189..76aac2415 100644 --- a/components/tparadoxdataset/lazparadoxpkg.lpk +++ b/components/tparadoxdataset/lazparadoxpkg.lpk @@ -23,9 +23,9 @@ - + diff --git a/components/tparadoxdataset/readme.txt b/components/tparadoxdataset/readme.txt index 501019274..cffb79387 100644 --- a/components/tparadoxdataset/readme.txt +++ b/components/tparadoxdataset/readme.txt @@ -1,16 +1,92 @@ -TParadox for Lazarus -current package can be found at : http://www.ullihome.de +================================================================================ + TParadoxDataset for Lazarus +================================================================================ +Current package can be found at: +https://sourceforge.net/p/lazarus-ccr/svn/HEAD/tree/components/tparadoxdataset/ + +-------------------------------------------------------------------------------- + License +-------------------------------------------------------------------------------- The contents of this file are subject to the Mozilla Public License Version 1.1 (the "License"); you may not use this file except in compliance -with the License. You may obtain a copy of the License at http://www.mozilla.org/MPL/ +with the License. You may obtain a copy of the License at +http://www.mozilla.org/MPL/ -Alternatively, you may redistribute this library, use and/or modify it under the terms of the -GNU Lesser General Public License as published by the Free Software Foundation; -either version 2.1 of the License, or (at your option) any later version. +Alternatively, you may redistribute this library, use and/or modify it under the +terms of the GNU Lesser General Public License as published by the +Free Software Foundation; either version 2.1 of the License, or (at your option) +any later version. You may obtain a copy of the LGPL at http://www.gnu.org/copyleft/. Software distributed under the License is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing rights and limitations under the License. +-------------------------------------------------------------------------------- + Summary +-------------------------------------------------------------------------------- +TParadoxDataSet is a TDataSet that can read (but not write!) Paradox files up +to Version 7. + +The motivation for having the component read-only is to provide a way to read +old Pardox files for converting to newer database formats. + +The main characteristics are: + +* Data-aware implementation, i.e. the component is a descendant of TDataset, + and you can use the standard data-aware Lazarus components to display the + table contents. + +* All table levels up to version 7 + +* No external DLL needed (unlike the TParadox component that comes with + Lazarus). Works in 32- and 64-bit operating systems. + +* Now supports BLOB fields, character encoding, filtering and bookmarks. + +-------------------------------------------------------------------------------- + Installation +-------------------------------------------------------------------------------- +* If needed, unzip the files from the zip file to any directory. + +* In Lazarus, open the package .lpk file with + "Package" > "Open package file (.lpk)". + In v0.2 there are two packages; both have the same content, but + lazparadox.lpk has a naming conflict with the Paradox package contained + in the Lazarus distribution; therefore it is recommended to install + lazparadoxpkg.lpk instead. + +* If you don't want to install the component into the IDE, click on "Compile". + +* If you want to install the component into the IDE, click on "Use" > "Install". + Confirm the prompt to rebuild the IDE. When Lazarus restarts you'll find the + component TParadoxDataset on palette "Data Access". + +-------------------------------------------------------------------------------- + Usage +-------------------------------------------------------------------------------- +* Drop the TParadoxDataset component on the form. + +* Specify the name of the table file (extension ".db") in property TableName + +* Set Active to true in order to open the table. When, for example, a DBGrid + is linked to the dataset the table is immediately displayed. + +* The encoding of text fields used in the file is displayed in the read-only + property InputEncoding. It is automatically converted to the encoding given + in property TargetEncoding which defaults to "UTF8". In the case that text + fields must be encoded differently specify the codepage name here, e.g. + "CP1252" for Western Europe code page (use the (case-insensitive) names + given in the LazUtils unit lconvencoding). + +* Filtering: Set Filtered to false. Then define the filter conditon in property + Filter or use the OnFilterRecord event. Finally start the filtering action + by setting Filtered to true. + +* Bookmarks: Store the currently active record as a bookmark by setting the + variable bookmark (which is of type TBookmark to ParadoxDataset1.GetBookmark. + For returning to this record, call ParadoxDataset1.GotoBookmark(boomark). + Since the component uses the RecNo as bookmarks it is not required to call + FreeBookmark. +