History

Compatibility issues

•Changes in packages for Lazarus: rvrichviewactionslaz_dsgn.lpk is removed. Install rvrichviewactionslaz.lpk instead (this package is "runtime + designtime")

•TrvActionParaBullets use Unicode characters in bullets in list templates (instead of characters of "Symbol" and "Wingdings" fonts)

Lazarus for Linux

RichViewActions can be used in Lazarus for Linux.

New component

TRVFontListBox (analog of TRVFontComboBox). Internally, it is used in the font dialog for Lazarus for Linux.

Changes

•dialogs are redesigned to look better both for Windows and Linux

•widths of all office radio buttons are calculated optimally (depending on the image and text widths), if they are arranged in a single row.

•HTML-style bullet and numbering dialog is obsolete and removed.

•TRVAControlPanel.DialogFontName now contains a list of font names in order of preference. This property is used only in the Windows version of RichViewActions. The default value is changed.

•new property TRVAControlPanel.DialogFontNameLin is used in the Linux version of RichViewActions.

•new value for TRVAControlPanel.DialogPosition: rvafpEditorFormCenter.

New TRVSpellInterface component allows using TRVSpellChecker (included in TRichView)

Support of "Windows 64-bit (Modern)" platform in C++Builder 12+.

Delphi and C++Builder 12 Athens are supported.

TrvActionInsertPicture allows inserting multiple images.

Support of decimal tab alignment (in TrvActionParagraph, TRVRuler and TRVRulerItemSelector).

Option to turn on/off smooth image resizing in TrvActionItemProperties.

New properties of TRVAControlPanel:

•TRVAControlPanel.DialogPosition – position of dialog windows

•TRVAControlPanel.DialogZoomPercent allows scaling all dialog windows

New action: TrvActionUserDefinedColor.

New events: TrvActionFontEx.OnShowingDialog, TrvActionParagraph.OnShowingDialog, TrvActionParaBorder.OnShowingDialog. They allow initializing dialogs with predefined values, instead of using attributes of the selected fragment.

New event: TrvActionSave.OnSave, it occurs on successful saving.

Compatibility issues

ImagePrefix, FileTitle, SaveOptions properties of TrvActionSave and TrvActionExport are removed. Use HTMLSaveProperties and DocParameters.Title properties of the target editor.

TRVAControlPanel.HTMLComponent is not removed but deprecated. It's highly recommended to remove rvHtmlImporter and rvHtmlViewImporter components from your application, because HTML loading methods of TRichView provide better results.

TRVAControlPanel.InitImportPictures, DoneImportPictures, DoImportPicture are removed. They are replaced by InitImportPicturesAndFiles and DoneImportPicturesAndFiles.

HTML

Since this version RichViewActions use TRichView methods for loading HTML, and new methods for saving HTML.

TRVAControlPanel.HTMLComponent property still can be used, but it is deprecated, because TRichView methods provide much better results than imported components. We plan to remove this property in future updates of RichViewActions.

Some properties for HTML export are removed from actions (see the compatibility issues above).

A component assigned to TRVAControlPanel.DownloadInterface can be used to download not only external pictures, but also external CSS files.

Other changes

New properties controlling a state of the "Default" checkbox in property dialogs:

•TrvActionItemProperties.DefaultChecked, DefaultPersistent

•TrvActionTableProperties.DefaultChecked, DefaultPersistent

You can implement your own way for choosing pictures using the new TRVAControlPanel.OnChoosePicture event.

Table properties dialog allows choosing cell height mode: "exactly" or "at least".

RAD Studio 11 Alexandria

RichViewActions can be used in Delphi and C++Builder 11 Alexandria.

Help files

RVA_SetHelpFile allows defining the help file that will be used in RichViewActions dialogs for the specified UI language.

TRVAControlPanel.UseDefaultHelpFile allows using Application.HelpFile.

TRVAControlPanel.HelpType allows choosing between using HelpContext and HelpKeyword properties.

RVSetHelpKeyword allows changing HelpKeyword for the given HelpContext.

Markdown

Markdown is supported not only as export format, but also as import format (TrvActionInsertFile) and document format (TrvActionOpen and TrvActionSaveAs)

RAD Studio 10.4 Sydney

RichViewActions can be used in Delphi and C++Builder 10.4 Sydney. Per-control VCL styling is supported; in dialogs, previews use the style of the target editor.

Localization

New UI translation: Slovenian

Files: DocX and Markdown

TrvActionOpen and TrvActionInsertFile support DocX files.

