본문으로 건너뛰기
시골프로그래머의 블로그
블로그 메뉴

IME 없이 한글을 조합하는 화면 키보드 — DelphiKeyboard

마우스 클릭만으로 한글과 영문을 입력하는 Delphi VCL 가상 키보드입니다. 두벌식 조합을 직접 처리해 IME 상태와 상관없이 한글이 바르게 조합되고, DLL로 C#·Python·C에서도 씁니다.

풀빛컴퓨팅4분 읽기#오픈소스#Delphi#가상 키보드#한글 조합

키오스크나 터치 화면 프로그램에서는 물리 키보드 대신 화면 키보드로 글을 받아야 할 때가 있습니다. 예전 구현은 가상 키 이벤트를 OS에 주입하고 한글 조합을 Windows 한글 IME에 맡겼습니다. 그런데 IME가 영문 모드면 자모가 영문자로 들어가고, Windows 10/11의 새 한국어 IME는 주입된 한/영 전환 키를 무시하기도 합니다. 그래서 자모가 ㅇ ㅏ ㄴ처럼 낱자로 들어가는 일이 생겼습니다.

DelphiKeyboard는 이 의존을 아예 끊었습니다. 두벌식 조합 오토마타를 컴포넌트 안에 넣어, 클릭한 자모를 직접 완성형 음절로 조합합니다. 키 주입과 전역 마우스 훅도 쓰지 않습니다.

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 저장소에 있습니다.

함께 읽으면 좋은 글