SumatraPDF 검색 입력 자동 실행 제어 옵션 추가 계획

목표

검색 입력창(Find)에서 타이핑할 때마다 자동 검색이 실행되는 현재 동작을 옵션화하여, 옵션이 꺼져 있을 때는 Enter(또는 F3/Shift+F3) 로만 검색이 실행되게 한다.

• 기본 문제: 한글 IME 조합 중간 상태에서도 EN_UPDATE가 발생하여 무의미한 검색 스레드가 반복 실행됨
• 기대 효과: 불필요한 검색 요청 감소, IME 사용자(특히 한글) 사용성 개선

---

현재 코드 동작 분석

1) 타이핑 시 자동 검색 트리거 위치

• src/Toolbar.cpp:546 부근 WndProcToolbar()
• WM_COMMAND + EN_UPDATE + hEdit == win->hwndFindEdit 조건에서:
  • Edit_GetModify()가 true이면
  • FindTextOnThread(win, TextSearch::Direction::Forward, false) 호출
• 핵심 라인: src/Toolbar.cpp:550, src/Toolbar.cpp:553

즉, 자동 검색은 툴바 Edit 컨트롤의 EN_UPDATE 처리로 구현되어 있음.

2) Enter/F3 검색 경로

• Enter 처리: src/Toolbar.cpp:606 (WndProcEditSearch, WM_CHAR, VK_RETURN)
  • Shift+Enter → FindPrev(win)
  • Enter → FindNext(win)
• F3 처리: src/Toolbar.cpp:632 (WM_KEYDOWN, VK_F3)
• 최종 검색 실행은 src/SearchAndDDE.cpp:467 오버로드 FindTextOnThread(win, direction, showProgress) 경유
  • 여기서 Edit_GetModify() 기반으로 신규 검색/다음 검색 구분

즉, 자동검색을 끄더라도 Enter/F3 기반 검색은 기존 구조로 자연스럽게 유지 가능.

3) 설정(Advanced options) 정의 위치

• 이 코드베이스는 설정을 직접 Settings.h에 추가하지 않고 생성 스크립트에서 정의:
  • cmd/gen-settings.ts (프로젝트 규칙: agents.md:19-24)
• 현재 ShowToolbar 등 GlobalPrefs 필드가 cmd/gen-settings.ts:660+ 영역에서 정의됨
• 생성 결과물:
  • src/Settings.h
  • 문서(고급 설정 관련 마크다운/웹 문서 일부)

---

구현 계획

1. 새 고급 설정 추가

cmd/gen-settings.ts의 GlobalPrefs 필드 목록에 bool 설정 추가:

• 제안 이름: FindAsYouType
• 타입/기본값: Bool, true (기존 동작 유지)
• 설명 코멘트(예시):
  • "if true, typing in find box triggers search automatically; if false, search runs only on Enter/F3"

왜 기본값 true인가: - 기존 사용자 동작을 깨지 않음 (하위 호환) - IME 사용자/원하는 사용자만 명시적으로 끌 수 있음

대안: 기본값을 false로 둘 수도 있으나 기존 UX 변화 폭이 크므로 비권장.

---

2. 설정 코드 생성 반영

아래를 실행해 생성물 갱신:

• bun cmd/gen-settings.ts

예상 반영 파일: - src/Settings.h (GlobalPrefs struct + metadata) - 고급 설정 문서 파일(생성 스크립트가 관리하는 문서)

주의: - 생성 파일을 수동 편집하지 않고 스크립트로 갱신해야 일관성 유지.

---

3. 자동 검색 분기 조건에 옵션 반영

src/Toolbar.cpp의 자동검색 조건(EN_UPDATE)에 새 옵션 체크 추가:

현재(개념): - ... && gGlobalPrefs->showToolbar

변경 후(개념): - ... && gGlobalPrefs->showToolbar && gGlobalPrefs->findAsYouType

실제 적용 위치: - src/Toolbar.cpp:550 조건문 - 검색 실행 호출부는 그대로 유지 (FindTextOnThread(..., false))

효과: - FindAsYouType = false일 때 IME 조합 중 EN_UPDATE가 와도 자동 검색 미실행 - Enter/F3 검색 경로는 그대로 동작

---

4. 동작 검증 계획

기능 검증

1. FindAsYouType = true
   • 영어 입력 시 기존처럼 자동 검색되는지
   • Enter/F3도 정상 동작하는지
2. FindAsYouType = false
   • 타이핑 중 검색이 실행되지 않는지
   • Enter로 검색 실행되는지
   • Shift+Enter, F3/Shift+F3로 다음/이전 검색 정상인지
3. 한글 IME 테스트
   • 조합 중(미완성) 입력에서 불필요 검색이 발생하지 않는지
   • 조합 완료 후 Enter 시 정상 검색되는지

회귀 검증

• Ctrl+F 후 포커스 이동/찾기 박스 동작 회귀 여부
• 탭 전환 후 검색어 유지 및 수정 플래그 처리(SearchAndDDE.cpp:471+) 이상 여부

빌드 검증

• bun ./cmd/build.ts 로 컴파일 확인

---

5. 문서/릴리즈 노트 반영(권장)

옵션이 사용자 노출되는 고급 설정이므로 다음 반영 권장:

• docs/md/Version-history.md의 next 섹션에 항목 추가
  • 예: “add FindAsYouType advanced setting to disable auto-search while typing in find box”

(고급 설정 본문 문서는 gen-settings.ts 생성물로 자동 반영될 가능성이 큼)

---

변경 파일 예상 목록

• cmd/gen-settings.ts (새 설정 정의)
• src/Toolbar.cpp (자동 검색 조건 분기)
• src/Settings.h (생성 결과)
• (생성 스크립트가 갱신하는 설정 문서 파일들)
• docs/md/Version-history.md (수동 반영 시)

---

리스크 및 대응

• 리스크: 옵션 기본값을 false로 두면 기존 UX가 크게 바뀜
  • 대응: 기본값 true 유지
• 리스크: 생성 파일 수동 편집 시 추후 재생성에서 충돌
  • 대응: 반드시 cmd/gen-settings.ts에서 원천 정의 후 생성
• 리스크: Enter 전용 검색에서 일부 사용자가 “반응 없음”으로 오해 가능
  • 대응: 설정 설명 문구를 명확히 작성

---

완료 기준 (Definition of Done)

• FindAsYouType 고급 설정이 설정 파일/문서에 노출됨
• FindAsYouType=false에서 타이핑 자동 검색이 발생하지 않음
• Enter/F3 기반 검색은 기존처럼 정상 작동
• 빌드 성공 및 기본 검색 기능 회귀 없음