위젯 공통 기능

Sudapapa Diary의 8가지 위젯은 외관과 기능이 다르더라도 이동·크기 조정·잠금·항상 위 같은 공통 동작은 모두 동일하게 동작합니다. 이 페이지를 한 번 읽어 두면 이후 위젯별 매뉴얼에서 같은 내용을 반복해서 읽지 않아도 됩니다.

위젯 창의 기본 특성

속성	설정
프레임	없음(Frameless) — 윈도우 기본 제목줄을 표시하지 않음
투명 배경	지원 — 사용자가 투명도를 0~100% 사이로 조정 가능
작업 표시줄 노출	기본 OFF — 환경설정에서 위젯을 작업 표시줄에 표시 옵션으로 변경
위치/크기 저장	SQLite의 `SettingsStoreDB`에 위젯별로 자동 저장
다중 모니터	화면 전체 좌표 기준으로 저장 — 모니터 구성이 바뀌어도 비슷한 위치로 복원

위젯의 8방향 모서리/가장자리에 마우스를 가져가면 크기 조정 커서로 바뀝니다.

각 위젯에는 최소 크기가 정의되어 있어 그 이하로는 줄어들지 않습니다. 일부 위젯(즐겨찾기 등)은 최대 가로 폭(1920 px)이 함께 정의되어 있습니다.

위젯 우상단의 ✕ 버튼은 위젯을 삭제하지 않고 숨깁니다. 대시보드에서 다시 토글을 켜면 마지막 상태(위치·크기·테마·내용) 그대로 복원됩니다.

톱니바퀴 버튼

위젯 안에 톱니바퀴 아이콘이 있다면 그 버튼으로 설정 팝업을 엽니다.

우클릭

위젯의 빈 영역(또는 제목 영역)을 우클릭하면 컨텍스트 메뉴에서 설정을 선택할 수 있습니다.

대시보드 → 위젯 카드

대시보드에서 해당 위젯을 선택하고 미리보기 영역의 설정 열기를 누르면 됩니다.

설정 팝업은 위젯별 폴더(renderer/popups/settings/{widget-name}/)에 정의되어 있으며, 공통 탭과 위젯 고유 탭이 함께 제공됩니다.

잠금이 켜지면,

발표·녹화 직전에 잠시 위젯을 고정하고 싶을 때 유용합니다. 다시 자유롭게 옮기려면 같은 메뉴에서 잠금을 해제하세요.

위젯을 옮기거나 크기를 바꾸면 변경된 좌표·크기는 즉시 사용자 데이터 폴더의 SQLite(SettingsStoreDB)에 저장됩니다.

C:\Users\{사용자명}\AppData\Roaming\SudapapaDiary\data\

저장 키 예	의미
`widget.{widgetId}.x` / `.y`	좌표(픽셀)
`widget.{widgetId}.width` / `.height`	크기(픽셀)
`widget.{widgetId}.theme.*`	색상·투명도 등 외관
`widget.{widgetId}.locked`	잠금 여부
`widget.{widgetId}.alwaysOnTop`	항상 위 여부

다중 인스턴스 위젯(메모, 즐겨찾기)은 인스턴스 ID(memo.{instanceId}.* 등)로 저장되어 독립적으로 위치·크기·테마를 가집니다.

저장되는 좌표는 가상 데스크톱 전체 좌표계 기준입니다. 모니터 구성이 바뀌어도 가능한 한 가까운 위치로 복원되며, 화면 밖 좌표가 감지되면 안전한 영역으로 보정됩니다.

위젯이 포커스를 갖고 있을 때 사용할 수 있는 일반적인 단축키는 다음과 같습니다.

전체 단축키 목록과 위젯별 차이는 단축키 매뉴얼에서 확인할 수 있습니다.

질문	답
위젯을 닫으면 데이터도 사라지나요?	아니요. ✕는 숨기기일 뿐, 데이터는 그대로 보존됩니다.
잠금 상태에서 설정도 잠기나요?	아니요. 잠금은 이동·크기 조정만 차단합니다.
위젯을 작업 표시줄에 표시할 수 있나요?	환경설정의 위젯을 작업 표시줄에 표시 옵션으로 가능합니다.
위젯 위치를 한 번에 초기화할 수 있나요?	환경설정의 모든 위젯 위치 재설정을 사용하세요.

대시보드

위젯 관리 페이지에서 다중 인스턴스와 토글을 다룹니다.

시스템 트레이

트레이 메뉴에서 빠른 토글과 캐시 정리를 확인하세요.

개별 위젯

메모, 즐겨찾기, 통합 캘린더 등 위젯별 상세 매뉴얼.