# Extended String Property Editor
ReadMe

## Description

This enhanced property editor has been designed to get round two limitations of the standard Delphi string property editor.

1. The standard property editor does not allow multi-line strings with embedded CR/LF characters to be entered via the object inspector. Such strings can only be assigned at run-time.
2. Although long Delphi strings have a 2Gb size limit, the standard property editor only accepts strings up to 255 characters long. Once again, longer strings must be assigned at run-time.

The property editor works with all properties of type string or TCaption of all components. It adds an ellipsis button to the right hand side of the data entry area in the object inspector. Clicking this button displays a dialogue box in which the property's value can be entered. Pressing return in the dialogue box starts a new line. There is no practical limit to the length of strings that can be entered.

Clicking OK (or pressing Ctrl+Return) causes the entered text to be assigned to the property. If, or how, any newline characters will be displayed in the object inspector depends on the version of Delphi being used.

The edit dialogue is resizeable. Word wrapping can be switched on or off. Both the word-wrapping and dialogue box size and position are persistent. The dialogue box has a toolbar that provides buttons to:

- Select all the text in the editor.
- Clear all the text from the editor.
- Overwrite the editor's existing text with text from the clipboard.
- Copy all the text from the editor to the clipboard.
- Undo the last edit.
- Load text into the editor from a file.
- Save the contents of the editor to a file.
- Display online help.

In addition the normal cut, copy and paste operations are available via a context menu and the usual keyboard short-cuts.

## Compatibility

The property editor is reported to compile and work with all Win 32 version of Delphi from Delphi 6 onwards.

## Installation

The Extended String Property Editor is supplied in a zip file. Before installing you need to extract all the files from the zip file. The following files will be extracted:

- `PJStringPE.pas` – Property editor source code.
- `PJStringPE.dfm` – Property editor form file.
- `ReadMe.htm` – This read-me file.
- `ChangeLog.txt` – Change log.
- `MPL-2.txt` – Mozilla Public License v2.0.
- `DocumentationWiki.URL` – Internet short-cut to online property editor documentation.

`PJStringPE.pas` and `PJStringPE.dfm` must be included in a design time package that is then installed into the IDE. If you need help doing this see here.

Note: you must ensure the package containing the property editor includes the DesignIDE package in its requires clause.

## Update History

A complete change log is provided in the file `ChangeLog.txt`.

## License and Credits

These components are released under the terms of the Mozilla Public License v2.0.

Thanks to the following who have contributed to this project:

Richard C Haven
Bino

All relevant trademarks are acknowledged.

## Acknowledgements

The property editor uses or adapts icons from the following collections:

- The 16×16 Free Application Icons packs by Aha-soft, licensed under a Creative Commons Attribution-Share Alike 3.0 license.
- The Free Pixelbox icon sets from Icojam, free to use in any kind of commercial or non-commercial project.

## Bugs and Feature Requests

Bugs can be reported or new features requested via the Issue Tracker.

If no similar report or request has been recorded already, use the New Issue link to add a new issue. Please select the most appropriate template from the Templates drop down list and change the `Project-unspecified` label to `Project-stringpe`.

## About the Author

I'm Peter Johnson – a hobbyist programmer living in Ceredigion in West Wales, UK, writing write mainly in Delphi. My programs and code are available from: http://www.delphidabbler.com/.

I can be contacted via the website.

Please let me know if you have any comments about the property editor, but please use the Issue Tracker above to report bugs and request new features.
This document is copyright © 2005-2013, P D Johnson, www.delphidabbler.com.