LMD VCL - Unicode Support - Revision history

Balabuyew: /* General unicode support notes: */

2021-04-08T12:35:08Z

‎General unicode support notes:

Balabuyew: /* General unicode support notes: */

2021-04-08T12:34:35Z

‎General unicode support notes:

Balabuyew: /* Detailed notes (units contains in LMDRTL package) */

2021-04-08T12:31:00Z

‎Detailed notes (units contains in LMDRTL package)

Rafael: LMD-Tools 8 - Unicode Support moved to LMD VCL - Unicode Support

2008-10-05T12:33:34Z

LMD-Tools 8 - Unicode Support moved to LMD VCL - Unicode Support

Rafael at 00:09, 14 November 2007

2007-11-14T00:09:02Z

Fduch: /* Detailed notes (units contains in LMDRTL package) */

2007-11-10T13:55:35Z

‎Detailed notes (units contains in LMDRTL package)

Fduch: /* Detailed notes (units contains in LMDRTL package) */

2007-11-10T13:55:14Z

‎Detailed notes (units contains in LMDRTL package)

Fduch: /* Detailed notes */

2007-07-30T18:47:43Z

‎Detailed notes

Fduch: /* Detailed notes */

2007-07-30T18:46:36Z

‎Detailed notes

Fduch at 18:45, 30 July 2007

2007-07-30T18:45:38Z

@@ Line 4: / Line 4: @@
 * Starting from 2021 release LMD libraries support only Unicode IDE version, so most of  our native Unicode support was deprecated.
 * String type is now used accross the code, since it supports Unicode natively by IDE.
-* One symbol, in general case, isn't equal one byte - <b>it's very important</b>
+* One symbol, in general case, isn't equal one byte.
 * Use Unicode API function instead of its Ansi version. These function has W suffix. As example DrawTextW, ExtTextOutW etc.
 * For any operation on Unicode string use routines from LMDStrings.pas (must be in core modules).

@@ Line 2: / Line 2: @@
 == General unicode support notes: ==
-* Use WideString instead of String (if library has ansi version, the use defines (see TLMDString type))
+* Starting from 2021 release LMD libraries support only Unicode IDE version, so most of  our native Unicode support was deprecated.
 * One symbol, in general case, isn't equal one byte - <b>it's very important</b>
 * Use Unicode API function instead of its Ansi version. These function has W suffix. As example DrawTextW, ExtTextOutW etc.
-* For any operation on unicode string use routines from LMDStrings.pas (must be in core modules)
+* For any operation on Unicode string use routines from LMDStrings.pas (must be in core modules).
 == Detailed notes (units contains in LMDRTL package) ==

@@ Line 10: / Line 10: @@
 == Detailed notes (units contains in LMDRTL package) ==
-'''LMDUnicode''' Unit contains Unicode related low level implementation. All implementation is made in terms of WideString and WideChar standard Delphi types. Services provided by this unit assumed to be not depended of LMD_UNICODE compiler switch, because they can be used in some special situations, for example for working with Unicode enabled external COM objects, like script engines, ect.
+'''LMDUnicode''' Unit contains Unicode related low level implementation. Services provided by this unit can be used in some special situations, for example for working with Unicode enabled external COM objects, like script engines, ect.
-'''LMDUnicodeStrings''' Unit defines TLMDWideStrings and TLMDWideStringList classes. As in previous unit this types assumed to be independed of LMD_UNICODE compiler switch. However, in .Net Vcl versions TLMDWideStrings and TLMDWideStringList are declared as aliases to Delphi standard TStrings and TStringList classes, since there classes already Unicode enabled in .Net. The later fact does not affect primary notion of TLMDWideStrings and TLMDWideStringList classes – they are still Unicode enabled string lists.
+The usage of WideString and WideChar types has been replaced with string and Char types correspondingly starting from 2021 release. Function names have been changed from LMDWideXXX to LMDUnicodeXXX.
-'''LMDTypes''' Unit finally declares string and character types that must be used consistently in controls development and other routines, based on our Unicode support strategy. Only Unicode implementation itself and special cases are assumed to use WideString type directly.
+'''LMDUnicodeStrings''' Unit is deprecated starting from 2021 release. It still defines TLMDWideStrings and TLMDWideStringList deprecated classes. Standard Delphi string list classes like TStrings and TStringList should be used instead.
-Following types are defined: TLMDString, TLMDChar, PLMDChar, TLMDStrings and TLMDStringList. There types are depends of LMD_UNICODE compiler switch.
 '''LMDStrings''' Unit contain many string utilities.
