JVCL Components: 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 | JVCL is a library of more than 600 Delphi visual and non-visual components (https://github.com/project-jedi/jvcl). Although heavily Windows-centered, some of them have been ported to Lazarus. This page intends to give a summary of the JVCL components available for Lazarus. Some of the info snippets were taken from <http://wiki.delphi-jedi.org/wiki/JVCL_Component_Overview>. | |
| 4 | 4 | ||
| 5 | 5 | ## Packages | |
| 6 | 6 | ||
| 7 | 7 | Due to the large number of components the original Delphi version is split into a variety of packages. The Lazarus port follows this convention because the user can install only the functionality needed. | |
| 8 | 8 | ||
| 9 | 9 | For each package, a runtime and designtime version is available. Runtime packages can be identified with an appended R, designtime packages with an appended D. In the requirements for a project always use the runtime package. | |
| 10 | 10 | ||
| 11 | 11 | ### JvCore | |
| 12 | 12 | ||
| 13 | 13 | Provides basic functionality needed by all other packages. | |
| 14 | 14 | ||
| 15 | 15 | ### JvStdCtrls | |
| 16 | 16 | ||
| 17 | 17 | Depends on package *JvCore*.\ | |
| 18 | 18 | Enhanced standard controls | |
| 19 | 19 | ||
| 20 | 20 | - **TJvCheckbox**: Has a property `LinkedControls`. Linked controls can be enabled/disabled according to the `Checked` state of the Checkbox. | |
| 21 | 21 | - **TJvPanel**: an extended panel with hot-tracking effects and automatic placement of child components (similar to LCL's `ChildSizing` property). Can be dragged and resize at runtime. See example project *JvPanelDemo*. | |
| 22 | 22 | - **JvCalcEdit**: a numeric edit control which opens a calculator dialog. | |
| 23 | 23 | ||
| 24 | 24 | ### JvCtrls | |
| 25 | 25 | ||
| 26 | 26 | Depends on packages *JvCore* and *JvStdCtrls*.\ | |
| 27 | 27 | Visual controls | |
| 28 | 28 | ||
| 29 | 29 | - **TJvBehaviorLabel**: a label with special display effects: Blinking, bouncing, scrolling, typing, appearing, "special", "code breaker". See demo *examples/JvBehaviorLabel*. | |
| 30 | 30 | -  **TJvMovableBevel**: a bevel which can be dragged and resized at runtime | |
| 31 | 31 | -  **TJvMovablePanel**: the same, but now for a panel. Note that this component does not belong to JVCL, it is a simple adaption of TJvMovableBevel to the panel case. | |
| 32 | 32 | -  **TJvRuler**: a ruler to indicate distances in centimeters, inches or pixels | |
| 33 | 33 | -  **TJvGroupHeader**: header with attached bevelled line. | |
| 34 | 34 | -  **TJvRollOut**: expandable panel with headerline. | |
| 35 | 35 | -     **TJvHtLabel**, **TJvHTCombobox**, **TJvHTListbox** and **TJvHint**: a set of controls which can display HTML text | |
| 36 | 36 | ||
| 37 | - | ||
| 38 | - | ||
| 39 | - | ||
| 40 | - | ||
| 37 | + |  | |
| 41 | 38 | ||
| 42 | 39 | - **TJvComboListBox**: a listbox which can display a combobox overlaying the selected listbox item. Assign a TPopupMenu to the DropdownMenu property and it will be shown when the combo button is clicked. You can also handle the OnDropDown event for custom handling when the button is clicked, or example, displaying a drop down form. These features are demonstrated in the *JvComboListBox* example project. | |
| 43 | 40 | - **TJvOfficeColorPanel**: a panel for color selection designed like the one used by Office 97. | |
| 44 | 41 | ||
| 45 | - | ||
| 46 | - | ||
| 47 | - | ||
| 48 | - | ||
| 42 | + |  | |
| 49 | 43 | ||
| 50 | 44 | - **TJvLookupAutoComplete**: adds autocompletion of TEdit by ListBox or StringList items. (In the original JVCL, this component is in the Core package.) | |
| 51 | 45 | ||
| 52 | 46 | ### JvCustom | |
| 53 | 47 | ||
| 54 | 48 | Depends on package *JvCore*\ | |
| 55 | 49 | Custom components | |
| 56 | 50 | ||
| 57 | 51 | -  **TJvValidateEdit**: General purpose edit control for text and numbers (integer, float, currency). MaxValue, MinValue, HasMaxValue, HasMinValue - Value is corrected when Edit loses focus. See demo in *JvValidateEdit*. | |
| 58 | 52 | -  **TJvTimeLine**: a one-dimensional calendar ("time-line") which can display various events and tasks. See demo *JvTimeLine*. | |
| 59 | 53 | -  **TJvTMTimeLine**: another timeline component. See demo *JvTMTimeLine*. | |
| 60 | 54 | -  **TJvGammaPanel**: advanced color selection tool for foreground and background colors. See demo *JvGammaPanel*. | |
| 61 | 55 | -  **TJvThumbView**: displays a list of images as thumbnails | |
| 62 | 56 | -  **TJvOutlookBar**: an accordeon-like bar of containers for other controls as used by Outlook 97. | |
| 63 | 57 | -  **TJvImagesViewer**: displays a list of images as thumbnails, similar to TJvThumbView. See *JvItemViewer* demo. | |
| 64 | 58 | -  **TJvImageListViewer**: dispays all images of a TImageList. See *JvItemViewer* demo. | |
| 65 | 59 | -  **TJvOwnerDrawViewer**: presents arbitrary information in a grid-like view. See *JvItemViewer* demo. | |
| 66 | 60 | ||
| 67 | - | ||
| 68 | - | ||
| 69 | - | ||
| 70 | - | ||
| 61 | + |  | |
| 71 | 62 | ||
| 72 | - | ||
| 63 | + | - **TJvChart**: component for drawing time-series charts. Some bugs... See *JvChartDemo* project. Removed: Incomplete, too many bugs. | |
| 73 | 64 | ||
| 74 | 65 | ### JvCmp | |
| 75 | 66 | ||
| 76 | 67 | Depends on package *JvCore*.\ | |
| 77 | 68 | Non-visual components | |
| 78 | 69 | ||
| 79 | 70 | - **TJvStrHolder**, **TJvMultiStringHolder**: a wrapper component making it easier to work with TStrings and TStringList at design time. Using TStrHolder component you can set TStrings properties and event handlers in form designer and hold a number of strings in your forms. | |
| 80 | 71 | - **TJvSpellChecker**: a spell-checker class with sample dictionaries for English and Dutch. See demo in folder *examples/JvSpellChecker* of the JVCL installation. | |
| 81 | 72 | ||
| 82 | - | ||
| 83 | - | ||
| 84 | - | ||
| 85 | - | ||
| 73 | + |  | |
| 86 | 74 | ||
| 87 | 75 | - **TJvProfiler**: --- to be written --- | |
| 88 | 76 | ||
| 89 | 77 | ### JvDB | |
| 90 | 78 | ||
| 91 | 79 | Depends on packages *JvCore*, *JvStdCtrls*, and *JvCtrls*\ | |
| 92 | 80 | Data-aware controls | |
| 93 | 81 | ||
| 94 | 82 | - **TJvSearchEdit**: a TEdit with incremental search capabilities within a field of a dataset. | |
| 95 | 83 | - **TJvDBLookupList** and **TJbDBLookupCombo**: lookup controls with additional features: | |
| 96 | 84 | - can display more than one column (the LookupDisplay property can contain a list of columns separated by a semicolon, the column width is calculated based on Field.DisplayWidth) | |
| 97 | 85 | - can display pictures (OnGetImage/OnGetImageIndex events) | |
| 98 | 86 | - configurable empty value (DisplayEmpty,EmptyItemColor,EmptyStrIsNull,EmptyValue) | |
| 99 | 87 | - **TJvDBTreeView**: a treeview constructed from database records. Link the unique ID field to "MasterField", the ID field of the parent node to "DetailField", and the field with the node text to "ItemField". Optionally, the field "IconField" provides the image index for the ImageList. "StartMasterValue" is the beginning level to start building the TreeView, 0 = start from the root itens, 1 = start from the second level, and so on. | |
| 100 | 88 | - **TJvDBCalcEdit**: a numeric edit box which opens a calculator dialog. | |
| 101 | 89 | ||
| 102 | 90 | > **Note:** The packages *JvStdCtrlsLazR* and *JvCtrlsLazR* must have been compiled before this package can be installed. | |
| 103 | 91 | ||
| 104 | 92 | ### JvAppFrm | |
| 105 | 93 | ||
| 106 | 94 | Depends on package *JvCore*\ | |
| 107 | 95 | Components for applications and forms | |
| 108 | 96 | ||
| 109 | 97 | - **JvAppAnimatedIcon** and **JvFormAnimatedIcon**: display an animated icon (created from an imagelist) in the taskbar and in the form's title bar, respectively. | |
| 110 | 98 | - **JvAnimTitle**: provides an animated form title | |
| 111 | 99 | - **JvFormWallpaper**: tiles the background of a form with an image. | |
| 112 | 100 | ||
| 113 | 101 | ### JvHMI | |
| 114 | 102 | ||
| 115 | 103 | Depends on package *JVCore*.\ | |
| 116 | 104 | The packages JvHDMILazR (run time) and JvHDMILazD (design time) provide some components for designing a "human-machine-interface" (HMI). | |
| 117 | 105 | ||
| 118 | 106 | - **JvLED**: an LED indicator. See demo *examples/JvLED*. | |
| 119 | 107 | - **JvDialButton**: a rotatory knob. See demo *examples/JvDialButton*. | |
| 120 | 108 | ||
| 121 | 109 | ### JvJans | |
| 122 | 110 | ||
| 123 | 111 | Depends on package *JvCore*.\ | |
| 124 | 112 | Named after the original author, Jan Verhoeven, who donated these components to the JEDI project. The following components have been ported: | |
| 125 | 113 | ||
| 126 | 114 | - [[JvSIM components|TJvSIM components]]: a set of components for simulation of digital and analog electronics. | |
| 127 | 115 | -  **JvJanLED**: an LED indicator component (not contained in original JVCL, ported from Jan Verhoeven's own repository). | |
| 128 | 116 | -  **JvJanToggle**: a toggle button with an on and off area (not contained in original JVCL, ported from Jan Verhoeven's own repository). | |
| 129 | 117 | -  **JvMarkupViewer** and  **JvMarkupLabel**: display simple HTML-formatted text (font-related tags only). Similar to JvHTControls. | |
| 130 | 118 | -  **TvGridFilter**: a component for filtering rows in a column-oriented stringgrid. Call `Filter(condition)` to hide all rows meeting the specified condition string, e.g. `[Business]="Music"` removes all rows in which the strings in the column titled `Business` are equal to `Music`. Allowed operators are `=`, `<>`, `<`, `>`, or `like`. See demo in folder *JvGridFilterDemo*. | |
| 131 | 119 | -  **JvYearGrid**: a year-calendar | |
| 132 | 120 | ||
| 133 | - | ||
| 134 | - | ||
| 135 | - | ||
| 136 | - | ||
| 121 | + |  | |
| 137 | 122 | ||
| 138 | 123 | ### JvMM | |
| 139 | 124 | ||
| 140 | 125 | Depends on package *JvCore*.\ | |
| 141 | 126 | The original JVCL package for Delphi contains a set of multimedia components, image and some general-purpose components. | |
| 142 | 127 | ||
| 143 | 128 | -  **JvID3v1**: a non-visual component for displaying and editing of ID3v1 tags of mp3 files. See demo *examples/JvID3v1*. | |
| 144 | 129 | -  **JvID3v2**: a non-visual component for displaying and editing of ID3v2 tags of mp3 files. See demo *examples/JvID3v2*. | |
| 145 | 130 | -  **JvAnimatedImage**: animates a series of images take from a glyph containing all images in a horizontal or vertical stripe. | |
| 146 | 131 | -  **JvBmpAnimator**: animates a series of images taken from a TImagelist. Unlike suggested by its name, it works with other image types as well in Lazarus. See demo *examples/JvBmpAnimator*. Similar to JvAnimatedImage. | |
| 147 | 132 | -  **JvImageTransform**: image transition effects like in a simple slide show. See demo *examples/JvImageTransform*. | |
| 148 | 133 | -  **JvSpecialImage**: an advanced image component with simple built-in image manipulation capabilities (flip, mirror, invert, fade-in, fade-out, brightness). Note that the Brightness property has been modified from the Delphi version to cover a more convenient scale from -100 to 100 (instead of 0 to 200). See demo *examples/JvSpecialImage*. | |
| 149 | 134 | -  **JvSpecialProgress**: an advanced progress bar with gradient and text display. See demo *examples/JvSpecialProgress*. | |
| 150 | 135 | -  **JvGradient**: draws several kinds of gradients (horizontal, vertical, elliptic, pyramidic). | |
| 151 | 136 | -  **JvGradientHeaderPanel**: a header bar with a gradient background (drawn by JvGradient). | |
| 152 | 137 | -  **JvFullColorLabel**: a label with attached color sample | |
| 153 | 138 | -  **JvFullColorDialog** and  **JvFullColorCircleDialog**: dialogs for color selection based on several color models. Use the  **JvFullColorTrackbar** for one-dimensional, and a  **JvFullColorPanel** and a  **JvFullColorCircle** for two-dimensional color selection. There is also a swatch-like  **JvFullColorGroup**. See demos *examples/JvFullColorDialog* and *examples/JvFullColorCircleDialog*. Similar to [[mbColorLib]], however, several color models are combined within the same control. | |
| 154 | 139 | ||
| 155 | - | ||
| 156 | - | ||
| 157 | - | ||
| 158 | - | ||
| 140 | + |  | |
| 159 | 141 | ||
| 160 | 142 | -  **JvPicClip**: similar to TImageList. Splices a large bitmap to a grid of `Cols x Rows` smaller images which can be retrieved as `Cells[ACol, ARow]` | |
| 161 | 143 | ||
| 162 | 144 | ### JvPageComps | |
| 163 | 145 | ||
| 164 | 146 | Depends on packages *JvCore* and *JvStdCtrls*\ | |
| 165 | 147 | * **TJvTabBar**: a panel of tabs like in a TTabControl. Fully configurable. Drawing is delegated to separate painter components, **TJvModernTabBarPainter** (used by default) and **TJvTabBarXPPainter**. See demo in folder *examples/JvTabBar*. | |
| 166 | 148 | ||
| 167 | 149 | - **TJvPageList**: a stack of pages like a TNotebook. Designed to cooperate with TJvTabBar and TJvPageListTreeView. See demo in folder *examples/JvTabBar_PageList*. | |
| 168 | 150 | - **TJvNotebookPageList**: a TNotebook descendant designed to cooperate with TJvTabBar. See demo in folder *examples/JvTabBar_NotebookPages*. Note that this component is not contained in the original Delphi JVCL collection. | |
| 169 | 151 | - **TJvNavigationPane**: a navigation panel similar to MS Outlook. See demo in the folder *examples/JvNavigationPane* of the Lazarus JVCL installation. | |
| 170 | 152 | ||
| 171 | - | ||
| 172 | - | ||
| 173 | - | ||
| 174 | - | ||
| 153 | + |  | |
| 175 | 154 | ||
| 176 | 155 | ### JvPascalInterpreter | |
| 177 | 156 | ||
| 178 | 157 | Scripting engine for Pascal. Depends on package *JvCore*. | |
| 179 | 158 | ||
| 180 | 159 | - **TJvInterpreterProgram**: Non-visual component interpreting Pascal code. Add code to the `Pas` Strings, execute if by the `Run` method and get the result from the `VResult` variant. See the tutorials in folder *example/JvInterpreterDemos*. There is also a (German) tutorial at [1](https://wiki.delphigl.com/index.php/Tutorial_Scripting_mit_JvInterpreterProgram). | |
| 181 | 160 | ||
| 182 | 161 | ### JvRuntimeDesign | |
| 183 | 162 | ||
| 184 | 163 | Depends on package *JvCore*. | |
| 185 | 164 | ||
| 186 | 165 | - A runtime **form designer**. See demo in folder *example/JvDesigner* of the JVCL installation. Note that the designer is not limited to the components shown on the demo's toolbar. Following the instructions in the header of the demo's main unit it is easy to register any other component. | |
| 187 | 166 | ||
| 188 | 167 | . | |
| 189 | 168 | ||
| 190 | 169 | ### JvTimeFramework | |
| 191 | 170 | ||
| 192 | 171 | Depends on package *JvCore*. Calendars and schedule planner, similar to [[Turbopower Visual PlanIt|TvPlanIt]]. Can compare schedules of several persons. | |
| 193 | 172 | ||
| 194 | 173 | - **TJvTFScheduleManager**: administration of data, access to database via events. | |
| 195 | 174 | - **TJvTFDays**, **TJvTFWeeks** or **TJvTFMonths** are day, week or month calendars, respectively, to display appointments. | |
| 196 | 175 | - **TJvTFDaysPrinter**: prints the appointments shown by TJvTFDays | |
| 197 | 176 | - **TJvTFGlanceTextViewer**: viewing parameters for TJvTFWeeks and TJvTFMonths | |
| 198 | 177 | ||
| 199 | 178 | See extended demo in *examples/JvTimeFramework* | |
| 200 | 179 | ||
| 201 | - | ||
| 202 | - | ||
| 203 | - | ||
| 204 | - | ||
| 180 | + |  | |
| 205 | 181 | ||
| 206 | 182 | ### JvValidators | |
| 207 | 183 | ||
| 208 | 184 | Depends on package *JvCore*.\ | |
| 209 | 185 | Various validator classes for input validataion. See demo in the folder *examples/JvValidators* of the Lazarus JVCL installation | |
| 210 | 186 | ||
| 211 | - | ||
| 212 | - | ||
| 213 | - | ||
| 214 | - | ||
| 187 | + |  | |
| 215 | 188 | ||
| 216 | 189 | - **TJvErrorIndicator**: Shows error indicators next to edit-fields etc. similar to "missing fields" indicators in web forumlars. | |
| 217 | 190 | - **TJvValidators**: To validate user input. Rightclick on Field editor to define validation rules. Checks are performed when method "Validate" is called. | |
| 218 | 191 | ||
| 219 | 192 | ### JvWizard | |
| 220 | 193 | ||
| 221 | 194 | Depends on package *JvCore*.\ | |
| 222 | 195 | * A multiplage dialog as used, e.g., for installation programs. Use the component editor to add pages with title, subtitle, images etc. at designtime ("welcome page", "interior page"). Buttons to navigate to other pages are automatically added. Additional navigation tools can be provided by adding a `TJvWizardRouteMapSteps`, `TJvWizardRouteMapNodes`, or `TJvWizardRouteMapList` component. See demo *JvWizard*.  | |
| 223 | 196 | ||
| 224 | 197 | ### JvXPCtrls | |
| 225 | 198 | ||
| 226 | 199 | Depends on package *JvCore* and *JvStdCtrls*.\ | |
| 227 | 200 | Several controls imitating the look and feel of Windows XP. | |
| 228 | 201 | ||
| 229 | 202 | - **JvXPButton** and **JvXPCheckbox**: a button and a checkbox in XP-style | |
| 230 | 203 | - **TJvXPProgressBar**: Draws a progressbar in XP-style. The color of the the background and of the blocks is configurable. Doesn't support Marquee-style. | |
| 231 | 204 | - **[[JvXPBar]]**: a container side-bar with collapsable panels. Similar to TJvRollOut-Panel, but with string items instead of controls. Collapsing/Expanding happens smooth and nicely animated. | |
| 232 | 205 | ||
| 233 | - | ||
| 234 | - | ||
| 235 | - | ||
| 236 | - | ||
| 206 | + |  | |
| 237 | 207 | ||
| 238 | 208 | ## Download and installation | |
| 239 | 209 | ||
| 240 | 210 | ### Download | |
| 241 | 211 | ||
| 242 | 212 | The developers version of the Lazarus port is available via svn from <https://sourceforge.net/p/lazarus-ccr/svn/HEAD/tree/components/jvcllaz/>. The current release version can be downloaded from <https://sourceforge.net/projects/lazarus-ccr/files/jvcllaz/>; it is also offered by the Lazarus Online Package Manager. | |
| 243 | 213 | ||
| 244 | 214 | ### Installation | |
| 245 | 215 | ||
| 246 | 216 | - **Released version** distributed by the Online Package Manager: check the "jvcllaz" item in the Online Package manager, click the *"Install"* button and follow the instructions. | |
| 247 | 217 | - **Development version** on Lazarus CCR (svn): | |
| 248 | 218 | - If you want to install **all JVCL packages**, load the package **jvcl_all.lpk** and select "Use" \> "Install". In older Lazarus versions, there will be a warning *"The package jvcl_all does not have any "Register" procedure which typically means it does not provide any IDE addon. Installing it will probably only increase the size of the IDE and may even make it unstable."*. You can ignore this and click on *"Install it, I like the fat"*. | |
| 249 | 219 | - If you want to install **only a few packages**, you must find out in above summary which other packages are needed. Compile the needed runtime packages (having an appended "R" at the package name). Then "Use" \> "Install" the required designtime packages (having an appended "D" as the package name). It is required to rebuild the IDE only after the last package. | |
| 250 | 220 | ||
| 251 | 221 | --- | |
| 252 | 222 | *From the Free Pascal wiki, page "JVCL Components", as it stood on 2020-04-30 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).* |