LCL Drag Dock/ru: what changed

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

Old	New		Line
1	1		Элементы управления или целые формы в графическом интерфейсе пользователя можно склеить и снова отсоединить, перетаскивая их мышью. Такая стыковка похожа на [[LCL Drag Drop\|drag-drop]], но отличается в некоторых аспектах.
2	2
3	3		## Операции
4	4
5	5		Операция стыковки организована так же, как и любая другая операция перетаскивания.
6	6
7	7		### DragInit
8	8
9	9		Как обычно, при запуске стыковки необходимо активировать визуальную обратную связь.
10	10
11	11		### DragTo
12	12
13	13		На ходу нужно сделать пару шагов:
14	14
15	15		- Хочет ли пользователь пристыковаться вообще
16	16		- Определение возможных целевых стыковочных узлов
17	17		- Определение точной зоны бросания элемента управления
18	18		- Визуальная обратная связь
19	19
20	20		### DragDone
21	21
22	22		При бросании элемента управления стыковка может быть заблокирована по нескольким причинам. Трудно объяснить, почему стыковочный узел должен отказывать в откреплении перетаскиваемого элемента управления, когда он, наконец, стаскивается. Возможны следующие случаи:
23	23
24	24		- Элемент управления пристыкован к новому сайту док-станции.
25	25		- Перетаскиваемый элемент управления становится плавающим
26	26		- как есть, если он уже был плавающим, или когда он может стать самостоятельно плавающим это TWinControl),
27	27		- или завернутый в новую плавающую форму.
28	28		- Вся операция прервана.
29	29
30	30		## Обзор стыковочных элементов
31	31
32	32		Помимо drag-drop участников, на сцену выходят еще несколько участников:
33	33
34	34		- Стыковочные узлы (Dock sites)
35	35		- Стыковочные прямоугольники в качестве визуальной обратной связи
36	36		- Диспетчеры стыковки (Dock managers)
37	37
38	38		Введение диспетчеров стыковки создало кучу новых проблем с плохой интеграцией в модель неуправляемой док-станции. Давайте пока проигнорируем [[LCL Managed Docking\|"управляемую" стыковку]] и рассмотрим только "неуправляемую" стыковку.
39	39
40	40		### Прикрепляемый элемент (Dock Source)
41	41
42	42		Элемент управления или форму можно сделать прикрепляемыми, установив для его свойства `DragKind` значение `dkDock`.
43	43
44	44		### Стыковочные узлы (Dock Sites)
45	45
46	46		Для стыковки требуются специальные целевые зоны сброса \[для прикрепляемого элемента\], называемые стыковочными узлами. TWinControl становится такой стыковочной целью, при установке его свойства `DockSite` в значение `True`.
47	47
48	48		Прикрепленные элементы управления находятся в отдельном массиве элементов, отделенном от других компонентов в элементе управления контейнера. Для правильного поведения настоятельно рекомендуется изначально не иметь никаких других элементов управления на стыковочном сайте и заполнять его только закрепленными элементами управления.
49	49
50	50		#### Плавающие стыковочные узлы
51	51
52	52		Другой вид стыковочных узлов используется для незакрепленных (плавающих) элементов управления. Когда элемент управления бросается за пределы стыковочного узла, и это не TWinControl, для него создается новая форма в месте размещения. Когда плавающий элемент управления позже стыкуется со стыковочным узлом, плавающая форма уничтожается.
53	53
54	54		Приложение может создавать другие формы для плавающих элементов управления, например, несколько элементов управления могут быть закреплены внутри и вне такой формы.
55	55
56	56		### Стыковочный прямоугольник (DockRect)
57	57
58	58		Как и в операциях drag-drop, при операции стыковки за указателем мыши следует значок в форме прямоугольника. Но значок стыковочного прямоугольника может динамически изменять свой размер и положение, чтобы сигнализировать о положении и размере элемента управления, когда последний бросается в текущем месте.
59	59
60	60		Когда не удается найти принимающий стыковочный узел или когда пользователь запрещает перетаскивание, удерживая клавишу Ctrl, DockRect отражает плавающий размер и положение перетаскиваемого элемента управления. Плавающий размер инициализируется исходным размером перетаскиваемого элемента управления и обновляется при перемещении элемента управления. В противном случае стыковочный узел может определить размещение и размер брошенного элемента управления.
61	61
62	62		Реализация Delphi запоминает координаты нарисованного DockRect в `EraseDockRect`, так что старый фрейм может быть удален с экрана с помощью XOR-рисования, когда это необходимо.
63	63
64	64		### Стыковочный объект (DockObject)
65	65
66	66		В операции стыковки используется специальный DockObject, производный от TDragObject. Непонятно, почему этот класс вводит новые методы вместо того, чтобы переопределять существующие виртуальные методы для различной визуальной обратной связи.
67	67
68	68		Унаследованный DragTarget - это целевой стыковочный сайт в стыковке. Добавленные свойства `DropOnControl` и `DropAlign` указывают, где и как перетаскиваемый элемент управления должен располагаться относительно уже закрепленного элемента управления.
69	69
70	70		### Помощники (Helpers)
71	71
72	72		В классы TControl и TWinControl добавлен ряд вспомогательных методов и полей для внутреннего управления закрепленными элементами управления и настройки процесса стыковки. Большинство этих помощников играют особую роль в процессе стыковки и будут описаны в рабочем процессе ниже.
73	73
74	74		(место для описания общих элементов)
75	75
76	76		## Механика процесса
77	77
78	78		Это подробное описание необходимых действий до, во время и после закрепления элемента управления.
79	79
80	80		### Предпосылки
81	81
82	82		Элемент управления становится стыкуемым, если для его `DragKind` задано значение `dkDock`. Для стыковочного узла больше ничего не требуется.
83	83
84	84		Глобальный список содержит все стыковочные узлы в приложении. Стыковочные узлы добавляются и удаляются из этого списка при изменении их свойства `DockSite`.
85	85
86	86		#### RegisterDockSite
87	87
88	88		Стыковочные узлы могут быть частично или полностью покрыты другими формами, но в любом случае должны действовать как стыковочные цели. Эта процедура регистрирует и отменяет регистрацию элементов управления в приложении в качестве стыковочных узлов, так что даже скрытые кандидаты могут быть найдены при перетаскивании источника стыковчного узла по экрану.
89	89
90	90		#### GetSiteInfo
91	91
92	92		Метод `TWinControl.GetSiteInfo` возвращает прямоугольник влияния (захвата), связанный со стыковочным узлом. Это соглашение позволяет, например, скрыть стыковочные узлы в графическом интерфейсе, без превращения их в недоступные для удаления. Реализация по умолчанию возвращает видимый размер элемента управления, увеличенный на определенную величину в любом направлении.
93	93
94	94		### DragInit
95	95
96	96		Стыковка запускается автоматически, когда для элемента управления задано значение `DragKind=dkDock` и `DragMode=dmAutomatic`, а на этом элементе управления нажата левая кнопка мыши. TControl предоставляет метод `BeginAutoDrag` для этого случая и метод `BeginDrag` для запуска программной стыковки, когда `DragMode=dmManual`.
97	97
98	98		`DockObject` создается либо обработчиком `OnDockStart` исходного элемента управления (`TControl.DoStartDock`), либо диспетчером перетаскивания, если такой объект не был предоставлен. `DockRect` инициализируется прямоугольником элемента управления. Для удобного положения `DockRect` во время перемещений запоминается смещение указателя мыши на `DockRect`.
99	99
100	100		Захват ввода перемещается в элемент управления или в его родительский элемент `TWinControl`, когда элемент управления не может получать системные (Windows) сообщения.
101	101
102	102		Когда перетаскивание должно начаться немедленно, вызывается `DragTo`.
103	103
104	104		### DragTo
105	105
106	106		`DragTo` проверяет наличие отложенного запуска и ничего не делает, если порог перемещения мыши еще не достигнут.
107	107
108	108		В противном случае ищется цель перетаскивания. Когда цель изменяется, `DoDragOver` отправляет в цель `dmDragLeave` и `dmDragEnter` в виде сообщений `CM_DRAG`.
109	109
110	110		Сообщение `dmDragMove` отправляется таким же образом и обрабатывается в `TWinControl.DockOver`, который позиционирует `DockRect` и вызывает обработчик `OnDockOver`. Результат указывает, будет ли принято решение о сбросе, и соответственно обновляется визуальная обратная связь.
111	111
112	112		#### Горести Delphi
113	113
114	114		Следующий шаг в реализации Delphi - фиктивный. Когда cброс(dropping) отклонен, `DockRect` сбрасывается в плавающее положение и размер перетаскиваемого элемента управления, что уже должно было быть сделано раньше. Кроме того, на стыковочном узле выполняется поиск `DropOnControl` и определяется `DropAlign`. Ни одно из этих значений не отражается в ранее определенном `DockRect`, поэтому предполагаемый эффект становится видимым в лучшем случае (если вообще когда-либо) после следующего движения мыши. Когда `DropOnControl` не найден, что весьма вероятно на неуправляемом стыковочном узле, `DockRect` будет охватывать весь стыковочный узел - что не очень важно. Когда `DropOnControl` найден, значение `DropAlign` не определено; реализация Delphi использует это значение для настройки `DockRect` на верхнюю (левую ...) половину `DropOnControl`, но такое размещение отброшенного элемента управления может иметь смысл только тогда, когда сам `DropOnControl` соответствующим образом сокращается. В управляемом стыковочном узле DockManager может настраивать `DockRect`, а затем может уместить затронутые элементы управления в указанные границы, но у него нет возможности самому определить `DropOnControl` или `DropAlign`. Таким образом, значение `DropOnControl` и `DropAlign` вызывает сомнения как для управляемых, так и для неуправляемых стыковочных узлов.
115	115
116	116		При лучшем решении этот шаг будет полностью опущен, а обработчики событий и стыковочного узла будут управлять визуальной обратной связью и окончательным сбросом или оставят все это установленному DockManager.
117	117
118	118		### DragDone
119	119
120	120		Когда перетаскивание завершено, либо при отмене, либо при успешном перетаскивании, захват снимается, а визуальная обратная связь удаляется с экрана. Дальнейшая процедура зависит от успеха операции.
121	121
122	122		#### Ручная стыковка
123	123
124	124		Метод `TControl.ManualDock` обходит все действия пользователя и закрепляет элемент управления на стыковочном узле или делает его плавающим (`TControl.ManualFloat`). Если требуется для дальнейшей обработки запроса, должен быть создан и инициализирован `DockObject` из параметров.
125	125
126	126		#### Сброс внутри стыковочного узла
127	127
128	128		На первом этапе элемент управления логически перемещается на новый стыковочный узел, если только он не будет повторно пристыкован на том же стыковочном узле. Он удаляется из списка элементов управления старого узла и перемещается в список закрепленных элементов управления нового стыковочного узла, а его родительский элемент корректируется соответствующим образом.
129	129
130	130		Наконец, в соответствии с последним `DockRect`, элемент управления помещается в новый родительский элемент. В управляемой стыковочном узле DockManager может при необходимости переставлять закрепленные элементы управления.
131	131
132	132		#### Сброс в никуда
133	133
134	134		Перетаскиваемый элемент управления становится плавающим. Форма может перемещаться сама по себе, но для удобства все элементы управления могут быть заключены в специальный контейнер плавающей формы (по умолчанию: `FloatingDockSiteClass=CustomDockForm`).
135	135
136	136		Сообщение `CM_FLOAT` отправляется в исходный код элемента управления. Когда элемент управления уже плавает, он перемещает свой родительский элемент, и все готово.
137	137
138	138		В противном случае элемент управления устанавливает `DragTarget` на вновь созданный стыковочный узел, а затем закрепляется на этом узле, как и на любом другом целевом узле.
139	139
140	140		#### Отмена сброса
141	141
142	142		Исходный элемент управления получает уведомление `DragCanceled`, вот и все.
143	143
144	144		## События
145	145
146	146		Во время стыковки происходят следующие события:
147	147
148	148		### DragInit
149	149
150	150		Обработчик `StartDrag`/`Dock` может возвращать пользовательский `Drag`/`DockObject`.
151	151
152	152		### DragTo
153	153
154	154		При стыковке зарегистрированные стыковочные узлы получают событие `GetSiteInfo`. Обработчики могут предоставить прямоугольник влияния и указать, допустим ли сброс.
155	155
156	156		Когда цель изменяется, старая и новая цели получают событие `Drag`/`DockOver` с состоянием `dmDragEnter`/`Leave`.
157	157
158	158		Во всех случаях происходит событие `Drag`/`DockOver` в состоянии `dmDragMove`. Обработчик может отклонить перетаскивание и может настроить визуальную обратную связь в данном объекте drag/dock.
159	159
160	160		### DragDone
161	161
162	162		Конечное значение `Drag`/`DockMove` состояния `dmDragLeave` отправляется цели. Это первое событие в программном сбросе элемента управления (`TControl.ManualDock`). Состояние лучше должно быть `dmDragMove`, но реализация Delphi использует `dmDragLeave`.
163	163
164	164		При стыковке событие `UnDock` позволяет исходному сайту отклонить (отменить) сброс. Обработчику событий, стыковочному узлу и стыковочному диспетчеру предлагается последовательно отклонить или выполнить соответствующее внутреннее действие.
165	165
166	166		Если перетаскивание не отклоняется, возникает событие `Drag`/`DockDrop`.
167	167
168		-	~~Во всех случаях источник получает событие <code>EndDrag<code>/`Dock`.~~
	168	+	Во всех случаях источник получает событие EndDrag/`Dock`.
169	169
170	170		---
171	171		From the Free Pascal wiki, page "LCL Drag Dock/ru", as it stood on 2021-01-18 after a change by Zoltanleo, 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