X-Files Components 3.3
======================
X-Files Components package contains four powerful advanced components
(TXDBGrid, TXQRGrid, TXDBColumnsDialog, TXDBPrintColumnsDialog) designed for
Delphi 5, 6, 7 & 8 and C++Builder 5 & 6.
TXDBGrid component is the functional extension of Borland's TDBGrid. TXDBGrid
implements all standard TDBGrid's functions and the many additional, which are
launched including new Options or by setting values for new properties.
TXDBGrid is fully compatible with TDBGrid component on properties level and
can be used as a replacement without losing existing values. TXDBGrid has its
own ColumnEditor, which can fully support all new column's properties.
TXDBGrid component is compatible with Windows XP platform and fully supports
Windows XP Styles.
TXDBColumnsDialog is a complementary component for TXDBGrid designed for grid
columns management in run-time. User can show/hide selected columns in the
grid by using convenient dialog which presents columns list with checkboxes.
TXQRGrid is a complementary component for TXDBGrid designed for dynamic report
creation on the basis of TXDBGrid current settings. TXQRGrid component can
print and preview the content of TXDBGrid component. TXQRGrid creates in run-
time complete report in QuickReport format. The report can be automatically
stretched or created as few parts (vertical bands) depend on selected paper
size settings.
TXDBPrintColumnsDialog is a complementary component for TXDBGrid & TXQRGrid
designed for selection printed columns in run-time. User can select columns
that are printed by using convenient dialog which presents columns list with
checkboxes.
Requirements
============
The package requires using latest released service pack for each version of
Delphi/C++Builder: Delphi 5.01, Delphi 6.02 RTL 3, Delphi 7.01, Delphi 8.02
for .NET, C++Builder 5.01, C++Builder 6.04. This package can't be installed
on the Trial version of Delphi/C++Builder.
Notice. When the Error Loading IDE Assembly or Package occurs (C:\Program
Files\Borland\BDS\2.0\XFiles\DCLXFiles80.dll is not a Delphi package/
assembly) during Delphi 8 for .NET is starting, it means, you should
download and install Update #2 for Delphi 8 for .NET first.
TXQRGrid component requires to install latest version of QuickReport Standard
for appropriate version of Delphi/C++Builder. For Delphi 5 - QR 3.5 (qr35sd5.exe),
for Delphi 6 - QR 3.5.1 (qr351sd6.exe), for Delphi 7 - QR 3.5.1 (qr351sd7.exe),
for C++Builder 5 - QR 3.5 (qr35sc5.exe), for C++Builder 6 - QR 3.5 (qr35sc6.exe).
TXQRGrid component for Delphi 8 for .NET isn't yet available.
New version of QuickReport Standard may be downloaded from QuSoft AS Home Page
(http://www.qusoft.com/) or directly from X-Files Components Website
(http://www.x-files.pl/). If you want to use TXQRGrid component with other
version of QuickReport (e.g. Professional) you should register the Professional
version (with source) of X-Files Components to recompile package.
To get themed version of TXDBGrid component on Delphi/C++Builder 5 & 6 you
should download and install Windows XP Theme Manager by Mike Lischke (freeware)
from http://www.lischke-online.de/ and register the Professional version (with
source) of this package. (Mike Lischke is an author of Themes unit in Delphi 7).
What's new in version 3.3 ?
===========================
- Support for flat scrollbars (FlatSBMode, ScrollProp)
- Enhanced scrollbars (AutoHidden, Color, Style, ThumbBar)
- Support for expanded/contracted columns of any type (ExpandCols)
- Enhanced expand button (ExpandStyle, cesDropDown, cesDropDownMenu)
- Enhanced checkboxes adjusted to FixedStyle (CheckBoxStyle, CheckBoxKind)
- Enhanced markers adjusted to FixedStyle (MarkerStyle, MarkerTransparent)
- Enhanced drawing of hot buttons adjusted to FixedStyle (HotButtons)
- Enhanced drawing of grid border adjusted to FixedStyle (Ctl3DAuto)
- Enhanced drawing of list border adjusted to FixedStyle (ListBorder)
- Enhanced drawing of focused cell in the grid (FocusRect)
- Improved drawing of fixed cells for RightToLeft BiDiMode
- Enhanced edit ButtonStyle (cbsDropDown, cbsDropDownMenu)
- Improved edit ButtonStyle drawing adjusted to scrollbars
- Improved drop-down list drawing (DropDownMenu, DropDownWidth)
- Support for editor cell and list drawing (EditorColor)
- Support for stripped rows drawing (StripeColor)
- Support for selected rows drawing (SelectionColor)
- Support for current row drawing (SelectRowColor)
- Enhanced support for mouse wheel (WheelScrollRows)
- Enhanced record moving (Position, GotoPosition, DataRowCount)
- Enhanced columns resize (ResizeOptions, roOptimalWidth, roDefaultWidth)
- Support for speed or quality drawing (DoubleBuffered)
- Extended internal list of indicator images
- Corrected and improved using of dgAlwaysShowEditor option
- New column's dialog options for TXDBColumnsDialog (DialogOptions)
- New report's dialog options for TXDBPrintColumnsDialog (DialogOptions)
- Support for storing report to the file in many formats (SaveToFile)
- Support for stripped rows printing by TXQRGrid (StripeColor)
- Support for printer setup (PrinterSetup, roPreparePrinterSetup)
- Support for printer settings (roKeepPrinterSetup, roKeepDesignPrinterSetup)
- Support for preview settings (PreviewSettings)
- Many, many little enhancemets and improvements has been implemented
Important changes introduced in version 3.3 ?
=============================================
- Default value for GridStyle.VisualStyle is now vsXPStyle
- Default value for IndicatorWidth is now 20 (instead 11)
- FillerPopupMenu is now auto drop-down for FillerIndex = -7
What's new in version 3.2 ?
===========================
- The package for Delphi 8 for .NET is now available
- Little changes in source code to unify all versions
- RightToLeft BiDiMode example added to Demo1
- RightToLeft BiDiMode support improved
- ADT fields support improved (TXQRGrid)
- PopupMenu handling bug fixed (TXDBGrid)
Delphi 8 for .NET - known problems
==================================
- TXQRGrid component for Delphi 8 for .NET isn't yet available (need QR for .NET)
- HtmlHelp version for Delphi 8 for .NET isn't yet available (use WinHelp version)
- dgRightMoving option raises exception during loading (bug in Delphi 8 for .NET)
(This option is now marked as obsolete but you can still include it in run-time)
- Drag&drop in XDBGrids Columns Editor causes exception (bug in Delphi 8 for .NET)
(All property editors have the same problem. Don't use drag&drop technique yet)
- TUpdateSQL component isn't registerd on ToolPalette (installer can register it)
(This component is used only in Demos. You can register it or remove from Demos)
What's new in version 3.1 ?
===========================
- Support for vertical text alignment in XQRGrid's cells (roAllowVAlignment)
- Automatic row height adjustment for all/selected columns (AutoRowHeight)
- Automatic row height adjustment for vertical bands (roMultiPartRowHeight)
- Fixed columns can be repeated on each report's vertical band (FixedCols)
What's new in version 3.0 ?
===========================
- The package for C++Builder 5 & 6 is now available
- The package for Delphi 3 & 4 is no longer available
- 100% compatibility between Delphi and C++Builder code
- Included fully automatically installer/uninstaller
- Support for Windows XP Style (IsGridThemed, FixedTheme, dgHotButtons)
- Standard, XPStyle or user defined grid spacing (GridStyle, VisualStyle)
- Proportional scrolling for any DataSet, even filtered (dgForceSequence)
- Support for horizontal and vertical scrollbar tracking (dgThumbTracking)
- AutoNumber for any DataSet, even filtered (AutoNumber, RecNumber, RecCount)
- Many small changes and extensions to improve run-time code
- SaveReport can now store report either as *.pas or *.cpp file
- The report can be now autoprepared (PrepareNeeded, AfterPrepare)
- TXQRGrid supports autonumbering (AutoNumber, RecordNumber, etc.)
- New SysData values available in TXQRGrid (rdPageNoPerCount, etc.)
- New components TXDBColumnsDialog, TXDBPrintColumnsDialog
Other main advantages of TXDBGrid
=================================
- Excellent context help system (over 370 topics)
- Hints and ToolTips for data cells
- Hints for titles, headers, indicator and filler
- User defined markers list (TitleMarkers)
- User defined indicators list (IndicatorImages)
- User defined pictures list for columns (Images)
- Pictures for titles and filler (TitleImages)
- Many variants of pictures drawing into cells (ImageDraw)
- Autotoggled markers for multicolumns sorting (OrderFields)
- Support for fixed columns and styles (FixedCols, FixedStyle)
- Support for bdRightToLeft BiDiMode for Middle Eastern locale
- Support for mouse wheels and drag & drop for selected rows
- Support for save and restore row position in the grid
- Extended rows selection and notification (OnRowSelect)
- Additional options for pick/lookup lists (ListOptions)
- Additional options for PickList/PickText (PickOptions)
- Stretching columns to grid client area (StretchMode)
- Multiline rows, title buttons, headers and many more ...
Other main advantages of TXQRGrid
=================================
- Print all/selected rows/parts of report (Print)
- Preview selected rows/parts of report (Preview)
- Showing report in designer mode (ShowReport)
- Storing report as QR source files (SaveReport) <Registered version only>
- Customizeble multiline PageHeader, PageFooter, PageTitle, PageLegend
- Many variants of system data (rdDate, rdTime, rdPageNumber, etc.)
- Support for grouping records (GroupHeader, GroupFooter, GroupTotals)
- Support for report alignment (raStretch, raStretchAll, raCenter, etc.)
- Support for bdRightToLeft BiDiMode for Middle Eastern locale
- Support for report modification in run-time (OnReportCreate, OnPrint)
- All QuickReport's events available for developer <Registered version only>
Installation
============
To install X-Files Components package you should:
-------------------------------------------------
1. Uninstall previous version of X-Files Components / X-DBGrid Component,
if exists.
2. Run X-Files33xx.exe installer.
How to update Delphi Library Path ?
-----------------------------------
Make sure your Delphi Library Path contains only one path pointing to X-Files
Components or X-DBGrid Component package. If you have uninstalled 2.x version
of the package, make sure you deleted old entry from your Library Path.
The default path for X-Files Components 3.x is:
$(DELPHI)\XFiles - for Delphi 5, 6 & 7
$(BCB)\XFiles - for C++Builder 5 & 6
$(BDS)\XFiles - for Delphi 8 for .NET
The default path for X-DBGrid Component 3.x is:
$(DELPHI)\XDBGrid - for Delphi 5, 6 & 7
$(BCB)\XDBGrid - for C++Builder 5 & 6
$(BDS)\XDBGrid - for Delphi 8 for .NET
When you install the new package, the new installer can automatically change
path in the Library Path for this reason, but it can't know/remove old entry.
How to install Context Help File ?
----------------------------------
The installer can automatically install Context Help File, then you don't need
to do it manualy. If your OpenHelp can't find any topic from X-Files Components
Reference file, you should:
1. Select the Help | Customize... menu item to display OpenHelp window.
2. Add the ..\Help\XFiles.cnt file to the Contents page.
3. Add the ..\Help\XFiles.hlp file to the Index page.
4. Add the ..\Help\XFiles.hlp file to the Link page.
5. Click on File | Save Project to save your changes.
Notice. You may need to remove any indexes you do not use because default help
indexing is near the limits of Microsoft's WinHelp. If you experience an empty
list on the Index tab page of WinHelp, this indicates you need to remove some
files from OpenHelp. HtmlHelp version for Delphi 8 for .NET isn't yet available.
Mini FAQ
========
How to get themed version of TXDBGrid component for Delphi/C++Builder 5 & 6 ?
-----------------------------------------------------------------------------
To get themed version of TXDBGrid component on Windows XP platform the
TThemeServices class is required. This class is available only in Delphi 7 in
Themes unit. To get themed version of TXDBGrid component for Delphi/C++Builder 5 & 6,
you should:
1. Download and install Windows XP Theme Manager by Mike Lischke (freeware)
from http://www.lischke-online.de/.
2. Open XDBGrids.pas unit and replace switch {$UNDEF THEMES} to {$DEFINE THEMES}
3. Add XDBGrids.pas unit to the project either or save that to the project directory.
4. Add XP Manifest either file or resource to the project.
To do this you should have the Professional version (with source) of the package.
How to use X-Files Components with QuickReport Professional ?
-------------------------------------------------------------
X-Files Components package is compiled with using latest version of QuickReport
Standard. When the fatal error occurs ([Fatal Error] Project1.dpr(5): Unit XQRGrids
was compiled with a different version of QuickRpt.TCustomQuickRep) you must
recompile this package. To recompile package with other version of QuickReport
(e.g. Professional), you should (on Delphi 7 example):
1. Copy qrpt70.dcp file from ..\Projects\Bpl to ..\XFiles\Source directory.
2. Open ..\XFiles\Source\VCLXFiles70.dpk file and replace qrpt required package
to qrpt70.
2a. Open ..\XFiles\Source\XQRGrids.pas file and replace {$UNDEF QR36} to {$DEFINE QR36} for QR 3.6x Prof. or
2b. Open ..\XFiles\Source\XQRGrids.pas file and replace {$UNDEF QR40} to {$DEFINE QR40} for QR 4.0x Prof.
3. Run ..\XFiles\Source\DCCXFiles70.bat batch file to recompile both packages.
4. Copy files DCLXFiles70.bpl, DCLXFiles70.dcp, VCLXFiles70.bpl, VCLXFiles70.dcp,
XDBGrids.dcu, XQRGrids.dcu, XDBLists.dcu from ..\XFiles\Source to ..\XFiles
directory.
5. Copy VCLXFiles70.bpl file to \Windows\System32 (\WinNT\System32) directory.
To do this you should have the Professional version (with source) of the package.
How to replace TDBGrid component to TXDBGrid component in old projects ?
------------------------------------------------------------------------
TXDBGrid is fully compatible with TDBGrid component on properties level
and can be used as a replacement without losing existing values.
1. Replace "DBGrids" unit name to "XDBGrids" unit in uses clause.
2. Replace all occurence of "TDBGrid" class to "TXDBGrid" class.
3. Click right mouse button on a form and select "View as Text".
4. Replace all occurence of "TDBGrid" class to "TXDBGrid" class.
5. Click right mouse button on editor and select "View as Form".
6. Save changes, (important) close a form and reopen it.
7. Replace other class name to "TX" class name (e.g. TColumn to TXColumn).
Registering
===========
The X-Files Components package is a Shareware product. The Trial version of this
package can be used only in Delphi/C++Builder IDE. If you find it useful and you
want to receive full version, you should register it. You can receive Standard
or Professional version of package, depend on registration fee. The Professional
version contains also full run-time source code and the part of design-time source
code except private X-Files Delphi/C++Builder IDE extensions (IDE dialogs).
Registered version of package may be used in your programs without additional
fee. All registered users are notified by e-mail when a new version of package
will be released. All updates for version 3.x you can receive FREE on e-mail.
Please, read the Register.txt file to know detailed prices.
Contact
=======
Please contact us, if you have any questions, suggestions or comments:
Company: X-Files Software, Borland Technology Partner
Author: Krzysztof Szyszka, Poland
Website: http://www.x-files.pl/
DISCLAIMER OF WARRANTY
======================
PRODUCT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. THE AUTHOR DISCLAIMS
ALL WARRANTIES, EXPRESSED OR IMPLIED, WITHOUT LIMITATION, THE WARRANTIES OF
MERCHANTABILITY AND OF FITNESS FOR ANY PURPOSE. THE AUTHOR ASSUMES NO LIABILITY
FOR DAMAGES, DIRECT OR CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE OF THIS
PRODUCT.
History
=======
X-Files Components 1.0 (June 14, 1999). First version for Delphi 4 only.
X-Files Components 1.1 (July 4, 1999). First version for Delphi 3.
Little changes in demo programs for Delphi 3 compatibility.
X-Files Components 1.2 (September 9, 1999).
+ New Option - dgIndicatorMarkOff
+ New properties - ImageOffsetX, ImageOffsetY
+ New properties - CheckBox, CheckBoxValues, CheckBoxToggle
+ New procedures - IsCheckBoxValue, ToggleCheckBoxValue
X-Files Components 1.3 (October 16, 1999). First version for Delphi 5.
Little changes in source code.
X-Files Components 1.4 (December 18, 1999).
+ New Option - dgAllowDeleteOff, dgAllowInsertOff
+ New properties - StretchMode, StretchWidthMax, StretchWidthMin, WidthBase
+ New properties - ScrollBarHeight, ScrollBarWidth, TrueWidth
+ New procedures - StretchGrid
+ New events - OnColumnResize, OnColumnScroll, OnRowScroll
X-Files Components 1.5 (March 26, 2000).
+ New properties - FillerButton, FillerColor, FixedCols, FixedStyle
+ New properties - RowHeight, TitleHeight
+ New events - OnFillerClick
X-Files Components 2.0 (June 24, 2000).
+ New procedures - HeaderLeft, HeaderRight
+ New procedures - DisableGrid, EnableGrid, GridDisabled
+ New properties - Report (Visible, TotalType, TotalText, TotalMask)
+ New component - TXQRGrid
X-Files Components 2.1 (November 7, 2000).
+ New Option - dgMarkerAutoToggle, dgMarkerAscendOnly
+ New properties - FillerHint, FillerIndex, FillerPopupMenu, HintOptions,
IndicatorImages, IndicatorPopupMenu, IndicatorWidth,
OrderFields, TitleImages, TitleMarkers, LastShiftState
+ New properties - ColLineWidth, RowLineWidth, Indicators, Markers
+ New events - OnCalcImageIndex, OnCellHint, OnIndicatorClick,
OnOrderChanged
+ New procedures - BeginOrderUpdate, EndOrderUpdate, SetupOrderFields
+ New properties - EditorHint, ToolTips, ToolTipsWidth, TransparentColor,
Images, AutoToggle, Hint, HeaderHint, HeaderHintRows,
ImageIndex, MarkerIndex, OrderIndex, PopupMenu
+ New procedures - ToggleMarker, UpdateMarkers
+ New procedures - ModifyOrderFileds, ExtractOrderFields, CommaToSemicolon,
SemicolonToComma
+ New Option - roAllPagesTitle, roAllPagesLegend
+ New Properties - PrintCurrentRow, PrintSelectedRows, PageLegend
+ New Events - AfterBandPrint, AfterPagePrint, AfterPreview, AfterPrint,
BeforeBandPrint, BeforePagePrint, BeforePrint, OnPrint,
OnReportCreate
X-Files Components 2.2 (March 21, 2001).
+ Context help system
+ Custom multiline editor
+ Support for BiDiMode property
X-Files Components 2.3 (July 17, 2001). First version for Delphi 6.
Little changes in source code.
X-Files Components 2.4 (November 25, 2001).
+ New Options - dgAutoUnselectOff, dgExtendedSelect
+ New properties - SelectionAnchor, DragRows
+ New procedures - SelectAll, SelectRows, InvertAll, InvertRows,
UnselectAll, UnselectRows, ColGetText, ColSetText,
DisablePosition, EnablePosition, PositionDisabled
+ New events - OnColGetText, OnColSetText
+ New properties - ListOptions (loAutoDropDown, loSelectNextValue, loAllowClearValue),
PickOptions (poDropDownList, poListItemOnly, poSelectPickText,
poStoreItemIndex, poAcceptPickList, poAcceptItemIndex), PickText
X-Files Components 2.5 (March 25, 2002).
+ New Options - dgInternalSelect
+ New HintOptions- hoDataHints, hoShowDataHints
+ New properties - IndicatorHint, Column.Hint
+ New events - OnColExpand, OnRowSelect
+ New HintCell - hcData, hcIndicator
+ New Options - roGroupForceNewPage
+ New properties - GroupExpression, Lines
+ New ReportBands- GroupHeader, GroupFooter, GroupTotals
+ New SysData - rdExpression, rdGrowExpression
+ New TotalType - ttGrowExpression
+ New ReportAlign- raStretchAll
X-Files Components 2.6 (September 17, 2002). First version for Delphi 7.
Little changes in source code.
X-Files Components 3.0 (September 7, 2003). First version for C++Builder 5 & 6.
+ New Installer - X-Files Components is now automatically installed
+ New XP Style - X-Files Components fully support Windows XP Style
+ New Options - dgForceSequence, dgThumbTracking, dgHotButtons
+ New properties - RecNumber, RecCount, AutoNumber, FixedTheme, GridStyle
+ New procedures - ForcedSequence, UpdateSequence, IsGridThemed
+ New class - TGridStyle (DataRowSpace, HeaderRowSpace, TitleRowSpace
TitleColMargin, VisualStyle)
+ New properties - PrepareNeeded, RecordNumber, RecordCount, PageCount,
CustomNumber, CustomCount, QRField, AfterPrepare
+ New Option - roSaveDfmAsText
+ New SaveReport - SaveReport as *.cpp source file (C++Builder source file)
+ New SysData - rdRecordNo, rdRecordCount, rdRecordNoPerCount, rdPageCount,
rdPageNoPerCount, rdCustomNo, rdCustomCount, rdCustomNoPerCount
+ New components - TXDBColumnsDialog, TXDBPrintColumnsDialog
X-Files Components 3.1 (January 1, 2004).
+ New property - Column.Report.AutoHeight
+ New Options - roAllowVAlignment, roMultiPartAutoHeight
+ New properties - AutoRowHeight, FixedCols, FixedColsCount
X-Files Components 3.2 (March 15, 2004). First version for Delphi 8 for .NET.
Little changes in source code for unification
X-Files Components 3.3 (July 20, 2004).
+ New properties - Ctl3DAuto, DoubleBuffered, EditorColor, FocusRect, HotButtons,
ListBorder, MarkerStyle, MarkerTransparent, ResizeOptions,
ScrollProp, SelectionColor, SelectRowColor, StripeColor,
WheelScrollRows, OnExpandClick, FlatSBMode, Position,
DataRowCount, ColumnsWidth, FixedColsWidth
+ New methods - ColumnAtDepth, DefaultEditorColor, DefaultSelectionColor,
DefaultSelectRowColor, DefaultStripeColor, DropDownMenu,
DropDownPoint, GotoPosition, MouseWheelScrollRows,
ThemesEnabled
+ New properties - CheckBoxKind, CheckBoxStyle, DialogOptions, DropDownMenu,
DropDownWidth, ExpandCols, ExpandStyle, Visibility,
Report.DialogOptions, Title.DropDownMenu
+ New class - TXScrollProp(AutoHidden, Color, ParentColor, ParentStyle,
Style, ThumbBar, WinXPMode)
+ New properties - PreviewSettings, StripeColor, OnReportDestroy
+ New methods - PrinterSetup, SaveToFile
+ New Options - roKeepPrinterSetup, roKeepDesignPrinterSetup,
roPreparePrinterSetup, roForceRGBColor
+ New class - TXQRPreviewSettings(FormHeight, FormWidth,
ShowSearch, ShowThumbs, WindowState, ZoomState)