@@ Line 21: / Line 22: @@
 LMDAnsiXXX version – uses standard Delphi string type. Please note, that this is actually a version that always consistent with any Vcl version. It actually Unicode for Unicode Vcl (in .Net).
 LMDWideXXX version – always uses WideString type. Unicode in any Vcl version.
-LMDXXX version – uses our TLMDString type. The behavior depends of LMD_UNICODE compiler switch. Just like our string types, this version of utilities should be used consistently in controls development. Specialized versions are provided for old non-Unicode controls and special cases.
+LMDXXX version – uses standard Delphi's string type since 2021 release (previously, TLMDString type used).
-'''LMDUnicodeCtrls''' Unit provides subset of unicode enabled standard controls with LMDUnicodeControl unit help. It can be used in Windows NT family OSes to show and manipulate unicode data.
+'''LMDUnicodeControl''' Unit is renamed to LMDHintHooks and no longer relates to Unicode support in our libraries.
-'''LMDUnicodeDialogs''' Unit contains 2 classes - TLMDOpenDilaog and TLMDSaveDialog, that supports unicode features of Windows NT family OSes. They can be used to open/save files with unicode names, can be customized by unicode strings (unicode Title, Filters etc.). Also they used by TLMDFileOpenDialog/TLMDFileSaveDialog (since LMD Tools 2007.1) as Windows XP replacement of Windows Vista new dialogs.
+'''LMDUnicodeCtrls''' Unit is deprecated now and provides references to deprecated control types: TLMDWideButton, TLMDWideCheckBox and TLMDWideRadioButton.
-Discussing Unicode controls we must denote two different tasks:
+'''LMDUnicodeDialogs''' Unit contains 2 classes - TLMDOpenDilaog and TLMDSaveDialog, that supports unicode features of Windows NT family OSes. They can be used to open/save files with unicode names, can be customized by unicode strings (unicode Title, Filters etc.). Also they used by TLMDFileOpenDialog/TLMDFileSaveDialog (since LMD Tools 2007.1) as Windows XP replacement of Windows Vista new dialogs.

← Older revision		Revision as of 00:09, 14 November 2007
Line 1:		Line 1:
		+	{{HEAD-ResOnly}}
		+
	== General unicode support notes: ==		== General unicode support notes: ==
	* Use WideString instead of String (if library has ansi version, the use defines (see TLMDString type))		* Use WideString instead of String (if library has ansi version, the use defines (see TLMDString type))

@@ Line 28: / Line 28: @@
 '''LMDUnicodeCtrls''' Unit provides subset of unicode enabled standard controls with LMDUnicodeControl unit help. It can be used in Windows NT family OSes to show and manipulate unicode data.
-'''LMDUnicodeDialogs''' Unit contains 2 classes - TLMDOpenDilaog and TLMDSaveDialog, that supports unicode features of Windows NT family OSes. They can be used to open/save files with unicode names, can be customized by unicode strings (unicode Title, Filters etc.). Also they used by TLMDFileOpenDialog/TLMDFileSaveDialog (since LMD Tools 2007.1) as Windows XP replacement of Windows Vista new dialog.
+'''LMDUnicodeDialogs''' Unit contains 2 classes - TLMDOpenDilaog and TLMDSaveDialog, that supports unicode features of Windows NT family OSes. They can be used to open/save files with unicode names, can be customized by unicode strings (unicode Title, Filters etc.). Also they used by TLMDFileOpenDialog/TLMDFileSaveDialog (since LMD Tools 2007.1) as Windows XP replacement of Windows Vista new dialogs.
 Discussing Unicode controls we must denote two different tasks:
 Unicode enabled control interface;
 Implementation of the control that allow it to work with Unicode properly.

