페이지 배경색 기본 표시를 White → Control 로 (레거시 PropertyGrid 와 일치)

페이지 루트에 BackColor 가 없을 때 내가 임의로 'White' 를 지어내 보여 주고 있었다.
페이지 루트는 WinForms UserControl 이고 그 BackColor 기본값은 SystemColors.Control 이라
레거시 PropertyGrid 는 'Control' 을 표시한다 — 사용자가 짚은 그대로다.

근거를 위해 --db-pageprops 진단을 신설해 전수 집계했다(디자인 1,271건 / 페이지 1,816장).

  BackColor  White 1,487장(81.9%) · (없음) 230장(12.7%) · Window 91장(5.0%)
             ButtonHighlight/ControlLightLight/MenuBar/Control/ControlLight 8장
  Font       (없음) 95.6% — 없을 때 굴림 9pt 로 보이는 현행 기본값이 맞다
  기타 키     Margin 9장, BorderStyle 6장, DoNotPrintThisPage 2장 …

12.7% 는 예외가 아니라 흔한 경우다. 표시만 고치고 저장은 하지 않는다 — 지어낸 값이 XML 에
새로 생기면 왕복 diff 0 이 조용히 깨진다. 이 규약을 두 겹으로 못 박았다.
- 편집 스모크: 값 없는 페이지에서 Control 표시 / 미저장 / 용지는 흰색
- --db-pageprops: BackColor 없는 실제 서식 40건을 열어 XML 이 그대로인지 대조

렌더는 흰색을 유지한다. 사용자 확인 결과 레거시 실행 시에도 흰색으로 나오고,
#F0F0F0 종이는 라이트 테마 캔버스 배경(#D8D8D8)과 1.13:1 이라 용지 경계가 사라진다.
대신 값이 없을 때는 라벨 툴팁으로 '저장된 값 없음 / 실행·인쇄는 흰색 / 바꾸면 그때 저장'을
알린다 — 안 그러면 "Control 인데 왜 희게 보이지?" 로 다시 읽힌다.

부수: PropertyRowViewModel 에 Hint 를 추가하고 색상 행 라벨 툴팁에 배선.

회귀: 테스트 124/124, 편집 스모크 실패 0, DB 왕복 1,271건 diff 0/예외 0,
종이 렌더 P062 바이트 동일.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Msystech
2026-08-13 10:44:52 +09:00
co-authored by Claude Opus 5
parent 38093691ad
commit ac36f93a03
6 changed files with 180 additions and 5 deletions
+123
View File
@@ -104,6 +104,129 @@ public static class DbSmoke
/// 권한 게이트 영향 범위(--db-gate) — ShtUsrDesYon 값별 서식 수를 집계한다.
/// 게이트 도입 전에 "갑자기 서식이 안 열린다"는 문의 규모를 미리 알기 위한 읽기 전용 진단.
/// </summary>
/// <summary>
/// 페이지 루트(MDesignerHost) 속성 전수 집계 — 페이지 속성 편집기의 기본값 근거.
///
/// 레거시 PropertyGrid 는 <b>속성이 없으면 WinForms 기본값</b>을 보여 준다(BackColor 는 Control).
/// 우리가 어떤 키를 얼마나 마주치는지, 어떤 값이 실제로 쓰이는지 알아야 기본 표시를 정할 수 있다.
/// </summary>
public static int RunPagePropsReport(string reportPath)
{
var lines = new List<string>();
try
{
var config = ConfigService.Current;
var store = new OracleLegacyFormStore(config.ConnectionString);
var serializer = new LegacyXmlSerializer();
var sheets = store.ListSheets(null, max: 3000).Where(s => s.HasDesign).ToList();
var keyCounts = new Dictionary<string, int>(StringComparer.Ordinal);
var backColors = new Dictionary<string, int>(StringComparer.Ordinal);
var fonts = new Dictionary<string, int>(StringComparer.Ordinal);
var pages = 0;
var docs = 0;
foreach (var sheet in sheets)
{
try
{
var raw = store.LoadActiveDesignRaw(sheet.ShtCod);
if (raw is null)
{
continue;
}
docs++;
foreach (var page in serializer.Read(raw.Value.Xml).Pages)
{
pages++;
foreach (var key in page.Root.Props.Keys)
{
keyCounts[key] = keyCounts.GetValueOrDefault(key) + 1;
}
var back = page.Root.Props.GetText("BackColor") ?? "(없음)";
backColors[back] = backColors.GetValueOrDefault(back) + 1;
var font = page.Root.Props.GetText("Font") ?? "(없음)";
fonts[font] = fonts.GetValueOrDefault(font) + 1;
}
}
catch (Exception ex)
{
lines.Add($" 실패 {sheet.ShtCod}: {ex.Message}");
}
}
// 속성 패널을 '여는 것만으로' 문서가 바뀌면 안 된다.
// 값이 없는 페이지에 기본값을 지어내 저장해 버리면 왕복 diff 0 이 조용히 깨진다.
var mutated = new List<string>();
var checkedDocs = 0;
foreach (var sheet in sheets)
{
if (checkedDocs >= 40)
{
break;
}
try
{
var raw = store.LoadActiveDesignRaw(sheet.ShtCod);
if (raw is null)
{
continue;
}
var document = serializer.Read(raw.Value.Xml);
// 값이 없는 페이지를 가진 서식만 본다 — 지어낸 값이 생기는지가 관심사다
if (!document.Pages.Any(p => p.Root.Props.GetText("BackColor") is null))
{
continue;
}
checkedDocs++;
var before = serializer.Write(document);
var designer = new ViewModels.DesignerViewModel(document);
designer.ActivatePage(designer.Pages[0]);
var after = serializer.Write(designer.Document);
if (!string.Equals(before, after, StringComparison.Ordinal))
{
mutated.Add($" {sheet.ShtCod} {sheet.Name}");
}
}
catch (Exception ex)
{
mutated.Add($" {sheet.ShtCod} 예외: {ex.Message}");
}
}
lines.Insert(0, mutated.Count == 0
? $"[열기 무변경] BackColor 없는 서식 {checkedDocs}건 — 속성 패널을 열어도 XML 동일"
: $"[열기 변경 발생] {mutated.Count}건 — 아래 서식은 여는 것만으로 XML 이 바뀐다");
lines.InsertRange(1, mutated);
lines.Insert(mutated.Count + 1, string.Empty);
lines.Insert(0, $"디자인 {docs}건 / 페이지 {pages}장");
lines.Add(string.Empty);
lines.Add("[페이지 루트 속성 키 분포]");
foreach (var (key, count) in keyCounts.OrderByDescending(p => p.Value))
{
lines.Add($" {key,-24} {count,6}장 ({count * 100.0 / Math.Max(1, pages):0.0}%)");
}
lines.Add(string.Empty);
lines.Add("[BackColor 값 분포]");
foreach (var (value, count) in backColors.OrderByDescending(p => p.Value))
{
lines.Add($" {value,-24} {count,6}장 ({count * 100.0 / Math.Max(1, pages):0.0}%)");
}
lines.Add(string.Empty);
lines.Add("[Font 값 분포]");
foreach (var (value, count) in fonts.OrderByDescending(p => p.Value).Take(15))
{
lines.Add($" {value,-30} {count,6}장 ({count * 100.0 / Math.Max(1, pages):0.0}%)");
}
}
catch (Exception ex)
{
lines.Add($"예외: {ex}");
}
File.WriteAllLines(reportPath, lines);
return 0;
}
public static int RunGateReport(string reportPath)
{
try