TrvActionExport support Markdown files.

Find and replace

New properties:

•TrvActionFind.FindText

•TrvActionReplace.FindText, ReplaceText

The actions do not display "not found" dialog after the user answered "No" to "continue search from the beginning/end?" anymore.

Other

Smooth scrolling to checkpoint (in TrvActionBookmarks and TrvActionInsertHyperlink.GoToLink).

Compatibility issues:

•RVA_ConvertToPixels and RVA_ConvertToTwips procedures have a new ARVStyle parameter.

•The following properties of TrvActionInsertSymbol are removed: AlwaysInsertUnicode, DisplayUnicodeBlocks, SymbolType

•String parameters are changed to TRVUnicodeString in the events:

oTRVAControlPanel.OnCustomFileOperation, OnDownload, OnGetHeaderFooterCode.

oTRVAPopupMenu.OnLiveSpellAdd, OnLiveSpellGetSuggestions, OnLiveSpellIgnoreAll, OnLiveSpellWordReplace

oTrvActionOpen.OnOpenFile

oTrvActionSave.OnSaving, OnDocumentFileChange

oTrvActionReplace.OnReplacing

oTrvActionInsertHyperlink.OnApplyHyperlinkToItem, OnGetHyperlinkTargetFromItem, OnHyperlinkForm

oTrvActionInsertPicture.OnInserting

oTrvActionInsertText.OnInsertText

•Support for KSDev ThemeEngine is discontinued

•RVAFormat function is moved from RichViewActions to RVAFuncs unit (you can simply use Format instead).

RAD Studio 10.3 Rio

RichViewActions can be used in Delphi and C++Builder 10.3 Rio.

Lazarus

RichViewActions can be used in Lazarus (for Windows 32-bit and 64-bit).

High-DPI display modes

All controls and dialogs in RichViewActions support high-dpi display modes.

"Per monitor" and "per monitor v2" modes are supported, if they are supported by the application (Delphi 10.1+ is required for "per monitor", Delphi 10.3+ for "per monitor v2").

Virtual image lists

New data modules are added for RAD Studio 10.3. They contain 16x16, 32x32, and selected 64x64 toolbar images in TImageCollection and TVirtualImageList components. Pascal and C++ versions of these data modules are available. Details are explained in the topic about TRichView icons.

New demo projects are included:

•DelphiUnicode\ActionTest_MultiRes\

•CBuilderUnicode\ActionTest_MultiRes\

These projects use virtual image lists and support "per monitor v2".

Changes in "Insert Symbol" dialog

Since this version "Insert Symbol" allows inserting only Unicode characters. Now it supports all UTF-32 characters.

•TrvActionInsertSymbol has new properties: CharCode, FontName, Protection.

Other changes

•new TrvActionEditNote.OnStartEditNote event

•new TrvActionInsertHyperlink.ScrollToCenter property

•new TRVFontComboBox.AutoCharset property

•ruler is updated to support high DPI screen modes

Compatibility issues:

•Ruler.pas is renamed to RVRulerBase.pas

•Color property is removed from Rules.Tabs[]

•new parameters in functions from MarkSearch unit

•No more compiler $defines for using Addict, you cannot add RVAddictSpell3 and RVAddictThesaurus3 properties to TRVAControlPanel. Use SpellInterface property instead. TrvActionAddictSpell3, TrvActionAddictThesaurus3 are removed, they are superseded by TrvActionSpellingCheck and TrvActionThesaurus. RVA_Addict3AutoCorrect function is removed, use TRVAAddictSpellInterface's auto-correct methods

•No more compiler $defines for using TIdHttp (Indy) and TClHttp (CleverComponents), you cannot add IdHttp and ClHttp properties to TRVAControlPanel. Use DownloadInterface property instead.

•No more compiler $defines for using RichViewXML, RvHtmlImporter and RvHtmlViewImporter, you cannot add RVXML, RVHTMLImporter, RVHTMLViewImporter properties to TRVAControlPanel. Use XMLComponent and HTMLComponent properties instead.

•The compiler $define for using TNT Controls is moved from RichViewActions.inc to RV_Defs.inc.

•TrvActionShowSpecialCharacters shows/hides checkpoints by default.

•The following properties are removed: TrvActionPasteSpecial.StoreFileName, TrvActionInsertPicture.StoreFileName, TrvActionTableProperties.StoreImageFileName, TrvActionItemProperties.StoreImageFileName. Instead of these properties, the actions check rvoAssignImageFileNames in the Options property of the target editor.