← Older revision	Revision as of 12:33, 5 October 2008
(No difference)

@@ Line 7: / Line 7: @@
 * Win 9x/Me has very poor unicode support and need to check all controls on these OSes.
-== Detailed notes ==
+== Detailed notes (units contains in LMDRTL package) ==
 '''LMDUnicode''' Unit contains Unicode related low level implementation. All implementation is made in terms of WideString and WideChar standard Delphi types. Services provided by this unit assumed to be not depended of LMD_UNICODE compiler switch, because they can be used in some special situations, for example for working with Unicode enabled external COM objects, like script engines, ect.

← Older revision		Revision as of 18:45, 30 July 2007
Line 6:		Line 6:
	* For unicode string lists use classes from LMDUnicodeStrings		* For unicode string lists use classes from LMDUnicodeStrings
	* Win 9x/Me has very poor unicode support and need to check all controls on these OSes.		* Win 9x/Me has very poor unicode support and need to check all controls on these OSes.
		+
		+	== Detailed notes ==
		+	==='''LMDUnicode'''=== Unit contains Unicode related low level implementation. All implementation is made in terms of WideString and WideChar standard Delphi types. Services provided by this unit assumed to be not depended of LMD_UNICODE compiler switch, because they can be used in some special situations, for example for working with Unicode enabled external COM objects, like script engines, ect.
		+
		+	==='''LMDUnicodeStrings'''=== Unit defines TLMDWideStrings and TLMDWideStringList classes. As in previous unit this types assumed to be independed of LMD_UNICODE compiler switch. However, in .Net Vcl versions TLMDWideStrings and TLMDWideStringList are declared as aliases to Delphi standard TStrings and TStringList classes, since there classes already Unicode enabled in .Net. The later fact does not affect primary notion of TLMDWideStrings and TLMDWideStringList classes – they are still Unicode enabled string lists.
		+
		+	==='''LMDTypes'''=== Unit finally declares string and character types that must be used consistently in controls development and other routines, based on our Unicode support strategy. Only Unicode implementation itself and special cases are assumed to use WideString type directly.
		+	Following types are defined: TLMDString, TLMDChar, PLMDChar, TLMDStrings and TLMDStringList. There types are depends of LMD_UNICODE compiler switch.
		+
		+	==='''LMDStrings'''=== Unit contain many string utilities.
		+	Almost every function is duplicated three times:
		+	LMDAnsiXXX version – uses standard Delphi string type. Please note, that this is actually a version that always consistent with any Vcl version. It actually Unicode for Unicode Vcl (in .Net).
		+	LMDWideXXX version – always uses WideString type. Unicode in any Vcl version.
		+	LMDXXX version – uses our TLMDString type. The behavior depends of LMD_UNICODE compiler switch. Just like our string types, this version of utilities should be used consistently in controls development. Specialized versions are provided for old non-Unicode controls and special cases.
		+	Also two proxy string-list types are defined:
		+	''TLMDStringsProxy'' – is an adapter that adapts TLMDStrings object to TStrings interface.
		+	''TLMDAnsiStringsProxy'' – is an adapter that adapts TStrings object to TLMDStrings interface.
		+
		+	==='''LMDUnicodeControl'''=== Unit provide utilities for implementing Unicode enabled GUI controls in Vcl. All utilities in this unit are declared in terms of our string types. The behavior of utilities depends of LMD_UNICODE compiler switch. Just like for our string types, the utilities are designed to be used unconditionally in controls development. The primary goal is to hide LMD_UNICODE compiler switch and Vcl version differences.
		+
		+	Discussing Unicode controls we must denote two different tasks:
		+	Unicode enabled control interface;
		+	Implementation of the control that allow it to work with Unicode properly.