IME 없이 한글을 조합하는 화면 키보드 — DelphiKeyboard
마우스 클릭만으로 한글과 영문을 입력하는 Delphi VCL 가상 키보드입니다. 두벌식 조합을 직접 처리해 IME 상태와 상관없이 한글이 바르게 조합되고, DLL로 C#·Python·C에서도 씁니다.
키오스크나 터치 화면 프로그램에서는 물리 키보드 대신 화면 키보드로 글을 받아야 할 때가 있습니다. 예전 구현은 가상 키 이벤트를 OS에 주입하고 한글 조합을 Windows 한글 IME에 맡겼습니다. 그런데 IME가 영문 모드면 자모가 영문자로 들어가고, Windows 10/11의 새 한국어 IME는 주입된 한/영 전환 키를 무시하기도 합니다. 그래서 자모가 ㅇ ㅏ ㄴ처럼 낱자로 들어가는 일이 생겼습니다.
DelphiKeyboard는 이 의존을 아예 끊었습니다. 두벌식 조합 오토마타를 컴포넌트 안에 넣어, 클릭한 자모를 직접 완성형 음절로 조합합니다. 키 주입과 전역 마우스 훅도 쓰지 않습니다.

무엇을 하나
TSCVirtualKeyboard를 부르면 키보드 창이 뜨고, Enter로 확정하면 입력한 글을 돌려줍니다. 조합 중인 글자는 반전된 블록으로 보여서 지금 무엇을 조합하고 있는지 바로 보입니다.
- 한/영 전환, Shift는 다음 키 한 번만 적용(ㅂ→ㅃ, a→A), Caps는 영문 대소문자 전환
- Enter로 확정, ESC로 취소, 키가 없는 곳을 끌면 창 이동
- 입력란을 클릭하거나 Home/End/←/→로 커서 이동, 오른쪽 ✕로 전체 지우기
- 물리 키보드로 영문, 숫자, Backspace, 이동 키도 받음(한글은 화면 키로 입력)
- 크기를 바꾸면 키 배치와 글꼴이 비율대로 커지고, 모니터 DPI도 반영
창은 디자인한 폼이 아니라 실행 중에 CreateNew로 만듭니다. 그래서 src\의 유닛 두 개만 프로젝트에 넣으면 되고, 따로 챙길 이미지나 dfm이 없습니다.
써 보기
싱글턴을 바로 씁니다. 만들고 해제할 필요가 없습니다.
uses
SC.VirtualKeyboard;
procedure TfrmMain.BtnKeyboardClick(Sender: TObject);
begin
var LText: string := Edit1.Text;
if TSCVirtualKeyboard.Instance.Execute(LText) then // True when confirmed with Enter
begin
Edit1.Text := LText;
end;
end;
주요 속성은 다음과 같습니다.
| 속성 | 내용 |
|---|---|
Language |
처음 열 때 언어(klKorean 기본 / klEnglish) |
MaxLength |
최대 글자 수, 조합 중인 글자 포함. 0은 제한 없음 |
PasswordChar |
입력란 가림 문자 |
Position |
화면 가운데(기본), 메인 폼 가운데, 직접 지정 |
Width / Height |
96 DPI 기준 크기, 기본 800×376 |
ClickSound |
키 클릭 소리(기본 꺼짐). 소리는 내부에서 합성 |
| 색상 속성 | 배경, 일반·특수 키, 글자, 테두리, 마우스 올림·누름·토글 상태 |
다른 언어에서 쓰기
sc_vkeyboard.dll을 쓰면 C#, C/C++, Python처럼 C ABI를 부를 수 있는 언어에서도 같은 키보드를 띄웁니다. Delphi는 상용 라이선스가 필요하므로 미리 빌드한 32비트·64비트 DLL을 저장소에 넣어 두었습니다. 내보내는 함수는 VKB_Show, VKB_SetClickSound, VKB_Version입니다.
import ctypes
vkb = ctypes.WinDLL("sc_vkeyboard.dll") # WinDLL = stdcall
vkb.VKB_SetClickSound(1) # enable key click sound (optional)
buffer = ctypes.create_unicode_buffer("안녕하세요", 1024)
if vkb.VKB_Show(buffer, 1024, 1, -1, -1, 0, 0, None, ord("\0")) == 1:
print("Input:", buffer.value)
demos\ 폴더에 Delphi(소스 직접 사용, DLL 사용), C#, Python, C 예제가 있습니다. Delphi 없이 먼저 돌려 보려면 GitHub Releases에서 데모 실행 파일과 DLL을 받으면 됩니다.
어떻게 만들었나
조합기는 SC.Hangul.pas의 THangulComposer로, 화면과 떨어져 있어 따로 가져다 쓸 수 있습니다. 초성·중성·종성 세 인덱스를 상태로 두고, 표시할 글자는 그때그때 $AC00 + (초성×21 + 중성)×28 + 종성 공식으로 계산합니다. 조합 버퍼 문자열을 따로 두지 않으니 상태와 화면이 어긋날 일이 없습니다.
복모음(ㅘ, ㅝ, ㅢ 등)과 겹받침(ㄳ, ㄺ, ㅄ 등) 결합, 받침이 다음 음절 초성으로 넘어가는 처리("값" + ㅏ → "갑사"), 자모 단위로 되돌리는 백스페이스(닭 → 달 → 다 → ㄷ)를 다룹니다. 원인 분석과 상태 전이도는 doc/HangulComposition.md에 정리해 두었습니다.
알아 둘 점
- OS IME를 쓰지 않으므로 영어나 일본어 Windows에서도 한국어 IME 설치 없이 한글을 입력합니다. 한글은 맑은 고딕으로 그립니다. Windows Server처럼 한글이 □로 보이면 한국어 글꼴만 추가하면 됩니다.
- 빌드 기준은 Win64이고 Win32도 됩니다. 프로젝트 옵션에서 DPI 인식을 PerMonitorV2로 맞춥니다.
- 라이선스는 MIT입니다. 다만
legacy\폴더는 볼랜드포럼에 공유된 C++Builder 소스를 옮긴 옛 구현이라 원저작자가 라이선스를 밝히지 않아 MIT에서 빠집니다. 현재src\구현은 키 배치 좌표표를 빼고 새로 썼습니다.
소스와 언어별 DLL 안내는 GitHub 저장소에 있습니다.