The LCL in various platforms: what changed

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

Old	New		Line
1	1		## Introduction
2	2
3	3		Many [[LCL]] properties, methods and other functionality represent a concept, which is then mapped to a specific native behavior in each platform in order to provide the user with a [[Introduction to platform-sensitive development\|platform-sensitive environment]]. This sections aims at clarifying LCL behavior which changes across platforms by clarifying what is to be expected in each platform so that more reliable software can be built.
4	4
5	5		## Linker options
6	6
7	7		The LCL passes various linker options depending on platform. Here is the conditionals script from the LCL:
8	8
9	9		``` pascal
10	10		// linker options
11	11		if TargetOS='darwin' then begin
12	12		if LCLWidgetType='gtk' then
13	13		UsageLibraryPath := '/usr/X11R6/lib;/sw/lib'
14	14		else if LCLWidgetType='gtk2' then
15	15		UsageLibraryPath := '/usr/X11R6/lib;/sw/lib;/sw/lib/pango-ft219/lib'
16	16		else if LCLWidgetType='carbon' then begin
17	17		UsageLinkerOptions := '-framework Carbon'
18	18		+' -framework OpenGL'
19	19		+' ''-dylib_file'' ''/System/Library/Frameworks/OpenGL.framework/Versions/A/Libraries/libGL.dylib:/System/Library/Frameworks/OpenGL.framework/Versions/A/Libraries/libGL.dylib''';
20	20		end else if LCLWidgetType='cocoa' then
21	21		UsageLinkerOptions := '-framework Cocoa';
22	22		end else if TargetOS='solaris' then begin
23	23		UsageLibraryPath:='/usr/X11R6/lib';
24	24		end;
25	25		```
26	26
27	27		## TForm.BorderStyle
28	28
29	29		The BorderStyle of a Form represents a kind of form, and different platforms have different standards about how should the border of each kind of form be, and the LCL respects that. For example, message dialogs are usually not resizable under Windows, but resizable under X11-based Unixes. By using bsDialog it is possible to create a form which will have the adequate dialog appearance in every platform. Below is a full list of expected behaviors:
30	30
31	31		Windows
32	32
33	33		\| BorderStyle \| Has Border? \| Resizable? \| Decoration \|
34	34		\|---------------\|-------------\|------------\|------------------------\|
35	35		\| bsNone \| No \| No \| None \|
36	36		\| bsDialog \| Yes \| No \| Only X (Close) \|
37	37		\| bsSingle \| Yes \| No \| All \|
38	38		\| bsSizable \| Yes \| Yes \| All \|
39	39		\| bsSizeToolWin \| Yes \| Yes \| Only X and small title \|
40	40		\| bsToolWin \| Yes \| No \| Only X and small title \|
41	41
42	42		Windows CE
43	43
44	44		For Windows CE see here: [[Windows CE Development Notes\|Positioning and size of Dialogs and Forms]]
45	45
46	46		Gtk
47	47
48	48		Under Gtk on X11 the best one can do is ask the window manager to set a certain style, and it may ignore our request, so nothing, except sizable border vs. no border at all is guaranteed. i.e. only bsSizable and bsNone have a guaranteed behavior and the other ones will be either somewhere in between or equal to bsSizable.
49	49
50		-	~~<thead>~~
51		-
52		-	~~</thead>~~
53		-	~~<tbody>~~
54		-
55		-	~~</tbody>~~
	50	+	\| \| Gtk 1 \| \| \| Gtk 2''' \| \| \|
	51	+	\|---\|---\|---\|---\|---\|---\|---\|
	52	+	\| BorderStyle \| Has Border? \| Resizable? \| Decoration \| Has Border? \| Resizable? \| Decoration \|
	53	+	\| bsNone \| No \| No \| None \| No \| No \| None \|
	54	+	\| bsDialog \| Yes \| Yes* \| All* \| Yes \| Yes* \| All* \|
	55	+	\| bsSingle \| Yes \| No (WM) \| All \| Yes \| No (WM) \| All \|
	56	+	\| bsSizable \| Yes \| Yes \| All \| Yes \| Yes \| All \|
	57	+	\| bsSizeToolWin \| Yes \| Yes \| All* \| Yes \| Yes \| All* \|
	58	+	\| bsToolWin \| Yes \| No (WM) \| All* \| Yes \| No (WM) \| All* \|
56	59
57	60		Values with * differ from the Windows Implementation.
58	61
59	62		Values with (WM) indicate that the feature is Window Manager specific.
60	63
61	64		Associated bug track items: [1](http://bugs.freepascal.org/view.php?id=1540)
62	65
63	66		macOS
64	67
65		-	~~<thead>~~
66		-
67		-	~~</thead>~~
68		-	~~<tbody>~~
69		-
70		-	~~</tbody>~~
	68	+	\| \| Carbon \| \| \| Cocoa1''' \| \| \|
	69	+	\|---\|---\|---\|---\|---\|---\|---\|
	70	+	\| BorderStyle \| Has Border? \| Resizable? \| Decoration \| Has Border? \| Resizable? \| Decoration \|
	71	+	\| bsNone \| No \| No \| None \| Yes \| Yes \| All \|
	72	+	\| bsDialog \| Yes \| No \| All \| Yes \| Yes \| All \|
	73	+	\| bsSingle \| Yes \| No \| All \| Yes \| Yes \| All \|
	74	+	\| bsSizable \| Yes \| Yes \| All \| Yes \| Yes \| All \|
	75	+	\| bsSizeToolWin \| Yes \| Yes \| All \| Yes \| Yes \| All \|
	76	+	\| bsToolWin \| Yes \| No \| All \| Yes \| Yes \| All \|
