대한민국 공교육 행정과 국방 공문서 100% 무인화: ZeliOffice의 한글(HWP 2024) 14종 신규 COM 매크로(누름틀·동적 표·하이퍼링크·서식) 심층 오케스트레이션 아키텍처

// ── 누름틀 존재 확인 ──
private bool HwpFieldExist(OfficeAppEntry app, string fieldName)
{
    if (app?.ComInstance == null) return false;
    try
    {
        dynamic hwp = app.ComInstance;
        bool exists = hwp.FieldExist(fieldName);
        AppendLog(string.Format(Loc.Get("OfficeH_FieldExist"), fieldName, exists));
        return exists;
    }
    catch (Exception ex)
    {
        AppendLog(string.Format(Loc.Get("OfficeH_FieldExistFailed"), ex.Message));
        return false;
    }
}

// ── 특정 누름틀로 캐럿 이동 및 내용 선택 ──
private void HwpMoveToField(OfficeAppEntry app, string fieldName, bool select)
{
    if (app?.ComInstance == null) return;
    try
    {
        dynamic hwp = app.ComInstance;
        // MoveToField(필드명, 텍스트여부=true, 번호=true, 블록선택=select)
        hwp.MoveToField(fieldName, true, true, select);
        AppendLog(string.Format(Loc.Get("OfficeH_MoveToField"), fieldName, select ? "(선택)" : ""));
    }
    catch (Exception ex)
    {
        AppendLog(string.Format(Loc.Get("OfficeH_MoveToFieldFailed"), ex.Message));
    }
}

// ── 문서 내 모든 누름틀 목록 조회 (AI Self-Discovery) ──
private string HwpGetFieldList(OfficeAppEntry app)
{
    if (app?.ComInstance == null) return "(COM 없음)";
    try
    {
        dynamic hwp = app.ComInstance;
        string list = hwp.GetFieldList(); // 콤마로 구분된 전체 필드 목록 반환
        return list ?? "(필드 없음)";
    }
    catch (Exception ex)
    {
        return $"(조회 실패: {ex.Message})";
    }
}

// ── 표 행 추가 (위/아래 방향 자동 분기) ──
private void HwpTableInsertRow(OfficeAppEntry app, string direction)
{
    if (app?.ComInstance == null) return;
    try
    {
        dynamic hwp = app.ComInstance;
        // direction에 따른 액션명 결정
        string actionName = direction == "above" ? "TableInsertRowAbove" : "TableAppendRow";
        hwp.HAction.Run(actionName);
        AppendLog(string.Format(Loc.Get("OfficeH_TableInsertRow"), direction));
        UpdateStatus(string.Format(Loc.Get("OfficeH_TableInsertRowStatus"), direction));
    }
    catch (Exception ex)
    {
        AppendLog(string.Format(Loc.Get("OfficeH_TableInsertRowFailed"), ex.Message));
    }
}

// ── 표 열 추가 (왼쪽/오른쪽 방향 자동 분기) ──
private void HwpTableInsertCol(OfficeAppEntry app, string direction)
{
    if (app?.ComInstance == null) return;
    try
    {
        dynamic hwp = app.ComInstance;
        string actionName = direction == "left" ? "TableInsertColBegin" : "TableAppendCol";
        hwp.HAction.Run(actionName);
        AppendLog(string.Format(Loc.Get("OfficeH_TableInsertCol"), direction));
    }
    catch (Exception ex)
    {
        AppendLog(string.Format(Loc.Get("OfficeH_TableInsertColFailed"), ex.Message));
    }
}

// ── 표 셀 병합 ──
private void HwpTableMergeCell(OfficeAppEntry app)
{
    if (app?.ComInstance == null) return;
    try
    {
        dynamic hwp = app.ComInstance;
        hwp.HAction.Run("TableMergeCell"); // 블록 선택된 복수 셀 병합
        AppendLog(Loc.Get("OfficeH_TableMergeCell"));
    }
    catch (Exception ex)
    {
        AppendLog(string.Format(Loc.Get("OfficeH_TableMergeCellFailed"), ex.Message));
    }
}

// ── 하이퍼링크 객체 생성 ──
private void HwpInsertHyperlink(OfficeAppEntry app, string url, string text)
{
    if (app?.ComInstance == null) return;
    try
    {
        dynamic hwp = app.ComInstance;
        // 1. 하이퍼링크 파라미터셋 기본값 취득
        hwp.HAction.GetDefault("InsertHyperlink", hwp.HParameterSet.HHyperLink.HSet);
        
        // 2. 웹 URL(Type=1) 및 텍스트 바인딩
        hwp.HParameterSet.HHyperLink.Type = 1; 
        hwp.HParameterSet.HHyperLink.URL = url;
        if (!string.IsNullOrEmpty(text))
            hwp.HParameterSet.HHyperLink.Text = text;

        // 3. 액션 원자적 실행
        hwp.HAction.Execute("InsertHyperlink", hwp.HParameterSet.HHyperLink.HSet);
        AppendLog(string.Format(Loc.Get("OfficeH_Hyperlink"), url));
    }
    catch (Exception ex)
    {
        AppendLog(string.Format(Loc.Get("OfficeH_HyperlinkFailed"), ex.Message));
    }
}

// ── 공문서 개조식 글머리 기호 & 법정 번호 매기기 ──
private void HwpSetBullet(OfficeAppEntry app) => hwp.HAction.Run("Bullet");
private void HwpSetNumbering(OfficeAppEntry app) => hwp.HAction.Run("ParaNum");