델파이 폼 디자이너에서 휠로 가로·세로 스크롤 — delphi-ide-scroll
델파이 IDE 폼 디자이너에서 휠은 세로, Ctrl+휠은 가로로 스크롤하게 바꿔 주는 작은 유틸리티입니다. 큰 폼을 자주 만지는 델파이·C++Builder 개발자에게 맞습니다.
화면보다 큰 폼을 델파이 폼 디자이너에서 손보다 보면 스크롤 막대를 끌고 다니는 시간이 길어집니다. 휠을 굴려도 원하는 방향으로 움직이지 않고, 가로로 넘어가려면 아래쪽 막대까지 마우스를 옮겨야 합니다.
delphi-ide-scroll(프로그램 이름은 IDEScroll)은 이 동작을 바꿉니다. 폼 디자이너 위에서 휠은 세로, Ctrl+휠은 가로로 스크롤합니다.

무엇을 하나
| 기능 | 내용 |
|---|---|
| 휠 | 세로 스크롤 |
| Ctrl + 휠 | 가로 스크롤 |
| 감도 | 세로·가로 따로, 휠 한 칸에 몇 줄 움직일지 지정 |
| 설정 저장 | 실행 파일 옆 IDEScroll.ini에 저장하고 다음 실행 때 불러옴 |
디자이너 위가 아닐 때는 휠 동작에 끼어들지 않습니다.
두 가지 형태
| 형태 | 설명 | 타깃 |
|---|---|---|
| 스탠드얼론 EXE | 따로 띄우는 실행 파일. 켜고 끄는 화면과 감도 설정이 있음 | Win64 |
| IDE 패키지(.bpl) | IDE에 설치하면 자동으로 동작하고 도킹형 미니맵을 함께 제공 | Win32(IDE가 32비트 프로세스) |
EXE는 Releases에서 IDEScroll.exe를 받아 실행하고 후킹 시작 버튼(또는 Enter)을 누르면 됩니다. 다시 누르면 멈추고, 종료할 때 감도 설정이 저장됩니다.
패키지는 build-bpl.cmd로 빌드한 뒤 IDE 메뉴 Component → Install Packages → Add에서 만들어진 .bpl을 고릅니다. Delphi 13.0 기준으로 bin\IDEScrollPkg370.bpl이 생깁니다. 패키지 버전의 감도는 %APPDATA%\IDEScroll\IDEScroll.ini에서 바꿉니다.
미니맵
패키지를 설치하면 View → IDEScroll Minimap으로 도킹 창을 엽니다. 폼 디자이너의 전체 스크롤 영역을 줄여서 보여 주고, 지금 보이는 영역을 반투명 상자로 표시합니다.
- 상자를 끌거나 미니맵 위에서 휠·Ctrl+휠을 굴리면 디자이너가 그 위치로 스크롤됩니다. 상자 밖을 누르면 그 지점으로 바로 이동합니다.
- 컨트롤을 추가·이동·삭제하면 미니맵이 다시 그려집니다.
- IDE 라이트·다크 테마 색을 따르고, 마지막 도킹 위치를 기억합니다.
미니맵은 IDE 프로세스 안에서 도는 패키지에서만 됩니다. EXE에는 없습니다.
어떻게 만들었나
Windows 저수준 마우스 훅(WH_MOUSE_LL)을 씁니다. IDE 프로세스에 코드를 주입하지 않기 때문에 Delphi·C++Builder 버전이나 비트 수에 묶이지 않습니다. 커서 아래 창에서 부모를 따라 올라가 폼 디자이너 컨테이너 창(TFormContainerForm)을 찾고, 휠 이벤트를 WM_VSCROLL·WM_HSCROLL 메시지로 바꿔 보냅니다. 이 훅 코드(src/common/IDEScroll.WheelHook.pas)는 EXE와 패키지가 같이 씁니다.
알아 둘 점
- 폼 디자이너 컨테이너가
TFormContainerForm인 Delphi·C++Builder에서 동작합니다. 빌드와 검증은 Delphi 13(RAD Studio 37.0), Windows 11 Win64에서 했습니다. - 다른 버전으로 빌드하려면
build.cmd,build-bpl.cmd안의STUDIO경로를 설치된 RAD Studio에 맞게 고칩니다. - 라이선스는 MIT입니다.
소스와 빌드 가이드는 GitHub 저장소에 있습니다.