New "interface" components

Interface components provide an intermediate layer between RichViewActions and third-party components, so RichViewActions can use third-party components without compiler $defines.

New properties are added to TRVAControlPanel: ColorDialogInterface, DownloadInterface, SpellInterface.

Interface components for using TdxColorDialog, Indy, CleverComponents, Addict, ASpell, ExpessSpellChecker, HunSpell, Polar SpellChecker are added.

File loading and saving components

Previously, programmers needed to add $defines in RichViewActions.inc to allow using RichViewXML, RvHtmlImporter and RvHtmlViewImporter in RichViewActions. Now, you can use XMLComponent and HTMLComponent properties of TRVAControlPanel.

Checkpoints (Bookmarks)

New action TrvActionBookmarks allows adding and managing checkpoints.

In TrvActionInsertHyperlink, the editor of the link target is now a combo-box containing a list of checkpoint names.

TrvActionShowSpecialCharacters can show/hide checkpoints.

Mathematical formulas (equations)

New action: TrvActionInsertEquation. TrvActionItemProperties can edit properties of equation items.

Font preview

TRVFontComboBox can display preview of fonts. It has new properties: Preview, DropDownWidth, SymbolPreviewString.

The dialog of TrvActionFontEx can display a preview of font names in the list as well. It has a new property: PreviewInList.

Changes related to tables

•TrvActionInsertTable has new properties to assign to table (HeadingRowColor and other colors, ColBandSize, RowBandSize) and to table rows (RowsVAlign, RowsKeepTogether).

•The table properties dialog (displayed by TrvActionItemProperties and TrvActionTableProperties) allows defining colors of rows and columns.

•new properties TrvActionItemProperties.UpdateAllInsertTableActions and TrvActionTableProperties.UpdateAllInsertTableActions allows applying default properties to all "insert table" actions on the same form/datamodule.

•The "Default" check box in the table properties affects not only the page "Table", but also pages "Rows" and "Columns".

Changes related to printing

•TrvActionInsertPageBreak and TrvActionRemovePageBreak, when called from a table cell, add and remove page breaks before the current table row.

•PageNumberType property is added to TrvActionInsertPageCount. For inserted "page count" fields, a number type can be changed by TrvActionItemProperties.

•New TRVAControlPanel.OnGetHeaderFooterCode event.

Other changes

•OnInserting event is added to TrvActionInsertPicture.

•new property TRuler.TickColor for drawing ticks and tab stops.

•New untranslated features can be hidden using ShowUntranslatedControls variable.

•MarkSearch functions are improved

•Packages were separated into runtime and designtime packages. RVARibbonUtils.pas (unit providing TRibbon support) is moved to a separate runtime package.

Compatibility issues:

TrvActionItemProperties and TrvActionTableProperties update linked TrvActionInsertTable and TrvActionInsertHLine actions when the user checks "Default" checkbox. Previously, they were always updated when assigned explicitly.

Installation and directory structure

Starting from this update, RichViewActions are installed automatically in Delphi and C++Builder IDE together with TRichView.

The new installer installs the components in Delphi and C++Builder, both for 32-bit and 64-bit platforms (if available). The installer adds all necessary paths to RAD Studio library.

Source code is moved to "Source" folder, inc-files are moved to "Source\Include" folder, demo projects are moved to "Demos" folder.

This help file is integrated in RAD Studio IDE (for XE8+)

New actions

TrvActionAlignDistribute aligns the selected paragraph to the both left and right sides by adding space between all characters.

TrvActionInsertPageCount inserts a page count field.

Changes related to paragraph alignments

TrvActionAlignJustify (as well as TrvActionAlignDistribute) has new properties: LastLineAlignment and UseLastLineAlignment.

TrvActionParagraph has a new property: LastLineAlignment.

New properties:

•TRVAControlPanel.MetafileCompatibility affects printing of TSRichViewEdit components;

•TrvActionSave.DisableWhenUnmodified allows to disable the action for unmodified documents.

TrvActionRemovePageBreak removes a page break from the current paragraph (not the current item as before).

TrvActionItemProperties and TrvActionTableProperties update linked TrvActionInsertTable and TrvActionInsertHLine actions when the user checks "Default" checkbox.

Compatibility issues:

•TrvActionFontEx.Font.Size is no longer used. Existing code must be changed to use TrvActionFontEx.FontSizeDouble instead.

•'Francais' cannot be used as a lanuage name; use 'French' or 'Français'.

