KOL-CE/ko

This article applies to Windows only.

See also: Multiplatform Programming Guide

This article applies to Windows CE only.

See also: Multiplatform Programming Guide

│ English (en) │ français (fr) │ 한국어 (ko) │ русский (ru) │ 中文（中国大陆）‎ (zh_CN) │ 中文（台灣）‎ (zh_TW) │

소개

KOL-CE는 Vladimir Kladov가 개발한 KOL&MCK의 프리 파스칼/라자루스 포트이다(http://kolmck.net). KOL-CE는 Yury Sidorov가 개발하였으며 다음 라이선스하에 배포된다wxWindows Library Licence.

KOL-CE는 매우 컴팩트한 Win32/WinCE GUI 응용프로그램을 생성하게 해준다.(텅 빈 폼을 가진 프로젝트의 실행 파일을 ~40KB 실행파일이 되게 해준다.)

MCK는 라자루스 IDE에서 KOL-CE 프로젝트를 VISUAL 개발 가능하게 해주는 라자루스 패키지이다.

초기에 KOL-CE는 WinCE를 위한 KOL 포트로서만 계획되었다. 그러나 이것은 나중에 Win32 기능을 하고 FPC를 부드럽게 동작하도록 결정되었다.오리지널 KOL은 델파이를 위해 만들어 졌고 FPC와는 잘 동작하지 않았다. 오리지널 MCK는 라자루스와 함께 사용될 수 없었다.

요구사항

• 프리파스칼 컴파일러 2.2.0 또는 나중의 Win32용
• arm-wince 크로스 컴파일러 2.2.0 또는 나중의 Win32용([[WinCE port|WinCE] 개발을 위해)
• 라자루스 0.9.26 또는 나중의 Win32용

지원하는 타겟

• 모든 32-비트 윈도우즈: 윈도우즈 95에서 Vista까지
• Windows CE기반 포켓 PC 및 스마트폰

다운로드

최근의 KOL-CE 배포판을 다운로드한다이곳.

또한 가장 최근의 KOL-CE소스를 svn에서 다음 링크를 통해 체크할 수 있다: https://kol-ce.svn.sourceforge.net/svnroot/kol-ce/trunk

Installation

---

Important: Since KOL-CE 2.80.2 DisableFakeMethods define is not needed anymore.

If you previously used KOL-CE 2.80.1 or older, you need to rebuild Lazarus without DisableFakeMethods define before installing MCK package. Otherwise event handlers will not work!

To do that:

1. Run Lazarus.
2. Choose Tools > Configure "Build Lazarus"... menu item.
3. Choose Clean Up + Build all on Quick Build Options page.
4. Open Advanced Build Options page and remove -dDisableFakeMethods from Options input field.
5. Click Build button to rebuild Lazarus.

---

1. Download KOL-CE sources and put them on some folder on your filesystem.
2. Run Lazarus and choose Components > Load package file menu item. Then navigate to MCK folder and choose MirrorKOLPackage.lpk file.
3. Package window will appear. Press Install button.
4. Lazarus will compile MCK package and IDE will be restarted.
5. After restart KOL tab will appear on components palette.

NOTE: If you can't see all KOL components on the palette, resize window with components palette vertically. You will see the second row of components on KOL tab (as on screenshot above).

MCK package upgrade is very simple as well. Just overwrite KOL-CE sources with new version, open MCK package and press Install button to recompile the package.

Using MCK

Creating MCK project

1. Start Lazarus and select File > New... menu item.
2. Choose KOL Application under Project section and press OK button.
3. New project for KOL application will be created.
4. Save this project with desired name.
5. Play with your new KOL/MCK Project (adjust parameters, drop TKOL... components, compile, run, debug, etc.) Enjoy!

Adding a form

1. Select File > New... menu item.
2. Choose KOL Form under File section and press OK button.
3. Save new form with desired name.

Writing code

Do not use names from RTL/FCL/LCL, especially from SysUtils, Classes, Forms, etc. All what you need, you should find in KOL, Windows, Messages units. And may be, write by yourself (or copy from another sources). When you write code in mirror project - usually place it in event handlers. You also can add any code where you wish but avoid changing first section of your mirror LCL form class declaration. And do not change auto-generated inc-files. Always remember, that code, that you write in mirror project, must be accepted both by LCL and KOL. By LCL - at the stage of compiling mirror project (and this is necessary, because otherwise converting mirror project to reflected KOL project will not be possible). And by KOL - at the stage of compiling written code in KOL namespace.

IMPORTANT

To resolve conflict between words LCL.Self and KOL.@Self, which are interpreted differently in KOL and LCL, special field is introduced - Form. In LCL, Form property of TKOLForm component "returns" Self, i.e. form object itself. And in KOL, Form: PControl is a field of object, containing resulting form object. Since this, it is correctly to change form's properties in following way:

Form.Caption := 'Hello!'; 

(Though old-style operator Caption := 'Hello!'; is compiled normally while converting mirror project to KOL, it will be wrong in KOL environment). But discussed above word Form is only to access form's properties - not its child controls. You access child controls and form event handlers by usual way. e.g.:

Button1.Caption := 'OK';
Button1Click(Form);

Run-time form creation

It is possible to create several instances of the same form at run-time. And at least, it is possible to make form not AutoCreate, and create it programmatically when needed. Use global function NewForm1 (replacing Form1 with your mirror form name), for instance:

NewForm1( TempForm1, Applet );

To make this possible, NEVER access global variable created in the unit during conversation, unless You know why You are doing so. Refer to Form variable instead.

WinCE

Setup

You need to install arm-wince cross compiler for Win32 to compile WinCE executables. Get it here.

To compiler for arm-wince target open compiler options of your project using Project > Compiler options... menu item. Open Code tab and change target platform to arm-wince.

NOTE: You can receive the following error while compiling your KOL-CE project for WinCE:

Compiling resource KOL-CE.rc
arm-wince-windres.exe: no resources
KOL.PAS(57901) Error: Error while linking
KOL.PAS(57901) Fatal: There were 1 errors compiling module, stopping

In such case you need to edit Windows PATH environment variable and add path to folder where win32 fpc binaries are located.
To find out which path to add, go to Environment options in Lazarus and see compiler path.
Quit Lazarus before editing PATH.
To edit PATH variable right click on My Computer icon go to Advanced tab and click Environment Variables button.

Hints and notes

• To make form fullscreen as most Pocket PC applications have, don't change the form position and size. If form size and/or position was changed the form will look like dialog with caption and close button. In MCK set defaultSize and defaultPosition of TKOLForm to True to make form fullscreen.

Known issues

• The following components are not supported: RichEdit.
• Transparency and double buffering are not supported.
• Only gsVertical, gsHorizontal gradient panel styles are supported.
• Horizontal text alignment does not work in single line edit control. Use memo if you need text alignment.
• Vertical text alignment does not work for panel and label.

Documentation

• Visit official KOL&MCK website for documentation and information: http://kolmck.net
• Read MCK documentation in KOLmirrorReadme.txt file inside MCK folder.

KOL-CE in real-world applications

• Password Manager XP Mobile
• ChARMeD disassembler
• WMWifiRouter

See also

• Official KOL&MCK website http://kolmck.net
• KOL-CE page at SourceForge http://sourceforge.net/projects/kol-ce/
• WinCE port of Free Pascal
• Windows CE Interface
• Windows CE Development Notes

Contacts

Report bugs, submit patches and ask questions at project's page at SourceForge: http://sourceforge.net/projects/kol-ce/