TX Text Control ActiveX 25.0 lets you protect a document, with or without a password, and leave editable regions in it that named users can still change. The version also brings objects in headers and footers, the selection of objects behind the text and pagination options in tables. What follows lists the features and members added since version 24.0, each linked to its reference page.

New Features

Objects in headers and footers. While a header or a footer is activated, you can insert images, text frames and other objects anywhere on the page. The object is then shown in the background of every page on which the header or footer appears, which gives you watermarks and other page background images. Insert such an object at a fixed position on the page with ImageInsertFixed, TextFrameInsertFixed or ObjectInsertFixed. The height of the header or footer does not depend on the position of these objects.
Documents with restricted access. TXTextControl can now edit documents with restrictions, such as forbidding editing, printing, formatting or copying contents to the clipboard:
- You specify the restrictions with DocumentPermissions. They are activated when EditMode is changed from Edit to Protected or Password Protected.
- With Password Protected, a dialog box opens in which the user enters a password that protects the restrictions. To unprotect the document, the same password must be entered when the edit mode is reset to Edit.
- The set of permissions and the password are saved in the document in encrypted form. A password-protected document is opened read-only when it is loaded.
- The supported formats are RTF, Microsoft Word (DOC and DOCX), Adobe PDF and the TX Text Control format (TX).
Editable regions. An editable region is a piece of text that stays editable when EditMode is set to Protected or Password Protected:
- A region is defined by a start position and a length, or by a selection. Regions can overlap.
- EditableRegionInsert inserts a region and EditableRegionDelete deletes it.
- Each region belongs to a user through EditableRegionUserName. Only this user can edit the region when the document is read-only. An empty user name lets everyone edit the region. UserNames specifies the users who have access to the document.
- EditableRegionEntered and EditableRegionLeft occur when a region is entered or left.
- An editable region is highlighted on the screen. By default, the highlight color depends on the user name; you can set a certain color when you insert the region.
- In a protected document with editable regions, whether editing and formatting are possible depends on the current text input position. The new properties CanEdit, CanCharacterFormat, CanParagraphFormat and CanTableFormat tell you what is possible. Use them to enable or disable the menu items and buttons of your application.
Selection of objects in the background. SelectObjects controls the selection of objects behind the text. When it is True, a mouse click selects the object in the background. When it is False, the click selects the text in front of the object.
Pagination in tables. Pagination options let an end user control where TXTextControl places automatic page breaks. The settings "keep with next" and "page break before" now work in tables as well. Because a table row consists of several paragraphs, the first paragraph of a row determines how the complete row is treated, and the pagination options of all other paragraphs are ignored. With "page break before", the complete row moves to a new page. With "keep with next", the complete row is placed on the same page as the row that follows it.

New Properties, Methods and Events

All new members belong to TXTextControl.

Properties

Member	Description
CanCharacterFormat	Informs whether character formatting attributes can be changed for the currently selected text.
CanDocumentFormat	Informs whether page and section formatting attributes can be changed.
CanEdit	Informs whether the document's text can be changed at the current text input position.
CanParagraphFormat	Informs whether paragraph formatting attributes can be changed for the currently selected text.
CanPrint	Informs whether the document can be printed.
CanStyleFormat	Informs whether the document can be formatted with formatting styles.
CanTableFormat	Informs whether table formatting attributes, the table layout or both can be changed for the currently selected text.
DocumentPermissions	Specifies how the document can be edited and formatted when EditMode is changed from Edit to Protected or Password Protected.
EditableRegionUserId	Returns or sets a user-defined identifier of an editable region.
EditableRegionUserName	Returns or sets the name of the user who can edit the region.
SelectObjects	Controls the selection of objects, such as images and text frames, that are inserted behind the text.
UserNames	Gets or sets a list of names of the users who have access to a document.

Methods

Member	Description
EditableRegionDelete	Deletes an editable region from the document.
EditableRegionGoto	Sets the current input position to the beginning of the specified editable region and scrolls the text so that this position is at the top of the control's visible text.
EditableRegionInsert	Inserts a new editable region in the text.

Events

Member	Description
EditableRegionEntered	Occurs when the current input position has been moved to a position that belongs to an editable region.
EditableRegionLeft	Occurs when the current input position has left an editable region.

Extended Properties, Methods and Events

Member	Change
EditMode property	The new value 3 - Password Protected password-protects the read-only edit mode.

What's New in TX Text Control ActiveX 25.0