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

델파이 폼 디자이너에서 휠로 가로·세로 스크롤 — delphi-ide-scroll

델파이 IDE 폼 디자이너에서 휠은 세로, Ctrl+휠은 가로로 스크롤하게 바꿔 주는 작은 유틸리티입니다. 큰 폼을 자주 만지는 델파이·C++Builder 개발자에게 맞습니다.

풀빛컴퓨팅3분 읽기#오픈소스#Delphi#IDE 도구#RAD Studio

화면보다 큰 폼을 델파이 폼 디자이너에서 손보다 보면 스크롤 막대를 끌고 다니는 시간이 길어집니다. 휠을 굴려도 원하는 방향으로 움직이지 않고, 가로로 넘어가려면 아래쪽 막대까지 마우스를 옮겨야 합니다.

delphi-ide-scroll(프로그램 이름은 IDEScroll)은 이 동작을 바꿉니다. 폼 디자이너 위에서 휠은 세로, Ctrl+휠은 가로로 스크롤합니다.

IDEScroll 미니맵이 RAD Studio IDE에 도킹된 모습

무엇을 하나

기능 내용
휠 세로 스크롤
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 저장소에 있습니다.

함께 읽으면 좋은 글