KOL-CE/ru: what changed

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

Old	New		Line
1	1		## Введение
2	2
3	3		KOL-CE - это [KOL&MCK](http://f0460945.xsph.ru/rindex.htm) от Владимира Кладова, портированная под Free Pascal/Lazarus. KOL-CE создана Юрием Сидоровым и распространяется под [wxWindows Library Licence](http://www.opensource.org/licenses/wxwindows.php).
4	4
5	5		KOL-CE позволяет создавать очень компактные Win32/WinCE GUI приложения (начиная от ~40KB приложения с пустой формой).
6	6
7	7		MCK это пакет, позволяющий проектировать приложения KOL-CE визуально, используя Lazarus IDE.
8	8
9	9		Изначально KOL-CE планировался как KOL, портированный только для [[WinCE port\|WinCE]]. Но потом было решено оставить функции Win32 и доделать его работу с FPC. Оригинальный KOL предназначалась для Delphi и работает во Free Pascal с ошибками. А оригинал MCK вообще нельзя было использовать для Lazarus.
10	10
11	11		### Требования
12	12
13	13		- Free Pascal compiler 2.2.0 или позже для Win32.
14	14		- arm-wince cross compiler 2.2.0 или позже для Win32 (for [[WinCE port\|WinCE]] development).
15	15		- Lazarus 0.9.26 или позже для Win32.
16	16
17	17		### Поддерживаемые платформы:
18	18
19	19		- Все 32-битные Windows: от Windows 95 до Windows 7.
20	20		- [[WinCE port\|Windows CE]] для PocketPC и смартфонов.
21	21
22	22		## Загрузка
23	23
24	24		Последний релиз KOL-CE можно скачать [здесь](http://sourceforge.net/project/showfiles.php?group_id=188451).
25	25
26	26		Также вы можете получить свежие исходники KOL-CE из [SVN](https://kol-ce.svn.sourceforge.net/svnroot/kol-ce/trunk).
27	27
28	28		## Установка
29	29
30	30		------------------------------------------------------------------------
31	31
32	32		Важно: После KOL-CE 2.80.2 определение `DisableFakeMethods` больше не требуется.
33	33
34	34		Если раньше вы использовали KOL-CE 2.80.1 или ранее, вам надо пересобрать Lazarus без определения `DisableFakeMethods` перед установкой пакета MCK. Иначе обработчики событий не будут работать!
35	35
36	36		Сделаем это:
37	37
38	38		1. Запустить Lazarus.
39	39		2. Выбрать пункт Tools \> Configure "Build Lazarus"... (Сервис \> Параметры сборки Lazarus...).
40	40		3. Выбрать Clean Up + Build all(Очистить всё + собрать всё) на странице Quick Build Options (простые параметры сборки).
41	41		4. Открыть страницу Advanced Build Options (Расширенные параметры сборки) и remove `-dDisableFakeMethods` из поля ввода Options .
42	42		5. Кликнуть по кнопке Build для пересборки Lazarus.
43	43
44	44		------------------------------------------------------------------------
45	45
46		-	~~<figure>~~
47		-	~~<img src="MirrorKOLPackage.png" title="MCK package" />~~
48		-	~~<figcaption>MCK package</figcaption>~~
49		-	~~</figure>~~
	46	+	![](/wiki-images/2/2e/MirrorKOLPackage.png)
50	47
51	48		1. Загрузите KOL-CE и поместите куда-нибудь рядом с Лазарусом.
52	49		2. Запустите Lazarus и выберите пункты меню Components \> Load package file. Укажите папку MCK и выберите файл `MirrorKOLPackage.lpk`.
53	50		3. Появится окно содержимого пакета. Нажмите кнопку Install.
54	51		4. Лазарус скомпилирует пакет MCK перезапустится.
55	52		5. После этого на палитре компонентов появится вкладка KOL.
56	53
57		-	~~<figure>~~
58		-	~~<img src="KOLComponents.png" title="\|KOL components palette" />~~
59		-	~~<figcaption>\|KOL components palette</figcaption>~~
60		-	~~</figure>~~
	54	+	![](/wiki-images/d/d1/KOLComponents.png)
61	55
62	56		СОВЕТ: Если вы видите не все компоненты KOL на палитре компонентов, увеличьте размер окна по вертикали. Появится вторая строка с недостающими копонентами (см. скриншот).
63	57
64	58		Обновить пакет MCK очень легко. Просто перезапишите обновленные KOL-CE исходники поверх (вместо) старых, откройте пакет MCK через Lazarus и нажмите Install, пакет перекомпилится, и будет вам счастье!
65	59
66	60		## Особенности использования MCK
67	61
68	62		### Создание нового проекта
69	63
70		-	~~<figure>~~
71		-	~~<img src="MCKForm.png" title="MCK form" />~~
72		-	~~<figcaption>MCK form</figcaption>~~
73		-	~~</figure>~~
	64	+	![](/wiki-images/0/04/MCKForm.png)
74	65
75	66		1. Запустите Lazarus, выберите File \> New... (Файл \> Создать ...).
76	67		2. Выберите KOL Application в секции Project и нежмите OK.
77	68		3. Будет создан новый KOL проект.
78	69		4. Сохраните проект под новым именем.
79	70		5. Продукт готов к использованию, срок годности ограничен вашей фантазией =). Можете развлекаться!
80	71
81	72		### Добавление формы
82	73
83	74		1. Выберите File \> New... (Файл \> Создать ...).
84	75		2. Выберите KOL Form(иногда просто Form) в секции File (Модуль) и нажмите OK.
85	76		3. Сохраните модуль с формой под новым именем.
86	77
87	78		### Особенности написания кода
88	79
89	80		Не используйте элементы из RTL/FCL/LCL, особенно из SysUtils, Classes, Forms и подобных им. Всё необходимое придётся искать в модулях KOL, Windows, Messages. А может быть, вы напишете что-то сами (или скопируете из других исходников). Если вы пишете в зеркальном проекте (mirror project) - Обычно поместите его в обработчики событий. Вы также можете добавлять любой код где пожелаете, но избегайте изменения первой секции объявления класса вашей зеркальной LCL формы. И не изменяйте автоматически созданные inc-файлы. Всегда помните, что код, который вы пишете в зеркальном проекте, должен быть принят и LCL, и KOL. LCL - на этапе компиляции зеркального проекта (и это необходимо, потому что иначе конвертация зеркального проекта в отражённый KOL проект будет невозможна). А KOL - на этапе компиляции написанного кода в KOL.
90	81
91	82		### Важно
92	83
93	84		Для решения конфликта между словами `LCL.Self` и `KOL.@Self`, которые интерпретируются по-разному в KOL и LCL, добавлен специальный компонент - `Form`. В LCL, свойство `Form` типа компонент `TKOLForm` "возвращает" `Self`, То есть форму. А в KOL, `Form: PControl` - это поле-объект, содержащий сам объект-форму. Поэтому, вместо
94	85
95	86		`MainForm.caption := 'Hello!', где MainForm - ваша форма, пишите`\
96	87		`Form.Caption := 'Hello!'; `
97	88
98	89		(Старое обращение Caption := 'Hello!'; компилируется нормально при преобразовании зеркального проекта в KOL, однако в самом(без MCK) KOL это будет неправильно). Но через `Form` можно обращаться только к свойствам формы - не к дочерним компонентам. Вам доступны дочерние компоненты и обработчики событий черес саму форму. например:
99	90
100	91		`Button1.Caption := 'OK';`\
101	92		`Button1Click(Form);`
102	93
103	94		### Run-time создание форм
104	95
105	96		Можно создать несколько экземпляров одной и той же формы во время выполнения программы. Притом можно сделать не АвтоСоздаваемую форму, а создавать её программно, когда это необходимо. Используйте глобальную функцию `NewForm1` (замените Form1 на имя вашей зеркальной формы) например:
106	97
107	98		`NewForm1( TempForm1, Applet );`
108	99
109	100		Для таких созданных во время выполнения форм справедливо то же правило, что и дляавтосозданных - обращайтесь к сваойствам формы через свойство-объект `Form`
110	101
111	102		## WinCE
112	103
113	104		#### Установка
114	105
115	106		![arm-wince target](/wiki-images/5/5e/Arm-wince-target.png) Для начала надо установить кросскомпилятор arm-wince for Win32 для компиляции исполняемых файлов WinCE. Можно скачать [здесь](http://www.freepascal.org/download.var). Нужно скачать lazarus с кросскомпилятором в комплекте и затем установить поверх уже установленного Lazarus'a, то есть в ту же папку.
116	107
117	108		Чтобы компилировать под arm-wince откройте параметры компилятора для вашего проекта, выбрав пункт меню Project \> Compiler options.... Откройте вкладку Code (Код) и поменяйте операционную систему на WinCE, а целевое семейство процессоров на arm.
118	109
119	110		На вкладке Пути поменяйте библиотеку виджетов LCL на WinCe.
120	111
121	112		ПРИМЕЧАНИЕ: Вы можете получить следующие сообщения об ошибке во время компиляции вашего KOL-CE проекта для WinCE:
122	113
123	114		`Compiling resource KOL-CE.rc`\
124	115		`arm-wince-windres.exe: no resources`\
125	116		`KOL.PAS(57901) Error: Error while linking`\
126	117		`KOL.PAS(57901) Fatal: There were 1 errors compiling module, stopping`
127	118
128	119		В таком случае вам нужно изменить переменную окружения PATH Windows и добавить путь к папке, где расположены файлы win32 FPC.\
129	120		Чтобы узнать, какой путь добавить, перейдите наОкружение\>Параметры в Lazarus и посмотреть путь к компилятору.\
130	121		Перед изменением PATH закройте Lazarus.\
131	122		====Редактирование переменной окружения PATH====
132	123
133	124		##### в Windows XP
134	125
135	126		1.Правой кнопкой мыши щелкните по значку "Мой компьютер" и выберите пункт меню "Свойства". 2.Перейдите на вкладку "Дополнительно". 3.Нажмите кнопку "Переменные среды". 4.Выберите в списке переменную path, нажмите изменить и через точку с запятой добавьте путь к папке.
136	127
137	128		##### в Windows 7
138	129
139	130		1.Нажмите пуск. 2.Нажмите правой кнопкой мыши по пункту Компьютер.Выберите пункт меню свойства. 3.Нажмите на Дополнительные параметры системы (список слева). 4.На вкладке Дополнительно нажмите кнопку Переменные среды. 5.Выберите в списке переменную path, нажмите изменить и через точку с запятой добавьте путь к папке.
140	131
141	132		#### Hints and notes
142	133
143	134		- Чтобы сделать полноэкранный вид, не пытайтесь изменить позицию окна и его размер. Если попытаться это сделать, форма будет выглядеть как диалог с заголовком и кнопкой закрыть. В MCK установите defaultSize и defaultPosition of TKOLForm в True для достижения цели.
144	135
145	136		#### Известные проблемы
146	137
147	138		- Следующие компоненты не поддерживаются: RichEdit.
148	139		- Прозрачность и двойная буферизация также не поддерживаются.
149	140		- Работают значения свойства gradient panel styles только gsVertical и gsHorizontal.
150	141		- Горизонтальное выравнивание текста не работет в однострочном компоненте edit. Используйте memo если вам оно нужно.
151	142		- Vertical text alignment does not work for panel and label.
152	143
153	144		## Документация
154	145
155	146		- Посетите официальный сайт KOL&MCK для получения документации и информации: <http://kolmck.ru>
156	147		- Прочитайте документацию MCK в файле KOLmirrorReadme.txt, лежащем в папке MCK.
157	148
158	149		## Приложения, использующие KOL-CE
159	150
160	151		- [Password Manager XP Mobile](http://www.cp-lab.com/windows-mobile.html)
161	152		- [ChARMeD disassembler](http://blog.carolos.za.net/2007/05/charmed-for-pocket-pc-beta-030.html)
162	153		- [WMWifiRouter](http://www.jongma.org/WMWifiRouter/)
163	154
164	155		## См. также
165	156
166	157		- [Официальный вебсайт KOL&MCK](http://f0460945.xsph.ru/rindex.htm)
167	158		- Страничку KOL-CE на SourceForge <http://sourceforge.net/projects/kol-ce/>
168	159		- [Портирование на WinCE c помощью Free Pascal](http://wiki.lazarus.freepascal.org/WinCE_port/ru)
169	160		- [[Windows CE Interface]]
170	161		- [[Windows CE Development Notes]]
171	162
172	163		## Contacts
173	164
174	165		Report bugs, submit patches and ask questions at project's page at SourceForge: <http://sourceforge.net/projects/kol-ce/>
175	166
176	167		---
177	168		From the Free Pascal wiki, page "KOL-CE/ru", as it stood on 2021-04-29 after a change by Seenkao, 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).
178	169		Category: Components/ru
179	170		Category: Russian
180	171		Category: WinCE/ru

Back to history