71	77
72	78		<sup>1</sup>Note: The Cocoa widgetset is still in development. Details of implementation may change, as well as adherence to GUI guidelines.
73	79
74	80		## Shortcut Keys
75	81
76	82		Some Key sequences cannot be used by the Application in some platforms because the Operating System or Windows Manager is already using them. Below is a list for each platform.
77	83
78	84		#### macOS
79	85
80	86		You should refer to Apple [Human Interface Guidelines](https://developer.apple.com/design/human-interface-guidelines/macos/user-interaction/keyboard/) for system reserved shortcuts.
81	87
82	88		\| Key Sequence \| Alternative \| Description \|
83	89		\|----\|----\|----\|
84	90		\| `F8` / `Shift`+`F8` \| ? \| F8 activates Spaces \|
85	91		\| `F9` / `Shift`+`F9` \| ? \| F9 shows all windows in Exposé \|
86	92		\| `F10` / `Shift`+`F10` \| ? \| F10 shows all windows of the current program \|
87	93		\| `F11` / `Shift`+`F11` \| ? \| F11 shows the Desktop \|
88	94		\| `F12` / `Shift`+`F12` \| ? \| F12 activates the Dashboard \|
89	95
90	96		#### Windows
91	97
92	98		\| Key Sequence \| Alternative \| Description \|
93	99		\|--------------\|-------------\|---------------------------------------------\|
94	100		\| `F1` \| ? \| F1 invokes the program-specific help system \|
95	101
96	102		## Popup Menus
97	103
98	104		Normally the popup menus are the items in the TPopupMenu assigned to the PopupMenu property.
99	105
100	106		GTK (1+2)
101	107
102	108		The GTK automatically adds to the TNoteBook and TPageControl headers for each page a menu item to quick jump to the page.
103	109
104	110		GTK2
105	111
106	112		The GTK2 automatically adds to all edit controls like TEdit and TComboBox unicode and accessibility items.
107	113
108	114		## Command line parameters
109	115
110	116		Some widgetsets parse the [[Command line parameters and environment variables\|command line parameters]] and react to some parameters.
111	117
112	118		GTK
113	119
114	120		- --gtk-module
115	121		- --g-fatal-warnings
116	122		- --gtk-debug
117	123		- --gtk-no-debug
118	124		- --gdk-debug
119	125		- --gdk-no-debug
120	126		- --display
121	127		- --sync
122	128		- --no-xshm
123	129		- --name
124	130		- --class
125	131
126	132		---
127	133		From the Free Pascal wiki, page "The LCL in various platforms", as it stood on 2020-06-17 after a change by Kai Burghardt, 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).
128	134		Category: LCL
129	135		Category: Platform-sensitive development

Back to history