Lazarus 3.0 release notes: what changed

Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		## LCL Interfaces Changes
2	2
3	3		### Cocoa
4	4
5	5		- IME fully supported, such as Chinese/Japanese/Korean, DeadKeys, Emoji & Symbols.
6	6		- Multi Displays/Monitors fully supported.
7	7		- Docking fully supported, including the IDE.
8	8		- Cursor completely refactored and significantly improved, compatible with macOS Ventura.
9	9		- TPageControl significantly improved.
10	10		- Many controls improved (TComboxBox/TListBox/TDateTimePicker/TStaticText/TSpeedButton/TPanel etc.)
11	11		- Many memory leaks fixed.
12	12
13	13		### Qt
14	14
15	15		- Implemented TCheckBox.Alignment and TRadioButton.Alignment.
16	16		- Implemented TCustomComboBox.AdjustDropDown and TCustomComboBox.ItemWidth.
17	17
18	18		### Qt5
19	19
20	20		- Qt5 uses native event loop on all platforms. C bindings are updated. Minimum C bindings version for lazarus 3.0 is 1.2.15.
21	21		- Note that most Linux Distributions will not have an appropriate libqt5pas library until their next release after the formal release of Lazarus 3.0. Build your own from the Lazarus source tree or download from <https://github.com/davidbannon/libqt5pas/releases/latest>
22	22		- Implemented TCheckBox.Alignment and TRadioButton.Alignment.
23	23		- Implemented TCustomComboBox.AdjustDropDown and TCustomComboBox.ItemWidth.
24	24
25	25		### Qt6
26	26
27	27		- Qt6 widgetset implemented. C bindings are based on Qt6 6.2.0 LTS. Minimum C bindings version for lazarus 3.0 is 6.2.7.
28	28		- Note that most Linux Distributions will not have an appropriate libqt6pas library until their next release after the formal release of Lazarus 3.0. Build your own from the Lazarus source tree or download from <https://github.com/davidbannon/libqt6pas/releases/latest>
29	29		- Implemented TCheckBox.Alignment and TRadioButton.Alignment.
30	30		- Implemented TCustomComboBox.AdjustDropDown and TCustomComboBox.ItemWidth.
31	31
32	32		### Gtk3
33	33
34	34		- Gtk3 pascal bindings are completely reworked.
35	35		- A number of stability improvements.
36	36		- Now requires GTK \>= 3.24.24 and Glib2.0 \>= 2.66
37	37
38	38		## LCL Changes
39	39
40	40		### TCustomImageList
41	41
42	42		TCustomImageList made more extensible:
43	43
44	44		1. Protected MarkAsChanged method is added, which sets FChanged to true (this allows to make custom triggers for OnChange event).
45	45		2. Virtual protected DoAfterUpdateStarted and DoBeforeUpdateEnded methods are added. They are called in first BeginUpdate and last EndUpdate respectively.
46	46
47	47		### TTaskDialog
48	48
49	49		- Old behaviour Win32: A placeholder icon was used for FooterIcon = tdiNone and MainIcon = tdiNone.
50	50		- New behaviour Win32: No icon is used for FooterIcon = tdiNone and MainIcon = tdiNone.
51	51		- Reason: Removing drawing glitch. The text move over to allow more content and better alignment. See [Issue \#39172](https://bugs.freepascal.org/view.php?id=39172)
52	52
53	53		### TSpeedButton
54	54
55	55		- Old behaviour: Multi-line captions could only be entered by code. And multi-line captions were always left-aligned.
56	56		- New behaviour: Multi-line captions can also be entered in the object inspector. New property Alignment to specify whether the caption should be left-/right-aligned or centered. Default: centered, like in Delphi.
57	57		- Reason: Better usability.
58	58
59	59		### TLabel.Transparent, .Color and .ParentColor changes
60	60
61	61		- Old behaviour: Transparent property was bound to Color=clNone
62	62		- New behaviour: Transparent is a standalone property
63	63		- Reason: Delphi compatibility and to fix ParentColor issues.
64	64		- Remedy: If you are setting the Color property, Transparent is not automatically switched from True to False now, you have to do it yourself. This is in compliance with Delphi and also solves problems with Color/ParentColor changes.
65	65
66	66		### TPanel.VerticalAlignment
67	67
68	68		- Old behaviour: The panel caption was always centered vertically.
69	69		- New behaviour: The new property VerticalAlignment (taAlignTop, taAlignBottom, taVerticalCenter) allows to place the caption also at the top or bottom of the panel interior.
70	70		- Reason: Delphi compatibility and better usability
71	71
72	72		### TCalendar
73	73
74	74		- Properties MinDate and MaxDate are implemented. These limits are only imposed if MaxDate \> MinDate. Unfortunately GTK2/3 widgetsets do not support this, so selecting a date outside the MinDate/MaxDate range will still be possible there.
75	75
76	76		### TCheckbox, TRadioButton
77	77
78	78		- Different calculation of checkbox/radiobutton size in order to correctly take care of Win-10 "ease of access" feature. See [issue \#39398](https://gitlab.com/freepascal.org/lazarus/lazarus/-/issues/39398)
79	79		- Consequence: lfm files will contain different sizes of these controls (if auto-sized) compared with earlier versions.
80	80
81	81		### Grids
82	82
83	83		- You can now set the cell editors properties ParentColor and ParentFont by including goEditorParentColor resp. goEditorParentFont in the grid's Options2 property.
84	84
85	85		### TShellTreeView
86	86
87	87		- New property `ExpandCollapseMode` defining options whether a collapsing node should clear its child nodes.
88	88		- Implements custom sorting of the treeview items by setting `FileSortType` to `fstCustom` and providing a custom compare function in the event `OnSortCompare`.
89	89
90	90		### TShellListView
91	91
92	92		- TShellListView now subclasses TListItem, so it can store file info in it.
93	93		- If you use OnCreateItemClass to create your own descendant of TListItem, it may be advisable to base your own class on TShellListItem instead of on TListItem. This way you will also have access to the TShellListItem's FileInfo property.
94	94
95	95		### TTreeView
96	96
97	97		- Adds ShowSeparators as a published property like ShowLines and ShowRoot.
98	98
99	99		### TTrayIcon gtk2 Only
100	100
101	101		If using the gtk2 tray icon, a new global variable is available that will allow you to predetermine which of the two TrayIcon models you use. See the Wiki for details. This is, and will only ever be, gtk2 only.
102	102
103	103		## IDE Changes
104	104
105	105		### Character map
106	106
107	107		- Resizable characters to improve readability.
108	108		- The character map was split off from the IDE and moved to separate packages. The designtime package is installed by default so that there is no difference in the IDE. Now users can access it in their own applications after adding the runtime package "charactermappkg.lpk" to the project requirements.
109	109
110	110		### Debugger
111	111
112	112		#### Project Options
113	113
114	114		- "Run(F9)" can either be "Debug" or "Run without debug".
115	115
116	116
117	117		In newly created Debug/Release modes, the Release mode will no longer invoke the debugger by default.
118	118
119	119		Existing Debug/Release modes must be edited, to enable this.
120	120
121	121		- Per project "Debugger backend" settings. In addition to choosing a specific backend from the global IDE settings, a backend can be configured just for the project (i.e. special gdb-server settings)
122	122
123	123		#### IDE Dialogs
124	124
125		-	~~- Improved <u>Watches window</u>~~
	125	+	- Improved Watches window
126	126		- Expand/Unfold for classes, records, etc
127	127		- Expand/Unfold with paged browser for arrays
128	128		- Drag and Drop to reorder watches
129	129		- Drag and Drop to create new "top level" watches from nested entries (in expand/unfolded lists)
130	130		- Address column for types with internal pointer (classes, long-string, dyn-array, (real) pointer)
131		-	~~- Improved <u>Locals window</u>~~
	131	+	- Improved Locals window
132	132		- Expand/Unfold for classes, records, etc
133	133		- Expand/Unfold with paged browser for arrays
134	134		- Address column for types with internal pointer (classes, long-string, dyn-array, (real) pointer)
135	135		- Power button
136		-	~~- Improved <u>Inspect window</u>~~
	136	+	- Improved Inspect window
137	137		- Fixed: Updating value when context changes
138	138		- Added options for Function calling / and "Converter" (See FpDebug: SysVarToLstr)
139	139		- Added filter to search for text in name or value.
140	140		- Added ctrl-Up/Down/Page-Up/Page-Down to navigate the grid.\
141	141		Alt-Left/Right for history. And ctrl-Enter to select.
142		-	~~- Improved <u>Evaluate/Modify window</u>~~
	142	+	- Improved Evaluate/Modify window
143	143		- New Layout
144	144		- Added DisplayFormat
145	145		- Added options for Function calling / and "Converter" (See FpDebug: SysVarToLstr)
146		-	~~- Improved <u>Assembler window</u>~~
	146	+	- Improved Assembler window
147	147		- Added history navigation (forward/backward)
148	148		- For FpDebug: added annotations to jump/call targets, and allow to ctrl-click to disassemble target address
149	149
150	150		#### FpDebug / LazDebuggerFp
151	151
152	152		- Improved "function calling" in watch eval. See [[FpDebug-Watches-FunctionEval]]
153	153		- %RAX Accessing cpu registers in watch expression (only full registers, not yet AH or AL or EAX on 64bit)
154	154		- Intrinsic functions: [[FpDebug-Watches-Intrinsic-Functions]]
155	155		- Intrinsic/extended operators: MyArray\[1..3\] array slice with operator mapping. [[FpDebug-Watches-Intrinsic-Functions\|FpDebug-Watches-Intrinsic-Functions#Intrinsic_Operators]]
156	156		- Option to detect "variant" and call "SysVarToLStr" in the target app.
157	157		- Suspend/Resume individual threads (must be done while app is paused, and will be applied for subsequent step/run)
158	158		- Partial improvements to debug in DLL: <https://wiki.freepascal.org/Debugger_Status#Other>
159	159		- Disassembler now annotates lines for call/jmp/jne/... with info on the target address (function name, file, line)
160	160		- F7/F8 Step-Into/Over can now be used to start the debugger and run to the first line of the main program begin/end.
161	161
162	162		#### LazDebuggerFpLldb (default on MacOS)
163	163
164	164		- Added Mem-Limits (and String,Pchar,Array) to the debugger config
165	165
166	166
167	167		See <https://wiki.freepascal.org/LazDebuggerFp> (MaxMemReadSize, MaxStringLen, MaxArrayLen, MaxNullStringSearchLen)
168	168
169	169		Limiting the default results for watches/locals/stack-params,... can prevent slow evaluation.
170	170
171	171		Arrays can then be browsed in the watches window, using the new "paged browser for arrays" (expand via \[+\])
172	172
173	173		### Floating point properties in the Object Inspector
174	174
175	175		- The Object Inspector now explicitely disallows to set a floating point property's value to +/-Inf or NaN.
176	176		- Reason: whilst +/-Inf and NaN are valid values for a floating point property, they cannot be streamed (so, the form could not be loaded) and setting it to NaN caused havoc in the IDE.
177	177		- Remedy: set the value at runtime (in code)
178	178
179	179		### Reading unit names in lfm
180	180
181	181		FPC 3.3.1 component writer supports optionally writing types with their unit names as unitname/type. Lazarus can now read this.
182	182
183	183		### Ambiguous Classtypes
184	184
185	185		You can now register two component classes with the same name, e.g. fresnel.TButton and StdCtrls.TButton. You can even put both on the same form.
186	186
187	187		### Editor
188	188
189	189		\- Highlight for PasDoc
190	190
191	191		### IDE Options
192	192
193		-	~~In Tools -\> Options -\> Environment -\> Window page these three settings are now <b>ON</b> by default :~~
	193	+	In Tools -\> Options -\> Environment -\> Window page these three settings are now ON by default :
194	194
195	195		- IDE title starts with project name
196	196		- IDE title shows project directory
197	197		- IDE title shows selected build mode
198	198
199	199		It has been requested by many users. If the IDE's title bar has no info about the active project, a user must open Project Inspector or Project Options to see it, which is inconvenient.
200	200
201	201		### Lazarus Examples
202	202
203	203		A new approach to Examples that copies an Example to a fresh working area (avoiding the Linux Read Only Problem) and, possibly an easier to use search model.
204	204
205	205		## IDE Interface Changes
206	206
207	207		## Components
208	208
209	209		### TAChart
210	210
211	211		- The TLegendClickTools now is able to detect clicks on series legend items and reports the clicked series in the new OnSeriesClick event.
212	212		- New TDatapointMarksClickTool which becomes active when the user clicked on the marks of a series.
213	213		- New property TickWidth for the chart axes.
214	214		- New property FullWidth for the chart title and footer to run their background across the entire chart width.
215	215		- New property RandomColors for `TRandomChartSource`.
216	216		- New properties YIndexWhiskerMin, YIndexBarMin, YIndexCenter, YIndexBarMax, YIndexWhiskerMax, and YDataLayout in TBoxAndWhiskerSeries for more flexible assignment of y values to the parts of the box/whisher shape.
217	217		- New option aipInteger in the set TAxisIntervalParamOptions which sets axis labels only at integer values and thus supresses the unwanted intermediate labels in bar charts and helps to enforce labels in logarithmic plots at the powers of the logarithmic base (usually 10).
218	218		- New event OnAddStyleToLegend for TChartStyles. It has a boolean parameter `AddToLegend` with which you can determine whether the series level using this style is displayed in the legend.
219	219
220	220		### TDateTimePicker
221	221
222	222		- New properties MonthDisplay and CustomMonthNames. They are meant to replace the MonthNames property, which has been deprecated.
223	223		- New property DecimalSeparator. Allows a user-specified value to be used instead of a hard-coded Colon character.
224	224
225	225		### TDBDateTimePicker
226	226
227	227		- Adds Options as a published property.
228	228		- Publishes the DecimalSeparator property.
229	229		- Publishes the missing Alignment property. Consistent with TDateTimePicker,
230	230
231	231		### T(Float)SpinEditEx
232	232
233	233		- New property Orientation which allows to arrange the spin buttons horizontally.
234	234
235	235		### TCheckListBox
236	236
237	237		- Adds HeaderColor and HeaderBackgroundColor properties. Used on list items where the Header property is enabled. Implemented for the Win32 widget set.
238	238
239	239		### Pas2js
240	240
241	241		- lazbuild now can compile pas2js projects by passing the environment variable PAS2JS with the path of the pas2js executable.
242	242		- Project groups with pas2js projects now can compile without being opened.
243	243		- New project type [[lazarus pas2js integration\|Progressive Web Application]]
244	244		- New project type [[lazarus pas2js integration\|Electron Web Application]]
245	245		- pas2jsdsgn now uses the SimpleWebServerGUI package, replacing its own http server controller.
246	246		- F9, Run now builds, starts a HTTP server and a browser
247	247
248	248		### Lazarus Icon Collection
249	249
250	250		- Not a component, but the Lazarus installation now contains a folder with general-purpose icons for usage in toolbars, menus, buttons etc. of any GUI applications (folder images/general_purpose).
251	251		- The images come in various sizes and thus are compatible with the scaled image list of Lazarus v2.0+.
252	252		- Author: Roland Hahn (https://www.rhsoft.de/).
253	253		- License: Creative Commons CC0 (no restrictions in usage).
254	254
255	255		### gir2pascal
256	256
257	257		- Sources of [[gir2pascal]] (a tool to convert [GObject Introspection](https://gi.readthedocs.io/) descriptions to Pascal files) are now included in Lazarus source tree ([tools/gir2pascal](https://gitlab.com/freepascal.org/lazarus/lazarus/-/tree/main/tools/gir2pascal) directory) and maintained there.
258	258
259	259		### lazdelphi
260	260
261	261		An IDE addon adding a parser for the Delphi compiler errors and hints. You can run dcc32.exe as external tool or execute before command in the compiler options and use the Delphi Compiler parser for the output, so that the errors/hints in the Messages window can open the source. See [[Lazarus Delphi Compiler Tool]]
262	262
263	263		### Jedi Code Format
264	264
265	265		- Some improvements in code formatting.
266	266		- The jcf command line tool is now a text-mode application and no longer requires XWindow on linux to run.
267	267
268	268		### DockedFormEditor
269	269
270	270		In case you are still using the sparta docked form editor, use the dockedformeditor package instead.
271	271
272	272		## Changes affecting compatibility
273	273
274	274		### IDE Settings
275	275
276	276		#### Run \> Run Parameters (UPDATED FOR 3.2)
277	277
278	278		The changes originally described introduced a regression. - They do apply to Lazarus 3.0 - As off Lazarus 3.2 (fixes release) the behaviour has been updated
279	279
280	280		` 1. If a non-empty string is set in "run params" \> "working directory", then this will be used as working directory.`\
281	281		`This should be "as before"`\
282	282		` 1. IDE-Macros are supported in this path.`\
283	283		` 2. If that path is relative, then this was not previously supported. It will be resolved against the "Project directory", not the "Output path"`\
284	284		`This is, because the "Output path" is only used as default Woring dir, if there is on "Host App". And resolving a relative directory against different bases can more easily lead to mistakes.`\
285	285		`Also the "Project dir" is used as base to resolve a relative "Host app" too.`\
286	286		` 2. If there is no user-specified "working directory" then the path of the "target exe" is used.`\
287	287		` 1. If a host app is given, the path of the host app is used.`\
288	288		` 1. Macros in the host app are allowed`\
289	289		` 2. A relative host app is resolved against the "Project dir"`\
290	290		` 2. If there is no host app, the path of the compiled project executable is used. (This should be the "output patch")`\
291	291		` 1. Macros in the "output path" are allowed`\
292	292		` 2. A relative path is resolved against the "Project dir"`\
293	293		` 3. If that does not return a path (if there is neither a project exe, nor a ho`
294	294
295	295		Also see <https://gitlab.com/freepascal.org/lazarus/lazarus/-/issues/40693#note_1727379327>
296	296
297		-	<strike> If your program uses relative paths but the executable is not in the same directory as the main project file (usually with .lpr extension), the IDE will set different current directory for the program as you expected. The current directory set will point to the directory with main project file instead of the directory where the executable is generated, so all relative paths used in the program will be invalid (ParamStr(0) and all other current-directory-specific functions will return wrong path). This happens only if you run your program using IDE (for example, using F9 key). This behavior was modified in the Lazarus 3.0 and breaks the backward compatibility.
	297	+	If your program uses relative paths but the executable is not in the same directory as the main project file (usually with .lpr extension), the IDE will set different current directory for the program as you expected. The current directory set will point to the directory with main project file instead of the directory where the executable is generated, so all relative paths used in the program will be invalid (ParamStr(0) and all other current-directory-specific functions will return wrong path). This happens only if you run your program using IDE (for example, using F9 key). This behavior was modified in the Lazarus 3.0 and breaks the backward compatibility.
298	298
299	299		The Working-dir is now determined as follows
300	300
301	301		1. BuildMode.RunParams "working directory" set by user (New, this can now be relative to project dir)
302	302		2. Project Dir, if not virtual
303	303		3. Directory from Host-App (RunParams), or if (and only if) Host-App is empty from Project.exe (If host app is in %PATH, then there is no "working directory")
304	304
305	305		The first 2 steps are the same as before the change. The 3rd step was previously only used for "debugging", but "run without debug" did use: "Launch-App", "Host-App", Project.exe.
306	306
307	307		Change
308	308		The path of the "Launch App" is no longer considered.
309	309
310	310		The Launch-/Host-App location are now determined as follows
311	311
312	312		1. An app with absolute path is used as given.
313	313		2. A relative path (including no path at all) is resolved as relative to the Project-dir.
314	314		3. An app without any path at all (if not found in step 2) is searched in the %PATH environment.
315	315
316	316		Change
317	317		Search in %PATH was only done by "run without debug", but not by debug. It is now done by both.
318	318
319	319		Change
320	320		Checking for an exe relative to the project-dir was added.
321	321
322	322		Remedy
323	323		So now, if you need to use relative paths in the program and be able to run/debug your program using IDE, just go to the "Run Parameters" window and set the
324	324
325	325		`$Path($(OutputFile))`
326	326
327		-	~~string in the "Working directory" field. </strike>~~
	327	+	string in the "Working directory" field.
328	328
329	329		### LCL incompatibility
330	330
331	331		#### TLabel: autosized and right-aligned
332	332
333	333		- Old behaviour: Autosized label with Alignment=taRightJustify but Anchors=\[akLeft,...\] grew to left.
334	334		- New behaviour: The label grows to right now.
335	335		- Reason: It wasn't possible to implement the behavior also for hidden labels without significant extensions in the LCL. The LCL has a different and more generic feature of control-based anchoring that delivers the same effect (see Remedy down), so it is not needed and wanted to double this feature and make the LCL code more complex and prone to bugs.
336	336		- Remedy: Use the LCL anchoring to a secondary control. Anchor the right side of the label to another control. Then the autosized label will grow to the left but won't move to the right when the parent is resized like it is done with a simple akRight anchor without a reference control.
337	337
338	338		#### TDateEdit/TTimeEdit
339	339
340	340		The value of NullDate has changed.\
341	341		Reason:
342	342
343	343		- It was impossible to actually select the date corresponding to NullDate (30 dec 1899 by default) in the control.
344	344		- Remedy (1): if your code depended on NullDate actually being 0.0, you have to adjust your code.
345	345		- Remedy (2): if your code used NullDate for a TTimeEdit, change that to the new constant NullTime instead.
346	346		- Note: NullDate is actually a writeable constant. This was kept for compatibility reasons. It is however a bad idea to change it's value to anything that is an actual date that is within the range of the control.
347	347
348	348		#### Cocoa
349	349
350	350		Some global configuration variables were moved from CocoaInt to CocoaConfig. such as CocoaBasePPI, CocoaIconUse, CocoaToggleBezel, CocoaToggleType etc.
351	351
352	352		#### GTK3
353	353
354	354		GTK3 is no longer supported on earlier Linuxes, such as Ubuntu 20.04. It requires GTK \>= 3.24.24 and Glib2.0 \>= 2.66
355	355
356	356		#### TControl: ChildSizing
357	357
358	358		- Old behavior: When a control overrides `AdjustClientRect` and children are aligned via `ChildSizing` the adjusted clientrect was ignored. A typical example is a `TPanel` with a wide `BevelWidth` where the children were moved into the bevel.
359	359		- New behavior: The children now are aligned with respect to the adjusted clientrect. In the example of the `TPanel`, the child controls are now positioned such that the bevel is not covered.
360	360		- Reason: unexpected behavior which also contradicts the behavior of `Align` or `AnchorSides` which do respect the adjusted clientrect.
361	361		- Remedy: In the rare case that users have met this situation and have compensated the incorrect `ChildSizing` layout by additional border spacings, these additional corrections must be reverted.
362	362
363	363		### LazUtils
364	364
365	365		#### Masks unit
366	366
367	367		The masks unit has been completely rewritten.\
368	368		Reasons:
369	369
370	370		- speed: the old Matches() method had O(n^2) or even O(n^3) characteristics.
371	371		- improved control over how the mask is interpreted.
372	372
373	373		New types (for parameters) and a dedicated TMaskWindows class have been added.\
374	374		TMask.MatchesWindowsMask and the old TMaskOptions type have been deprecated and will be removed in the next release.\
375	375		===== Ranges and Sets =====
376	376
377	377		- The old masks implementation supported sets, but not ranges. The new implementation supports both sets (\[abc\]) and ranges (\[a-c\]). As a consequence a '-' inside such a construct is now interpreted as part of the range definition, not as a literal '-'.
378	378		- Reason: ranges are a good thing to have by default (the old implementation simply lacked this). We decided it's a small price to pay.
379	379		- Remedy: either escape the '-' with EscapeChar (which defaults to '\\') or exclude mocRange from the TMaskOpcodes parameter.
380	380
381	381		##### Constructors do not fail anymore on an invalid mask
382	382
383	383		- When providing an invalid mask to the old T(Windows)Mask(List) constructors an exception was raised.
384	384		- The new constructors do not raise an exception in this case. Instead an exception is raised in when Matches() is called.
385	385		- Reason: it's not very nice to have a constructor fail.
386	386
387	387		#### Translations unit
388	388
389	389		Added GetLanguageID function. It returns a record with language code (in ISO 639-1 or ISO 639-2) and country code (in ISO 3166) for current system locale.\
390	390		Added GetLanguageIDFromLocaleName function. It parses Unix locale name and returns a record with language code and country code. It is useful to parse language identifiers passed e. g. via command-line parameters.
391	391
392	392		Implementation is based on GetLanguageIDs procedure from GetText unit, but is rewritten to have the following properties:
393	393
394	394		- Language and country codes are always returned in ISO formats on Windows.
395	395		- Unix locale identifier is properly parsed and language/country codes are properly extracted.
396	396		- Don't assume that language code is always two-letter (ISO 639-1), it can have bigger length (e. g. three letters, like in ISO 639-2).
397	397		- Locale ID is returned in a record type. This will allow to return additional fields in backwards-compatible manner in future. Currently it contains language code, country code and language ID (combination of language code and country code).
398	398
399	399		These functions are used now throughout the Lazarus codebase. This greatly improves automatic language detection and loading of correct translations by Lazarus:
400	400
401	401		- Three-letter (ISO 639-2) language identifiers are no more truncated to two letters. Thus, translations for such languages will be correctly loaded when available.
402	402		- Previously on Windows some language and country codes were obtained in non-ISO format, which prevented correct loading of some translations, e. g. Chinese (zh_CN).
403	403		- On Unix translations with country codes, like Brazilian Portuguese (pt_BR) or Chinese (zh_CN) are correctly loaded now.
404	404		- macOS is now handled as any other Unix. This removes dependency on language list in Lazarus bundle (which had to be maintained manually) and thus fixes loading of Czech, Hungarian, Brazilian Portuguese, Ukrainian translations.
405	405
406	406		#### LazUTF8 unit
407	407
408	408		- Deprecated LazGetLanguageIDs (returns combination of language and country codes) and LazGetShortLanguageID (returns only language code) procedures.
409	409		- Reason: this functionality belongs to Translations unit (calls of these procedures are almost always followed by calls to procedures from Translations unit), and these procedures are now thin wrappers of GetLanguageID function from Translations unit.
410	410		- Remedy: use GetLanguageID function from Translations unit.
411	411
412	412		#### LazUTF8Classes and LazUTF8SysUtils units
413	413
414	414		Everything in these units was deprecated for a long time and now they were removed. LazUTF8SysUtils was earlier renamed to LazSysUtils and this deprecated version was left for a transit period.
415	415
416	416		- Class TStringListUTF8 can be replaced with TStringList.
417	417		- Class TMemoryStreamUTF8 can be replaced with TMemoryStream.
418	418		- Global procedure LoadStringsFromFileUTF8 can be replaced with TStrings.LoadFromFile.
419	419		- Global procedure SaveStringsToFileUTF8 can be replaced with TStrings.SaveToFile.
420	420		- Functions NowUTC and GetTickCount64 can be found in LazSysUtils.
421	421
422	422		### Components incompatibility
423	423
424	424		#### LazControls
425	425
426	426		###### TSpinEditExBase derived classes
427	427
428		-	~~- All derived classes form TSpinEditExBase must implement a SameValue method. This method is defined as an <b>abstract</b> method in TSpinEditExBase.~~
	428	+	- All derived classes form TSpinEditExBase must implement a SameValue method. This method is defined as an abstract method in TSpinEditExBase.
429	429		- Reason: All derived classes used Math.SameValue. This is wrong for comparing integer types (even if is is safe when comparing relative small values).
430	430		- Remedy: unfortunately you'll have to adjust your code.
431	431
432	432		###### TFloatSpinEditEx
433	433
434	434		- The property NumbersOnly is no longer published.
435	435		- Reason: the property makes no sense for this control and only confuses users.
436	436		- Remedy: if you really need NumbersOnly to be True, you must set it in code.
437	437
438	438		#### FpVectorial
439	439
440	440		- The `Size` element in the FPVectorial `TvFont` record is a floating point value now (type `double`).
441	441		- Reason: Avoid rounding errors because the drawing coordinates are `double` already.
442	442		- Remedy: There is rarely a chance that this change will have an effect on user code. Only when the font size is stored in a variable it must be declared as `double` rather than as `integer`.
443	443
444	444		#### TurboPower_ipro
445	445
446	446		- Type declarations and the html nodes were moved from unit IpHtml to separate units, IpHtmlTypes, IpHtmlClasses and IpHtmlNodes. This may break compilation of existing projects.
447	447		- Reason: Improve maintainability of the extremely long unit IpHtml
448	448		- Remedy: Add IpHtmlTypes, IpHtmlClasses and/or IpHtmlNodes to the uses clause of the project unit(s) when an "identifier not found" error referring to this package is reported by the compiler.
449	449
450	450		## Other release notes
451	451
452	452		---
453	453		From the Free Pascal wiki, page "Lazarus 3.0 release notes", as it stood on 2024-03-17 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).
454	454		Category: Lazarus
455	455		Category: Release Notes

Back to history