New actions

TrvActionInsertTextBox inserts a floating box

TrvActionInsertFootnote inserts a footnote

TrvActionInsertEndnote inserts an endnote

TrvActionInsertSidenote inserts a note in a floating box

TrvActionEditNote displays a window for editing a note or a floating box

TrvActionInsertNumber inserts a "numbered sequence" item

TrvActionInsertCaption inserts a caption for an image or a table

TrvActionInsertPageNumber inserts a "page number" field

Changes

TrvActionExport can export DocX files (without office converters). Make sure that ffeDocX is included in Filter.

Changes made by TrvActionColor, TrvActionBackground can be undone.

New property: TrvActionFontEx.FontSizeDouble.

TRVFontSizeComboBox supports fractional font sizes.

Changes in TrvActionItemProperties:

•properties for sidenotes and text boxes

•properties for "numbered sequence" items

•properties for "page number" item

•redesigned picture properties pages

•redesigned table properties pages

•changes can be applied to ActionInsertTable and ActionInsertHLine (in addition to the current item)

Changes in TrvActionNew:

•Reset is made public.

•new item is included in StyleTemplates: 'caption'.

New TrvActionInsertPicture properties to assign to inserted pictures: BackgroundColor, BorderWidth, BorderColor, OuterHSpacing, OuterVSpacing.

New TrvActionInsertTable properties to assign to inserted tables: CellHPadding and CellVPadding (they replace CellPadding), VisibleBorders, BackgroundStyle, BackgroundPicture.

TRVAControlPanel.DialogFontName's default value is changed to 'Tahoma'.

New RemoveEllipsisFromRibbon procedure replaces RemoveEllipsis.

Languages have two names specified: a name in English and a native name.

Compatibility issues:

TRVAControlPanel.TableGridStyle property is removed.

Redesigned control panel

TRVAControlPanel is redesigned. It does not assign global variables any more. You can have more than one control panel in a single application. New properties of TRVAControlPanel: Header, Footer.

New actions

Styles:

TrvActionStyleTemplates

TrvActionAddStyleTemplate

TrvActionClearFormat

TrvActionClearTextFormat

TrvActionStyleInspector

Cell rotation:

TrvActionTableCellRotationNone

TrvActionTableCellRotation90

TrvActionTableCellRotation180

TrvActionTableCellRotation270

Table operations:

TrvActionTableSplit

TrvActionTableSort

TrvActionTableToText

New and improved components

New components for applying style templates:

TRVStyleTemplateComboBox

TRVStyleTemplateListBox

Improved components (can be linked to an editor, do not require additional code any more):

TRVFontComboBox

TRVFontSizeComboBox

TRVFontCharsetComboBox

ScaleRichView support

You can assign not only TRichViewEdit, but also TSRichViewEdit to TRVAControlPanel.DefaultControl, or Control properties of actions.

Simplification: since this version, when using ScaleRichView, you do not need to assign RVA_GetRichViewEditFromPopupComponent and RVA_GetRichViewEdit variables, you do not need to call SRichViewEdit.SetRVMargins in TRVAControlPanel.OnMarginsChanged.

Visual changes

Delphi XE2+'s visual styles are supported in components and dialogs. The function RVA_ChooseStyle allows choosing and applying one of available styles.

Inverted (a light text on a dark background) color schemes are supported.

Text files

The file actions allow choosing a code page for text files (including UTF-8). This feature can be disabled by assigning TRVAControlPanel.UseTextCodePageDialog=False.

New features, properties and events

A new event TRVAControlPanel.OnGetActionControlCoords allows to specify coordinates for color-picker windows when actions are linked to non-visual components (for example, when using ExpressBars by Developer Express).

TrvActionNew resets styles according to StyleTemplates, if style templates are used. TrvActionOpen can use a linked TrvActionNew to reset document before loading.

TrvActionPasteSpecial:

•allows pasting URLs;

•respects RichViewEdit.AcceptPasteFormats property;

•if style templates are used, displays style modes for pasting RTF and RVF.

TrvActionFontEx can change a text background color (new BackColor property).

TrvActionInsertHyperlink can apply HoverUnderlineColor and HoverEffects properties (if style templates are not used). If style templates are used, it applies the chosen StyleTemplateName.

TrvActionTableGrid shows/hides grid only in the target editor.

In the print preview form (TrvActionPrintPreview), a mouse wheel changes pages, Ctrl +mouse wheel zooms in/out

New optional parameters in NormalizeRichView.