LCL Internals/ru: what changed

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

Title: LCL Internals/ru

New		Line
1	+	## Другие интерфейсы
2	+
3	+	- [[Lazarus known issues (things that will never be fixed)]] - Список проблем совместимости интерфейса
4	+	- [[Win32/64 Interface]] - Интерфейс winapi для Windows 95/98/Me/2K/XP/Vista, но не для CE
5	+	- [[Windows CE Interface]] - Для карманных ПК и смартфонов
6	+	- [[Carbon Interface]] - Интерфейс Carbon для macOS
7	+	- [[Cocoa Interface]] - Интерфейс Cocoa для macOS
8	+	- [[Qt Interface]] - Интерфейс Qt4 для Unix, macOS, Windows и КПК на базе Linux
9	+	- [[Qt5 Interface]] - Интерфейс Qt5 для Unix, macOS, Windows и КПК на базе Linux
10	+	- [[GTK1 Interface]] - Интерфейс gtk1 для Unix, macOS (X11), Windows
11	+	- [[GTK2 Interface]] - Интерфейс gtk2 для Unix, macOS (X11), Windows
12	+	- [[GTK3 Interface]] - Интерфейс gtk3 для Unix, macOS (X11), Windows
13	+	- [[fpGUI Interface]] - Основан на библиотеке fpGUI, которая представляет собой кроссплатформенный инструментарий, полностью написанный на Object Pascal
14	+	- [[Custom Drawn Interface]] - Кроссплатформенный бэкэнд LCL, написанный полностью на Object Pascal внутри Lazarus. Интерфейс Lazarus для Android.
15	+
16	+	### Советы для конкретных платформ
17	+
18	+	- [[Windows Programming Tips]] - Cоветы по программированию на desktop-Windows.
19	+	- [[Linux Programming Tips]] - Как выполнять определенные задачи программирования в Linux
20	+	- [[macOS Programming Tips]] - Советы по Lazarus, полезные инструменты, команды Unix и многое другое ...
21	+	- [[WinCE Programming Tips]] - Использование телефонного API, отправка SMS-сообщений и многое другое ...
22	+	- [[Android Programming]] - Для Android смартфонов и планшетов
23	+	- [[iPhone/iPod development]] - Об использовании Objective Pascal для разработки приложений для iOS
24	+
25	+	### Статьи по разработке интерфейсов
26	+
27	+	- [[Carbon interface internals]] - Если вы хотите помочь улучшить интерфейс Carbon
28	+	- [[Windows CE Development Notes]] - Для карманных ПК и смартфонов
29	+	- [[Adding a new interface]] - Как добавить новый интерфейс набора виджетов
30	+	- [[LCL Defines]] - Выбор правильных опций для перекомпиляции LCL
31	+	- [[LCL Internals]] - Некоторая информация о внутренней работе LCL
32	+	- [[Cocoa Internals]] - Некоторая информация о внутренней работе виджета Cocoa
33	+
34	+	## Минимальные версии Toolkit
35	+
36	+	\| Lazarus version \| Мин. FPC \| Мин. Gtk 2 \| Мин. Qt 4 \| Мин. Windows \| Мин. Windows CE \| Мин. macOS (Carbon) \| Мин. macOS (Cocoa) \| Мин. треб. LCL-CustomDrawn \|
37	+	\|----\|----\|----\|----\|----\|----\|----\|----\|----\|
38	+	\| 0.9.24 \| 2.2.0 \| 2.6+ \| 4.2+ \| Windows 98+ \| Рекомендуется 4.0+ \| 10.4 \| N/A \| N/A \|
39	+	\| 0.9.26 \| 2.2.2 \| 2.6+ \| 4.3+ \| Windows 98+ \| Рекомендуется 4.0+ \| 10.4 \| N/A \| N/A \|
40	+	\| 0.9.28 \| 2.2.4 \| 2.8+ \| 4.5+ \| Windows 98+ \| Рекомендуется 4.0+ \| 10.4 \| N/A \| N/A \|
41	+	\| 0.9.30 \| 2.4.0 \| 2.8+ \| 4.5+ \| Windows 98+ \| Рекомендуется 5.0+ \| 10.4 \| N/A \| N/A \|
42	+	\| 0.9.31 \| 2.4.4 \| 2.8+ \| 4.5+ \| Windows 98+ \| Рекомендуется 5.0+ \| 10.4 \| 10.6 \| Android 2.2+, Windows 2000+, X11, Mac 10.6+ \|
43	+	\| 1.2.6 \| 2.6.4 \| 2.8+ \| 4.5+* \| Windows 98+ \| Рекомендуется 5.0+ \| 10.4 \| 10.6 \| Android 2.2+, Windows 2000+, X11, Mac 10.6+ \|
44	+
45	+	- \- На самом деле 4.5.0 ... 4.8.4 с предварительно собранным Qt4Pas.dll, 4.8.5+ требует другого Qt4Pas.dll
46	+
47	+	См.также: [[Installing Lazarus on MacOS X/ru\|совместимость]]
48	+
49	+	## Внутренности LCL
50	+
51	+	Есть LCL и есть «интерфейс». LCL - это часть, которая не зависит от платформы и находится в каталоге lazarus/lcl/. Этот каталог содержит в основном определения классов. Многие различные элементы управления фактически реализованы в каталоге lazarus/lcl/include/ в различных файлах .inc. Это делается для того, чтобы быстрее найти реализацию определенного элемента управления, например TCustomMemo (который находится в custommemo.inc). Каждый .inc начинается со строки {% MainUnit ...}, чтобы определить, где он включен.
52	+
53	+	Также есть «интерфейс», который находится в подкаталоге каталога lazarus/lcl/interfaces/. Интерфейс gtk находится в gtk/, win32 в win32/ и т.д. Все они имеют модуль Interfaces, который используется lcl и создает основной объект интерфейса. Обычно основной интерфейсный объект определяется в XXint.pp (win32int.pp) и реализуется в различных inc-файлах, XXobject.inc - для методов, специфичных для интерфейса, XXwinapi.inc - для методов реализации winapi, XXlistsl.inc - для реализации списка строк, использующихся TComboBox, TListBox и другими подобными элементами управления, XXcallback.inc - для обработки событий виджета и принятия соответствующих действий для уведомления LCL.
54	+
55	+	Каждый элемент управления имеет свойство WidgetSetClass, принадлежащее "зеркальному" классу в каталоге интерфейсов, например: "зеркало" для TCustomEdit - это TWSCustomEdit, методы которого реализуются TWin32WSCustomEdit в win32wsstdctrls. Это способ, которым LCL взаимодействует с интерфейсом, и то, как он позволяет интерфейсу делать свое дело.
56	+
57	+	Передача интерфейса обратно в LCL в основном осуществляется путем отправки сообщений, обычно 'DeliverMessage', который вызывает TControl.Perform (\<message_id\>, wparam, lparam), где wparam и lparam являются дополнительной информацией для сообщения.
58	+
59	+	### Pie и RadialPie
60	+
61	+	Модуль LCLIntf содержит две функции для рисования округлых фигур:
62	+
63	+	`function `[[doc:lcl/lclintf/pie.html\|Pie]]`(DC: HDC; x1, y1, x2, y2, sx, sy, ex, ey: Integer): Boolean;`\
64	+	`function `[[doc:lcl/lclintf/radialpie.html\|RadialPie]]`(DC: HDC; x1, y1, x2, y2, Angle1, Angle2: Integer): Boolean; `
65	+
66	+	Функция Pie использует две точки (sx,sy) и (ex,ey) для указания начала и конца дуги. RadialPie использует углы, чтобы указать начало и конец дуги.
67	+
68	+	Pie вызывает TWidgetSet.Pie, а RadialPie вызывает TWidgetSet.RadialPie. Реализация TWidgetSet.Pie по умолчанию заключается в преобразовании параметров в углы и вызове TWidgetSet.RadialPie. TWidgetSet.RadialPie создает массив точек для дуги и вызывает TWidgetSet.Polygon.
69	+
70	+	Набор виджетов win32 переопределяет TWidgetSet.Pie для непосредственного вызова функции Windows Pie.
71	+
72	+	> Note: в более старых версиях Lazarus существовал RadialPie с углами, которые делали то же, что и нынешние RadialPie и RadialPie, которые делают то же самое, что и наша \[функция\] Pie. Эти функции были удалены в Lazarus 0.9.21.
73	+
74	+	### Интерфейсы
75	+
76	+	См. [[LCL Internals/ru\|другие интерфейсы]]
77	+
78	+	### Добавление нового модуля в LCL
79	+
80	+	Сначала добавьте новое имя модуля в allclunits.pp.
81	+
82	+	Чтобы убедиться, что модуль зарегистрирован в палитре компонентов, смотрите файлы RegisterLCL.pas и pkgfileslcl.inc, они расположены в lazarus/packager.
83	+
84	+	## Как создать новый Widgetset
85	+
86	+	Это пошаговое руководство по разработке нового [[Widgetset\|widgetset]]. Он основан на моем опыте создания основ нового интерфейса qt4.
87	+
88	+	Для начала, почему кто-то хочет добавить Widgetset? Ответ заключается в том, чтобы иметь возможность портировать существующее программное обеспечение Lazarus на большее количество платформ без изменения их кода.
89	+
90	+	Итак, давайте напишем набор виджетов. Прежде всего, вам нужно иметь паскаль привязки для виджета и знать, как его использовать. Обычно это не сложно. Несколько часов работы с основными учебными пособиями, доступными в Интернете, должны быть достаточными для начала. Если привязки еще не существуют, их нужно создать. Если учебные пособия написаны на другом языке, переведите их на паскаль и заставьте их работать.
91	+
92	+	Теперь для Qt я использовал привязки Den Jean qt4 для паскаля и создал очень простую программу Qt, используя их:
93	+
94	+	``` pascal
95	+	program qttest;
96	+
97	+	uses qt4;
98	+
99	+	var
100	+	App: QApplicationH;
101	+	MainWindow: QMainWindowH;
102	+	begin
103	+	App := QApplication_Create(@argc,argv);
104	+
105	+	MainWindow := QMainWindow_Create;
106	+
107	+	QWidget_show(MainWindow);
108	+
109	+	QApplication_Exec;
110	+	end.
111	+	```
112	+
113	+	Вышеуказанный проект компилируется и создает программу qt4. Теперь мы будем использовать его код для написания нового набора виджетов. После того, как мы закончим, приведенная ниже программа lazarus прекрасно скомпилируется в программу qt4:
114	+
115	+	``` pascal
116	+	program qttest;
117	+
118	+	{$mode objfpc}{$H+}
119	+
120	+	uses
121	+	Interfaces, Classes, Forms,
122	+	{ Add your units here }
123	+	qtform;
124	+
125	+	begin
126	+	Application.Initialize;
127	+	Application.CreateForm(TForm1, Form1);
128	+	Application.Run;
129	+	end.
130	+	```
131	+
132	+	где форма поддерживается Lazarus IDE и разрабатывается визуально.
133	+
134	+	Первое, что нужно сделать с новым набором виджетов, это добавить пустой скелет для него. Очень ранние наборы виджетов разработки, такие как qt и carbon, могут служить скелетом.
135	+
136	+	Просматривая файлы на многих виджетах, вы можете увидеть первый файл, который будет вызван lcl: Interfaces.pas. Этот файл просто вызывает другой файл с именем QtInt.pas или аналогичный. QtInt.pas содержит код для класса TWidgetSet, который мы должны реализовать. На пустом скелете вы можете видеть, что у класса есть различные функции, которые он должен реализовать:
137	+
138	+	``` pascal
139	+	TQtWidgetSet = Class(TWidgetSet)
140	+	private
141	+	App: QApplicationH;
142	+	public
143	+	{$I qtwinapih.inc}
144	+	{$I qtlclintfh.inc}
145	+	public
146	+	// Application
147	+	procedure AppInit(var ScreenInfo: TScreenInfo); override;
148	+	procedure AppRun(const ALoop: TApplicationMainLoop); override;
149	+	procedure AppWaitMessage; override;
150	+	procedure AppProcessMessages; override;
151	+	procedure AppTerminate; override;
152	+	procedure AppMinimize; override;
153	+	procedure AppBringToFront; override;
154	+	public
155	+	constructor Create;
156	+	destructor Destroy; override;
157	+	function DCGetPixel(CanvasHandle: HDC; X, Y: integer): TGraphicsColor; override;
158	+	procedure DCSetPixel(CanvasHandle: HDC; X, Y: integer; AColor: TGraphicsColor); override;
159	+	procedure DCRedraw(CanvasHandle: HDC); override;
160	+	procedure SetDesigning(AComponent: TComponent); override;
161	+
162	+	function InitHintFont(HintFont: TObject): Boolean; override;
163	+
164	+	// create and destroy
165	+	function CreateComponent(Sender : TObject): THandle; override; // deprecated
166	+	function CreateTimer(Interval: integer; TimerFunc: TFNTimerProc): integer; override;
167	+	function DestroyTimer(TimerHandle: integer): boolean; override;
168	+	end;
169	+	```
170	+
171	+	### Как реализовать новый оконный компонент
172	+
173	+	Все оконные компоненты являются потомками TWinControl. Эти элементы управления имеют дескриптор и поэтому должны создаваться набором виджетов. Добавлять новые оконные компоненты в набор виджетов \[довольно\] легко.
174	+
175	+	Допустим, вы хотите добавить TQtWSCustomEdit в Qt Widgetset. \[Нужно\] начать с TCustomEdit, \[который\] является потомком TWinControl и находится в модуле StdCtrls.
176	+
177	+	Теперь перейдите к модулю QtWSStrCtrls и найдите объявление TQtWSCustomEdit.
178	+
179	+	``` pascal
180	+	TQtWSCustomEdit = class(TWSCustomEdit)
181	+	private
182	+	protected
183	+	public
184	+	end;
185	+	```
186	+
187	+	Добавьте статические методы, объявленные в TWSCustomEdit, и переопределите их. Код должен теперь выглядеть так:
188	+
189	+	``` pascal
190	+	TQtWSCustomEdit = class(TWSCustomEdit)
191	+	private
192	+	protected
193	+	public
194	+	class function CreateHandle(const AWinControl: TWinControl;
195	+	const AParams: TCreateParams): HWND; override;
196	+	class procedure DestroyHandle(const AWinControl: TWinControl); override;
197	+	{ class function GetSelStart(const ACustomEdit: TCustomEdit): integer; override;
198	+	class function GetSelLength(const ACustomEdit: TCustomEdit): integer; override;
199	+
200	+	class procedure SetCharCase(const ACustomEdit: TCustomEdit; NewCase: TEditCharCase); override;
201	+	class procedure SetEchoMode(const ACustomEdit: TCustomEdit; NewMode: TEchoMode); override;
202	+	class procedure SetMaxLength(const ACustomEdit: TCustomEdit; NewLength: integer); override;
203	+	class procedure SetPasswordChar(const ACustomEdit: TCustomEdit; NewChar: char); override;
204	+	class procedure SetReadOnly(const ACustomEdit: TCustomEdit; NewReadOnly: boolean); override;
205	+	class procedure SetSelStart(const ACustomEdit: TCustomEdit; NewStart: integer); override;
206	+	class procedure SetSelLength(const ACustomEdit: TCustomEdit; NewLength: integer); override;
207	+
208	+	class procedure GetPreferredSize(const AWinControl: TWinControl;
209	+	var PreferredWidth, PreferredHeight: integer); override;}
210	+	end;
211	+	```
212	+
213	+	Закомментированная часть кода - это процедуры, которые необходимо реализовать, чтобы TCustomEdit был полностью функциональным, но достаточно просто \[наличия\] CreateHandle и DestroyHandle, чтобы он отображался в форме и был редактируемым, поэтому он соответствует нашим потребностям в этой статье.
214	+
215	+	Нажмите <span class="kbd">Ctrl</span>+<span class="kbd">Shift</span>+<span class="kbd">C</span>, чтобы завершить код и реализовать CreateHandle и DestroyHandle. В случае Qt4 код будет таким:
216	+
217	+	``` pascal
218	+	{ TQtWSCustomEdit }
219	+
220	+	class function TQtWSCustomEdit.CreateHandle(const AWinControl: TWinControl;
221	+	const AParams: TCreateParams): HWND;
222	+	var
223	+	Widget: QWidgetH;
224	+	Str: WideString;
225	+	begin
226	+	// Создаем виджет
227	+	WriteLn('Calling QTextDocument_create');
228	+	Str := WideString((AWinControl as TCustomMemo).Lines.Text);
229	+	Widget := QTextEdit_create(@Str, QWidgetH(AWinControl.Parent.Handle));
230	+
231	+	//Задаем его начальные свойства
232	+	QWidget_setGeometry(Widget, AWinControl.Left, AWinControl.Top,
233	+	AWinControl.Width, AWinControl.Height);
234	+
235	+	QWidget_show(Widget);
236	+
237	+	Result := THandle(Widget);
238	+	end;
239	+
240	+	class procedure TQtWSCustomEdit.DestroyHandle(const AWinControl: TWinControl);
241	+	begin
242	+	QTextEdit_destroy(QTextEditH(AWinControl.Handle));
243	+	end;
244	+	```
245	+
246	+	Теперь раскомментируйте строку "RegisterWSComponent (TCustomEdit, TQtWSCustomEdit);" в конце модуля и ... все!
247	+
248	+	Теперь вы можете поместить TCustomEdit внизу формы и ожидать, что он будет работать. :^)
249	+
250	+	### Реализация TBitmap
251	+
252	+	Для реализации TBitmap необходимо понимать TRawImage и TLazIntfImage, как описано здесь: [[Developing with Graphics\|Developing with Graphics#Working with TLazIntfImage.2C TRawImage and TLazCanvas]]
253	+
254	+	Итак, допустим, вы хотите скомпилировать следующий код:
255	+
256	+	``` pascal
257	+	procedure TMyForm.HandleOnPaint(Sender: TObject);
258	+	var
259	+	Bitmap: TBitmap;
260	+	begin
261	+	Bitmap := TBitmap.Create;
262	+	try
263	+	Bitmap.LoadFromFile('myfile.bmp');
264	+	Canvas.Draw(0, 0, Bitmap);
265	+	finally
266	+	Bitmap.Free;
267	+	end;
268	+	end;
269	+	```
270	+
271	+	Ниже приведен порядок вызова функций из интерфейса widgetset при выполнении этого кода:
272	+
273	+	` 1 - BeginPaint`
274	+
275	+	Это будет вызвано только, если событие OnPaint отправляет ноль в качестве DC для события рисования
276	+
277	+	` 2 - GetDC(0);`
278	+
279	+	Просто создает контекст устройства.
280	+
281	+	` 3 - TCDWidgetSet.RawImage_QueryDescription `
282	+
283	+	Реализация этой процедуры по умолчанию подходит для большинства наборов виджетов.
284	+
285	+	` 4 - TCDWidgetSet.RawImage_CreateBitmaps`
286	+
287	+	Здесь вам нужно создать собственный объект изображения и загрузить его из RawData.Data, где хранится информация на основе вашего описания формата пикселя в пункте 2.
288	+
289	+	` 5 - CreateCompatibleDC(0)`
290	+
291	+	Это создает временный DC только для хранения изображения, но на данный момент нет информации об изображении, поэтому в этот момент этот DC действительно фиктивный
292	+
293	+	` 6 - SelectObject`
294	+
295	+	С изображением в качестве объекта, который будет выбран, и DC, созданный выше, в качестве целевого DC.
296	+
297	+	` 7 - StretchMaskBlt`
298	+
299	+	Наконец, функция рисования! DestDC - это DC, размещенный на BeginPaint.
300	+
301	+	` 8 - EndPaint`
302	+
303	+	Опять же, не всегда используется.
304	+
305	+	### TBitmap.LoadFromDevice для снятия скриншота
306	+
307	+	Рекомендуется сначала реализовать Bitmap, прежде чем делать этот шаг.
308	+
309	+	В LCL вы можете использовать следующий код, делающий скриншот со всего экрана и рисующий его на холсте:
310	+
311	+	``` pascal
312	+	var
313	+	ScreenDC: HDC;
314	+	Bitmap: TBitmap;
315	+	begin
316	+	Bitmap := TBitmap.Create;
317	+	try
318	+	ScreenDC := GetDC(0);
319	+	Bitmap.LoadFromDevice(ScreenDC);
320	+	ReleaseDC(0, ScreenDC);
321	+	Canvas.Draw(0, 0, Bitmap);
322	+	finally
323	+	Bitmap.Free;
324	+	end;
325	+	end;
326	+	```
327	+
328	+	Если вы уже внедрили TBitmap, для LoadFromDevice нужно реализовать только 2 новые функции: GetDeviceSize и GetRawImageFromDevice
329	+
330	+	Ниже приведен большой трейс, охватывающий все функции набора виджетов, вызываемые для события OnPaint, которое делает снимок экрана и рисует его на экране. Эта трассировка была сделана с помощью набора виджетов Qt и может иметь некоторые недостатки. Номера дескрипторов должны использоваться для проверки того, какой объект используется в функциях.
331	+
332	+	[WinAPI BeginPaint] Result=-1220713544
333	+	[WinAPI GetClientBounds]
334	+	[WinAPI SetWindowOrgEx] DC: -1220713544 NewX: 0 NewY: 0
335	+
336	+	``` pascal
337	+	//Входим в событие OnPaint
338	+	Bitmap := TBitmap.Create;
339	+	try
340	+	ScreenDC := GetDC(0);
341	+	```
342	+
343	+	[WinAPI GetDC] hWnd: 0 Result: -1220712920
344	+
345	+	``` pascal
346	+	Bitmap.LoadFromDevice(ScreenDC);
347	+	```
348	+
349	+	` [WinAPI GetDeviceSize]`\
350	+	` [WinAPI GetRawImageFromDevice] SrcDC: -1220712920 SrcWidth: 0 SrcHeight: 0`\
351	+	` [WinAPI CreateBitmapFromRawImage] Width:1024 Height:768 DataSize: 3145728 CreateMask: False Bitmap:-1220746696`\
352	+	` [WinAPI GetObject] GDIObj: -1220746696 Result=84 ObjectType=Image`
353	+
354	+	``` pascal
355	+	ReleaseDC(0, ScreenDC);
356	+	```
357	+
358	+	[WinAPI ReleaseDC] hWnd: 0 DC: -1220712920
359	+
360	+	``` pascal
361	+	Canvas.Draw(0, 0, Bitmap);
362	+	```
363	+
364	+	` [WinAPI CreateCompatibleDC] DC: 0`\
365	+	` [WinAPI GetDC] hWnd: 0 Result: -1220712920`\
366	+	` [WinAPI SelectObject] DC=-1220712920 GDIObj=-1220746696 Result=0 ObjectType=Image`\
367	+	` [WinAPI StretchMaskBlt] DestDC:-1220713544 SrcDC:-1220712920 Image:137185120 X:0 Y:0 W:1024 H:768 XSrc:0 YSrc:0 WSrc:1024 HSrc:768`
368	+
369	+	``` pascal
370	+	finally
371	+	Bitmap.Free;
372	+	end;
373	+	```
374	+
375	+	` [WinAPI SelectObject] DC=-1220712920 GDIObj=0 Invalid GDI Object`\
376	+	` [WinAPI DeleteObject] GDIObject: -1220746696 Result=False ObjectType=Image`
377	+
378	+	``` pascal
379	+	//Здесь мы вышли из события OnPaint
380	+	```
381	+
382	+	` [WinAPI DeleteObject] GDIObject: 0`\
383	+	` [WinAPI DeleteObject] GDIObject: 0`\
384	+	` [WinAPI DeleteObject] GDIObject: 0`\
385	+	` [WinAPI DeleteObject] GDIObject: 0`\
386	+	` [WinAPI SetWindowOrgEx] DC: -1220713544 NewX: -152 NewY: -246`\
387	+	` [WinAPI DeleteObject] GDIObject: 0`\
388	+	` [WinAPI DeleteObject] GDIObject: 0`\
389	+	` [WinAPI DeleteObject] GDIObject: 0`\
390	+	` [WinAPI DeleteObject] GDIObject: 0`\
391	+	` TWidgetSet.InitializeCriticalSection`\
392	+	` TWidgetSet.EnterCriticalSection`\
393	+	` [WinAPI SelectObject] DC=-1220713544 GDIObj=0 Invalid GDI Object`\
394	+	` [WinAPI MoveToEx] DC:-1220713544 X:0 Y:0`\
395	+	` [WinAPI SelectObject] DC=-1220713544 GDIObj=-1220746760 Result=-1220746856 ObjectType=Brush`\
396	+	` [WinAPI SelectObject] DC=-1220713544 GDIObj=-1220746856 Result=-1220746856 ObjectType=Brush`\
397	+	` TWidgetSet.LeaveCriticalSection`\
398	+	` [WinAPI SetWindowOrgEx] DC: -1220713544 NewX: 0 NewY: 0`\
399	+	` [WinAPI EndPaint] Handle: -1220611768 PS.HDC: -1220713544`
400	+
401	+	### Реализация рисования в событии OnPaint формы или другого элемента управления
402	+
403	+	Для рисования в событии OnPaint формы само событие приходит из библиотеки лежащих в основе виджетов. Интерфейс LCL должен обработать это событие и создать соответствующий объект DC в обработчике событий, а затем вызвать LCLSendPaintMsg. Кроме того, следует также реализовать соответствующие методы рисования, такие как Rectangle или ExtTextOut. Также могут быть полезны процедуры, связанные с Pen(перо), Brush(кисть) и Font(шрифт).
404	+
405	+	Вот обработчик события OnPaint из набора виджетов Cocoa, который показывает, как он вызывает LCLSentPaintMsg:
406	+
407	+	``` pascal
408	+	procedure TLCLCommonCallback.Draw(ControlContext: NSGraphicsContext;
409	+	const bounds, dirty:NSRect);
410	+	var
411	+	struct : TPaintStruct;
412	+	begin
413	+	if not Assigned(Context) then Context:=TCocoaContext.Create;
414	+
415	+	Context.ctx:=ControlContext;
416	+	if Context.InitDraw(Round(bounds.size.width), Round(bounds.size.height)) then
417	+	begin
418	+	FillChar(struct, SizeOf(TPaintStruct), 0);
419	+	struct.hdc := HDC(Context);
420	+	{$IFDEF VerboseWinAPI}
421	+	DebugLn(Format('[TLCLCommonCallback.Draw] OnPaint event started context: %x', [HDC(context)]));
422	+	{$ENDIF}
423	+	LCLSendPaintMsg(Target, HDC(Context), @struct);
424	+	{$IFDEF VerboseWinAPI}
425	+	DebugLn('[TLCLCommonCallback.Draw] OnPaint event ended');
426	+	{$ENDIF}
427	+	end;
428	+	end;
429	+	```
430	+
431	+	И список подпрограмм WinAPI, которые были вызваны при запуске этого события:
432	+
433	+	` [TCocoaWidgetSet.GetDC] hWnd: 0 Result: 12400C0`\
434	+	` [TLCLCommonCallback.Draw] OnPaint event started context: 1240340`\
435	+	` TCocoaWidgetSet.CreatePenIndirect`\
436	+	` TCocoaWidgetSet.SelectObject DC: 1240340 GDIObj: 10EC460`\
437	+	` TCocoaWidgetSet.SelectObject Result: 0`\
438	+	` TCocoaWidgetSet.SelectObject DC: 1240340 GDIObj: 10EBF00`\
439	+	` TCocoaWidgetSet.SelectObject Result: 0`\
440	+	` [TCocoaWidgetSet.Rectangle] DC: 1240340 X1: 100 Y1: 100 X2: 200 Y2: 200`\
441	+	` TCocoaWidgetSet.SelectObject DC: 1240340 GDIObj: 10EC4A0`\
442	+	` TCocoaWidgetSet.SelectObject Result: 0`\
443	+	` [TCocoaWidgetSet.GetTextExtentPoint] DC: 1240340 Str: Some text Count: 9`\
444	+	` [TCocoaWidgetSet.GetTextExtentPoint] Size: 65,17`\
445	+	` [TLCLCommonCallback.Draw] OnPaint event ended`
446	+
447	+	### Внедрение TLabel
448	+
449	+	Внедрить TLabel особенно сложно, несмотря на то, что он является этаким базовым компонентом, потому что это требует, чтобы была реализована почти вся отрисовка. TLabel не является оконным элементом управления, вместо этого он зависит от сообщений отрисовки, рисующих \[компонент\] непосредственно на холсте формы.
450	+
451	+	Прежде чем пытаться заставить работать TLabel, рекомендуется проверить, работают ли функции рисования, такие как Rectangle, внутри события OnPaint формы.
452	+
453	+	Необходимо реализовать несколько методов WinAPI, в частности:
454	+
455	+	Методы контекста устройства
456	+
457	+	BeginPaint, GetDC, EndPaint, ReleaseDC, CreateCompatibleDC
458	+
459	+	см. [[Device Contexts and GDI objects in the LCL interfaces\|Контексты устройств и объекты GDI в интерфейсах LCL]]
460	+
461	+	Методы объектов GDI
462	+
463	+	SelectObject, DeleteObject, CreateFontIndirect, CreateFontIndirectEx
464	+
465	+	Разные функции
466	+
467	+	InvalidateRect, GetClientBounds, SetWindowOrgEx
468	+
469	+	Методы рисования текста
470	+
471	+	DrawText.</br>Вместо реализации DrawText можно также использовать стандартный TWidgetSet.DrawText, как это делают наборы виджетов Carbon и Cocoa. Но в этом случае необходимо, чтобы каждый реализовывал хотя бы GetTextMetrics, GetTextExtentPoint и ExtTextOut. Без GetTextMetrics форма с TLabel рухнет, потому что авторазмер не сможет рассчитать подходящий размер для TLabel.
472	+
473	+	Функции Region для определения, что элемент управления находится за другим
474	+
475	+	CombineRgn, CreateRectRgn, GetClipRGN, RectVisible
476	+
477	+	Ниже приведен порядок вызова процедур рисования в форме с одним TLabel, чтобы лучше понять последовательность рисования:
478	+
479	+	1 - GetDC вызывается один раз при запуске программного обеспечения с hWnd = 0
480	+	2 - Показывается форма
481	+	3 - GetDC вызывается снова (это не произошло бы без TLabel). Вызывается несколько функций, связанных со шрифтами, а также DrawText с CalcRect, установленным в True, чтобы вычислить размер TLabel.
482	+	4 - InvalidateRect вызывается на холсте формы
483	+	5 - Управление возвращается к операционной системе до тех пор, пока из набора виджетов не придет сообщение отрисовки
484	+	6 - Вызывается BeginPaint, и в этот момент будет выполнен код в событии OnPaint формы
485	+	7 - DrawText вызывается снова с CalcRect установленным в false
486	+	8 - Отрисовка закончена
487	+
488	+	### Реализация видимости для форм и элементов управления и состояния окна
489	+
490	+	Код, который управляет видимостью, разделен между видимостью для форм и для элементов управления.
491	+
492	+	#### Видимость для форм и состояния окна
493	+
494	+	Эта часть также управляет состоянием окна (свернуто, развернуто или нормально). Это реализовано как копия функции Windows API ShowWindow, поэтому вы должны реализовать TMyWidgetset.ShowWindow в файле mywinapi.inc. Не забудьте также добавить заголовок в файл mywinapih.inc.
495	+
496	+	Ниже приведен код, который реализует эту функцию в наборе виджетов Qt. Это должно \[помочь\] очень легко понять, скопировать и реализовать его на вашем собственном виджете. Вы также можете посмотреть, как это реализует Gtk. В Windows, конечно, API Windows вызывается напрямую, поэтому нет кода, на котором его можно \[продемонстрировать\].
497	+
498	+	``` pascal
499	+	{------------------------------------------------------------------------------
500	+	function ShowWindow(hWnd: HWND; nCmdShow: Integer): Boolean;
501	+
502	+	nCmdShow:
503	+	SW_SHOWNORMAL, SW_MINIMIZE, SW_SHOWMAXIMIZED
504	+	------------------------------------------------------------------------------}
505	+	function TQtWidgetSet.ShowWindow(hWnd: HWND; nCmdShow: Integer): Boolean;
506	+	var
507	+	Widget: QWidgetH;
508	+	begin
509	+	{$ifdef VerboseQtWinAPI}
510	+	WriteLn('WinAPI ShowWindow');
511	+	{$endif}
512	+
513	+	Result := False;
514	+
515	+	Widget := QWidgetH(hWnd);
516	+
517	+	// if Widget = nil then RaiseException('TQtWidgetSet.ShowWindow hWnd is nil');
518	+
519	+	case nCmdShow of
520	+	SW_SHOW: QWidget_setVisible(Widget, True);
521	+	SW_SHOWNORMAL: QWidget_showNormal(Widget);
522	+	SW_MINIMIZE: QWidget_setWindowState(Widget, QtWindowMinimized);
523	+	SW_SHOWMINIMIZED: QWidget_showMinimized(Widget);
524	+	SW_SHOWMAXIMIZED: QWidget_showMaximized(Widget);
525	+	SW_HIDE: QWidget_setVisible(Widget, False);
526	+	end;
527	+
528	+	Result := True;
529	+	end;
530	+	```
531	+
532	+	#### Видимость для элементов управления
533	+
534	+	Для элементов управления внутри формы вам необходимо реализовать функцию класса TMyWSWinControl.ShowHide, которая находится в классе TMyWSWinControl в файле mywscontrols.pp
535	+
536	+	Помните, что большинство элементов управления наследуются от TWinControl, поэтому реализация этой функции гарантирует, что свойство Visible реализовано для всех стандартных элементов управления, которые его имеют. Ниже приведен пример кода для набора виджетов Qt.
537	+
538	+	``` pascal
539	+	{------------------------------------------------------------------------------
540	+	Method: TQtWSWinControl.ShowHide
541	+	Params: AWinControl - the calling object
542	+
543	+	Returns: Nothing
544	+
545	+	Shows or hides a widget.
546	+	------------------------------------------------------------------------------}
547	+	class procedure TQtWSWinControl.ShowHide(const AWinControl: TWinControl);
548	+	begin
549	+	if AWinControl = nil then exit;
550	+
551	+	if not AWinControl.HandleAllocated then exit;
552	+
553	+	if AWinControl.HandleObjectShouldBeVisible then
554	+	QWidget_setVisible(TQtWidget(AWinControl.Handle).Widget, True)
555	+	else QWidget_setVisible(TQtWidget(AWinControl.Handle).Widget, False);
556	+	end;
557	+	```
558	+
559	+	### Реализация компонентов на основе TStrings
560	+
561	+	Некоторые компоненты используют TStrings для хранения отображаемой информации, например: TCustomMemo, TCustomListBox и TCustomComboBox.
562	+
563	+	Для их реализации недостаточно просто реализовать их функции, например, в классе TQtCustomMemo. Одна из реализуемых функций будет называться GetStrings и выглядеть следующим образом:
564	+
565	+	``` pascal
566	+	class function TQtWSCustomListBox.GetStrings(const ACustomListBox: TCustomListBox): TStrings;
567	+	var
568	+	ListWidgetH: QListWidgetH;
569	+	begin
570	+	ListWidgetH := QListWidgetH((TQtWidget(ACustomListBox.Handle).Widget));
571	+	Result := TQtListStrings.Create(ListWidgetH, ACustomListBox);
572	+	end;
573	+	```
574	+
575	+	Эта функция должна возвращать потомок TStrings, предназначенный для отслеживания, что строки добавляются или удаляются из списка, и отправлять эту информацию в набор виджетов для обновления элемента управления. Например, следующее объявление показывает, как выглядит TQtListStrings:
576	+
577	+	``` pascal
578	+	TQtListStrings = class(TStrings)
579	+	private
580	+	FListChanged: Boolean; // StringList и QtListWidget не синхронизированы
581	+	FStringList: TStringList; // Содержит пункты для показа
582	+	FQtListWidget: QListWidgetH; // Qt Widget
583	+	FOwner: TWinControl; // Lazarus'овский владелец элементов управления ListStrings
584	+	FUpdating: Boolean; // Мы меняем Qt Widget
585	+	procedure InternalUpdate;
586	+	procedure ExternalUpdate(var Astr: TStringList; Clear: Boolean = True);
587	+	procedure IsChanged; // событие OnChange, вызваемое действием программы
588	+	protected
589	+	function GetTextStr: string; override;
590	+	function GetCount: integer; override;
591	+	function Get(Index : Integer) : string; override;
592	+	//procedure SetSorted(Val : boolean); virtual;
593	+	public
594	+	constructor Create(ListWidgetH : QListWidgetH; TheOwner: TWinControl);
595	+	destructor Destroy; override;
596	+	procedure Assign(Source : TPersistent); override;
597	+	procedure Clear; override;
598	+	procedure Delete(Index : integer); override;
599	+	procedure Insert(Index : integer; const S: string); override;
600	+	procedure SetText(TheText: PChar); override;
601	+	//procedure Sort; virtual;
602	+	public
603	+	//property Sorted: boolean read FSorted write SetSorted;
604	+	property Owner: TWinControl read FOwner;
605	+	function ListChangedHandler(Sender: QObjectH; Event: QEventH): Boolean; cdecl;
606	+	end;
607	+	```
608	+
609	+	Вы можете увидеть его реализацию в модуле qtobjects.pas интерфейса qt.
610	+
611	+	### Реализация меню
612	+
613	+	Меню доступны на LCL для создания основных меню или всплывающих меню. TMenu является владельцем более крупной структуры меню со многими пунктами. Элементы могут иметь подэлементы, и не нуждаются в дополнительном TMenus.
614	+
615	+	Также помните, что в LCL дескриптор создается только при необходимости, и в это время все свойства элементов управления уже инициализированы. Это очень помогает для наборов виджетов, где в зависимости от свойств элемента меню он может принадлежать к одному или другому классу, например, Qt.
616	+
617	+	Следующие вещи должны быть реализованы для того, чтобы меню работали:
618	+
619	+	1\) Все методы модуля QtWSMenus, которые будут реализовывать создание и изменение меню
620	+
621	+	2\) функция `TWinCEWidgetSet.SetMenu(AWindowHandle: HWND; AMenuHandle: HMENU): Boolean;` из файла wincewinapi.inc, в котором будет реализована поддержка главного меню, связанного с окном.
622	+
623	+	#### Порядок создания меню
624	+
625	+	При реализации меню важно понимать, в каком порядке они создаются. Например, мы хотим создать следующую структуру меню:
626	+
627	+	<figure>
628	+	<img src="Menu_creation_order.png" title="Menu_creation_order.png" />
629	+	<figcaption>Menu_creation_order.png</figcaption>
630	+	</figure>
631	+
632	+	И когда наше приложение будет выполнено, при каждом вызове TQtWSMenuItem.CreateHandle будет появляться сообщение 'Creating MenuItem'(Создание MenuItem) с заголовком меню и сообщение 'Creating Menu'(Создание меню) с названием меню (потомки TMenu не имеют подпись), каждый раз, когда вызывается TQtWSMenu.CreateHandle.
633	+
634	+	Вот результирующий вывод такого программного обеспечения:
635	+
636	+	` Creating Menu. Name: MainMenu1`\
637	+	` Creating MenuItem: Item1 Parent=Menu.Items : TMenuItem`\
638	+	` Creating MenuItem: SubItem11 Parent=Item1 : TMenuItem`\
639	+	` Creating MenuItem: SubItem12 Parent=Item1 : TMenuItem`\
640	+	` Creating MenuItem: SubItem13 Parent=Item1 : TMenuItem`\
641	+	` Creating MenuItem: SubItem14 Parent=Item1 : TMenuItem`\
642	+	` Creating MenuItem: SubSubItem141 Parent=SubItem14 : TMenuItem`\
643	+	` Creating MenuItem: SubSubItem142 Parent=SubItem14 : TMenuItem`\
644	+	` Creating MenuItem: SubSubItem143 Parent=SubItem14 : TMenuItem`\
645	+	` Creating MenuItem: SubSubItem144 Parent=SubItem14 : TMenuItem`\
646	+	` Creating MenuItem: Item2 Parent=Menu.Items : TMenuItem`\
647	+	` Creating MenuItem: SubItem21 Parent=Item2 : TMenuItem`\
648	+	` Creating MenuItem: SubItem22 Parent=Item2 : TMenuItem`\
649	+	` Creating MenuItem: SubItem23 Parent=Item2 : TMenuItem`\
650	+	` Creating MenuItem: Item3 Parent=Menu.Items : TMenuItem`\
651	+	` Creating MenuItem: Item4 Parent=Menu.Items : TMenuItem`
652	+
653	+	Для всех MenuItems можно использовать GetParentMenu, чтобы получить владельца их родителя: Menu (TMainMenu).
654	+
655	+	### Включение/отключение элемента управления
656	+
657	+	Текущий способ установить включение/отключение элемента управления - реализация winapi EnableWindow. Этот API должен работать в общем на любом элементе управления. Он должен включать/отключать ввод с помощью мыши и клавиатуры для указанного окна или элемента управления, а также помечать его как недоступный для редактирования пользователем, например, делая его серым.
658	+
659	+	``` pascal
660	+	{------------------------------------------------------------------------------
661	+	Method: EnableWindow
662	+	Params: HWnd - handle to window / дескриптор окна
663	+	BEnable - whether to enable the window / нужно ли включать окно
664	+	Returns: If the window was previously disabled / возращаемый результат: если окно было ранее отключено
665	+
666	+	Enables or disables mouse and keyboard input to the specified window or
667	+	control / Включает или отключает ввод с клавиатуры и мыши в указанное окно или
668	+	элемент управления
669	+	------------------------------------------------------------------------------}
670	+	function TWin32WidgetSet.EnableWindow(hWnd: HWND; bEnable: Boolean): Boolean;
671	+	```
672	+
673	+	### Фигурные окна
674	+
675	+	Окна могут быть сформированы на основе растрового изображения (TBitmap) или региона(TRegion). Регион является видимой частью
676	+
677	+	Чтобы реализовать фигурные окна на основе TBitmap, реализуйте TWSWinControl.setShape
678	+
679	+	Для реализации фигурных окон на основе TRegion реализуйте LCLIntf.SetWindowRgn
680	+
681	+	См.также: [[LCL Tips/ru\|Создание не прямоугольных окон или элементов управления]]
682	+
683	+	### Системные цвета
684	+
685	+	Некоторые константы цвета на самом деле являются системными цветами, такими как clBtnFace, clForm, clWindow и проч. и проч.
686	+
687	+	Для реализации поддержки системных цветов должна быть реализована подпрограмма WinAPI GetSysColor:
688	+
689	+	``` pascal
690	+	function GetSysColor(nIndex: Integer): DWORD; override;
691	+	```
692	+
693	+	А вот фрагмент цветовых констант, которые должны поддерживаться. Проверьте LCLType для последних значений:
694	+
695	+	``` pascal
696	+	//==============================================
697	+	// API system Color constants pbd
698	+	// note these are usually shown ORed with
699	+	// $80000000 as these would have interfered with
700	+	// other MS color enumerations
701	+	// GetSysColor and SetSysColor expects the values
702	+	// below
703	+	//==============================================
704	+
705	+	type
706	+	COLORREF = LongInt;
707	+	TColorRef = COLORREF;
708	+
709	+	const
710	+	CLR_INVALID = TColorRef($FFFFFFFF);
711	+
712	+	COLOR_SCROLLBAR = 0;
713	+	COLOR_BACKGROUND = 1;
714	+	COLOR_ACTIVECAPTION = 2;
715	+	COLOR_INACTIVECAPTION = 3;
716	+	COLOR_MENU = 4;
717	+	COLOR_WINDOW = 5;
718	+	COLOR_WINDOWFRAME = 6;
719	+	COLOR_MENUTEXT = 7;
720	+	COLOR_WINDOWTEXT = 8;
721	+	COLOR_CAPTIONTEXT = 9;
722	+	COLOR_ACTIVEBORDER = 10;
723	+	COLOR_INACTIVEBORDER = 11;
724	+	COLOR_APPWORKSPACE = 12;
725	+	COLOR_HIGHLIGHT = 13;
726	+	COLOR_HIGHLIGHTTEXT = 14;
727	+	COLOR_BTNFACE = 15;
728	+	COLOR_BTNSHADOW = 16;
729	+	COLOR_GRAYTEXT = 17;
730	+	COLOR_BTNTEXT = 18;
731	+	COLOR_INACTIVECAPTIONTEXT = 19;
732	+	COLOR_BTNHIGHLIGHT = 20;
733	+	COLOR_3DDKSHADOW = 21;
734	+	COLOR_3DLIGHT = 22;
735	+	COLOR_INFOTEXT = 23;
736	+	COLOR_INFOBK = 24;
737	+	// PBD: 25 is unassigned in all the docs I can find
738	+	// if someone finds what this is supposed to be then fill it in
739	+	// note defaults below, and cl[ColorConst] in graphics
740	+	COLOR_HOTLIGHT = 26;
741	+	COLOR_GRADIENTACTIVECAPTION = 27;
742	+	COLOR_GRADIENTINACTIVECAPTION = 28;
743	+	COLOR_MENUHILIGHT = 29;
744	+	COLOR_MENUBAR = 30;
745	+
746	+	COLOR_FORM = 31;
747	+
748	+	COLOR_ENDCOLORS = COLOR_FORM;
749	+
750	+	COLOR_DESKTOP = COLOR_BACKGROUND;
751	+	COLOR_3DFACE = COLOR_BTNFACE;
752	+	COLOR_3DSHADOW = COLOR_BTNSHADOW;
753	+	COLOR_3DHIGHLIGHT = COLOR_BTNHIGHLIGHT;
754	+	COLOR_3DHILIGHT = COLOR_BTNHIGHLIGHT;
755	+	COLOR_BTNHILIGHT = COLOR_BTNHIGHLIGHT;
756	+
757	+	MAX_SYS_COLORS = COLOR_ENDCOLORS;
758	+	SYS_COLOR_BASE = TColorRef($80000000);
759	+	```
760	+
761	+	### ShowMessage
762	+
763	+	Эти стандартные диалоги реализованы исключительно в LCL в следующих местах:
764	+
765	+	- Файл класса TPromptDialog lcl/include/promptdialog.inc
766	+
767	+	### SpinEdit
768	+
769	+	И TFloatSpinEdit, и TSpinEdit реализованы в классе TWSFloatSpinEdit.
770	+
771	+	### Буфер обмена
772	+
773	+	Поддержка буфера обмена реализована в lclintf путем реализации подпрограмм Windows API. Это процедуры:
774	+
775	+	``` pascal
776	+	function ClipboardFormatToMimeType(FormatID: TClipboardFormat): string; {$IFDEF IF_BASE_MEMBER}virtual;{$ENDIF}
777	+	function ClipboardGetData(ClipboardType: TClipboardType;
778	+	FormatID: TClipboardFormat; Stream: TStream): boolean; {$IFDEF IF_BASE_MEMBER}virtual;{$ENDIF}
779	+	// ! ClipboardGetFormats: List будет создан. Вы должны освободить его самостоятельно с помощью FreeMem(List) !
780	+	function ClipboardGetFormats(ClipboardType: TClipboardType;
781	+	var Count: integer; var List: PClipboardFormat): boolean; {$IFDEF IF_BASE_MEMBER}virtual;{$ENDIF}
782	+	function ClipboardGetOwnerShip(ClipboardType: TClipboardType;
783	+	OnRequestProc: TClipboardRequestEvent; FormatCount: integer;
784	+	Formats: PClipboardFormat): boolean; {$IFDEF IF_BASE_MEMBER}virtual;{$ENDIF}
785	+	function ClipboardRegisterFormat(const AMimeType: string): TClipboardFormat; {$IFDEF IF_BASE_MEMBER}virtual;{$ENDIF}
786	+	```
787	+
788	+	Последовательность вызовов при запуске программы:
789	+
790	+	``` pascal
791	+	TCocoaWidgetSet.ClipboardRegisterFormat AMimeType=image/bmp Result=51027040
792	+	TCocoaWidgetSet.ClipboardRegisterFormat AMimeType=image/delphi.bitmap Result=0
793	+	TCocoaWidgetSet.ClipboardRegisterFormat AMimeType=image/xpm Result=0
794	+	TCocoaWidgetSet.ClipboardRegisterFormat AMimeType=image/png Result=0
795	+	TCocoaWidgetSet.ClipboardRegisterFormat AMimeType=image/jpeg Result=0
796	+	```
797	+
798	+	Последовательность вызовов во время присвоения "Caption:= Clipboard.AsText":
799	+
800	+	``` pascal
801	+	TCocoaWidgetSet.ClipboardRegisterFormat AMimeType=text/plain Result=51026976
802	+	TCocoaWidgetSet.ClipboardGetData ClipboardType=clipboard FormatID: 51026976
803	+	```
804	+
805	+	### TSpeedButton
806	+
807	+	Этот элемент управления является потомком TGraphicControl, поэтому он не имеет дескриптора и рисуется сам. Чтобы сохранить собственный внешний вид, он использует функцию `ThemeServices.DrawElement(Details.Element=teButton)` для отрисовки самого себя, поэтому реализуйте эту функцию, чтобы этот элемент управления работал. Естественно, многие другие DC, WindowOrg, рисование текста и рисование должны работать, как объяснено для TLabel.
808	+
809	+	### TRadioButton и TCheckButton
810	+
811	+	Сообщения:
812	+
813	+	В основном Widgetset должен делать:
814	+
815	+	- Отправлять LM_CHANGE, когда радиокнопка не отмечена/отмечена (LCL позаботится о том, будет ли вызываться OnClick или нет)
816	+	- Не отправлять LM_CHANGE, когда вызывается TWSCustomCheckBox.SetState(SetChecked)
817	+
818	+	См. также этот отчет об ошибке: <http://bugs.freepascal.org/view.php?id=13939>
819	+
820	+	### Поддержка FullScreen
821	+
822	+	FullScreen(окно на весь экран без рамки - прим.перев.) реализован как состояние окна wsFullScreen и, как таковой, реализован в LCLIntf.ShowWindow, где должна обрабатываться константа SW_SHOWFULLSCREEN.
823	+
824	+	## Пример работы интерфейсов LCL
825	+
826	+	Ниже приведен простой пример. Предположим, вы разработали компонент trayicon. Как бы вы реализовали его в LCL для правильной работы на различных поддерживаемых платформах?
827	+
828	+	Вам нужно будет сгенерировать следующие файлы:
829	+
830	+	\trayicon.pas
831	+	\wstrayicon.pas
832	+	\gtk\gtkwstrayicon.pas
833	+	\gtk\trayintf.pas
834	+	\win32\win32wstrayicon.pas
835	+	\win32\trayintf.pas
836	+
837	+	Предоставление отдельных файлов wsXXX.pas и \\\$(LCLWidgetType)\XXXintf.pas полностью исключает необходимость использования ifdefs. Вам нужно будет добавить в качестве пути модуля \$(LCLWidgetType) в файл XXXintf.pas, чтобы инициализировать корректный файл trayintf.pas, который, в свою очередь, инициализирует корректный класс WS Tray.
838	+
839	+	Внутри trayicon.pas вы включаете wstrayicon. Извлеките свой основной класс из класса LCL и используйте только wstrayicon в его реализации. Все классы LCL, которые взаимодействуют с набором виджетов, должны быть получены из [[doc:/lcl/lclclasses/tlclcomponent.html\|TLCLComponent]], объявленного в модуле [[doc:/lcl/lclclasses\|LCLClasses]].
840	+
841	+	``` pascal
842	+	unit TrayIcon;
843	+
844	+	interface
845	+
846	+	type
847	+	TTrayIcon = class(TLCLComponent)
848	+	public
849	+	procedure DoTray;
850	+	end;
851	+
852	+	implementation
853	+
854	+	uses wstrayicon;
855	+
856	+	procedure TTrayIcon.DoTray;
857	+	begin
858	+	// вызов wstrayicon
859	+	end;
860	+
861	+	end.
862	+	```
863	+
864	+	в trayintf вы используете gtkwstrayicon или win32trayicon, в зависимости от того, какой это файл trayintf.
865	+
866	+	в wstrayicon вы создаете класс следующим образом:
867	+
868	+	``` pascal
869	+	unit WSTrayIcon;
870	+
871	+	uses WSLCLClasses, Controls, TrayIcon; // и другие модули
872	+
873	+	TWSTrayIconClass = class of TWSTrayIcon;
874	+	TWSTrayIcon = class(TWSWinControl);
875	+	public
876	+	// все они должны быть виртуальными и классовыми процедурами !!
877	+	class procedure EmbedTrayIcon(const ATrayIcon: TCustomTrayIcon); virtual;
878	+	class procedure RemoveTrayIcon(const ATrayIcon: TCustomTrayIcon); virtual;
879	+	....
880	+	end;
881	+	...
882	+
883	+	implementation
884	+
885	+	procedure TWSTrayIcon.EmbedTrayIcon(const ATrayIcon: TCustomTrayIcon);
886	+	begin
887	+	//ничего не делаем
888	+	end;
889	+
890	+	procedure TWSTrayIcon.RemoveTrayIcon(const ATrayIcon: TCustomTrayIcon);
891	+	begin
892	+	//ничего не делаем
893	+	end;
894	+	```
895	+
896	+	теперь в gtkwstrayicon.pas сделайте так:
897	+
898	+	``` pascal
899	+	uses WSTrayIcon, WSLCLClasses, Controls, TrayIcon, gtk, gdk;
900	+
901	+	TGtkWSTrayIcon = class(TWSTrayIcon);
902	+	private
903	+	class function FindSystemTray(const ATrayIcon: TCustomTrayIcon): TWindow; virtual;public
904	+	class procedure EmbedTrayIcon(const ATrayIcon: TCustomTrayIcon); override;
905	+	class procedure RemoveTrayIcon(const ATrayIcon: TCustomTrayIcon); override;
906	+	class function CreateHandle(const AWinControl: TWinControl; const AParams: TCreateParams): HWND; override;
907	+	....
908	+	end;
909	+	...
910	+
911	+	implementation
912	+
913	+	procedure TGtkWSTrayIcon.CreateHandle(const AWinControl: TWinControl; const AParams: TCreateParams): HWND;
914	+	var
915	+	WidgetInfo: PWidgetInfo;
916	+	begin
917	+	Result := gtk_plug_new;
918	+	WidgetInfo := CreateWidgetInfo(AWinControl, Result); // как-то так или иначе
919	+	TGtkWSWincontrolClass(WidgetSetClass).SetCallbacks(AWinControl);
920	+	// и многое другое
921	+	end;
922	+
923	+	function TGtkWSTrayIcon.FindSystemTray(const ATrayIcon:
924	+	TCustomTrayIcon): TWindow;
925	+	begin
926	+	// что-то делаем
927	+	end;
928	+
929	+	procedure TGtkWSTrayIcon.EmbedTrayIcon(const ATrayIcon: TCustomTrayIcon);
930	+	var
931	+	SystemTray: TWindow;
932	+	begin
933	+	SystemTray := FindSystemTray(ATrayIcon);
934	+	//что-то делаем
935	+	end;
936	+
937	+	procedure TGtkWSTrayIcon.RemoveTrayIcon(const ATrayIcon: TCustomTrayIcon);
938	+	begin
939	+	//что-то делаем
940	+	end;
941	+
942	+	......
943	+
944	+	initialization
945	+
946	+	RegisterWSComponent(TCustomTrayIcon, TGtkWSTrayIcon); //вот это очень важно!!!
947	+
948	+	end.
949	+	```
950	+
951	+	затем наконец-то в trayicon.pas вы пишете как обычно
952	+
953	+	``` pascal
954	+	uses WSTrayIcon; //и т.д., вы НЕ включаете сюда GtkWSTrayIcon!
955	+
956	+	TCustomTrayIcon = class(TWinControl)
957	+	public
958	+	procedure EmbedControl;
959	+	....
960	+	end;
961	+
962	+	...
963	+	procedure TTrayIcon.EmbedControl;
964	+	begin
965	+	TWSTrayIconClass(WidgetSetClass).EmbedControl(Self);
966	+	end;
967	+	```
968	+
969	+	------------------------------------------------------------------------
970	+
971	+	Этот документ находится в стадии разработки. Вы можете помочь, написав разделы этого документа. Если вы не можете найти информацию, которую вы ищете в этом документе, пожалуйста, добавьте свой вопрос на страницу обсуждения. Это поможет нам писать документацию на уровне, который не является ни слишком простым, ни слишком сложным, и полностью охватывает области, о которых люди хотят знать.
972	+
973	+	---
974	+	From the Free Pascal wiki, page "LCL Internals/ru", as it stood on 2020-02-19 after a change by Trev, 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).

Back to history