본문 바로가기
아래아한글 자동화/pyhwpx 사용법

쉬운 용지설정 : get_pagedef_as_dict와 set_pagedef

by 일코 2024. 1. 4.

기존 오토메이션 API에서 용지설정은 복잡하진 않지만 꽤 코드가 길었다.

굳이 예전 코드를 보여드릴 필요는 없을 것.

그래서 pyhwpx에 get_pagedef_as_dict 와 set_pagedef 메서드를 추가하였는데,
사용법은 아래와 같다.

① hwp.get_pagedef_as_dict()

현재 페이지의 용지설정값을 사전 형태로 가져온다.

조회 뿐만 아니라, 이 데이터와 set_pagedef 메서드를 통해 새 페이지에 용지설정을 적용하는 것도 가능하다.

② hwp.set_pagedef(page_info)

위에서 얻은 페이지정보의 값 일부 또는 전부를 변경한 후,
set_pagedef 안에 넣고 실행하면, 변경된 용지설정이 적용된다.

단, set_pagedef의 기본값은 현재 페이지에만 적용되며,
문서 전체에 적용하고 싶으면 apply="all",
새 구역을 생성하고 싶을 때에는 apply="new" 파라미터를 추가하면 된다.
아래 움짤의 코드를 읽어보면 이해가 될 것.

마지막으로 몇 가지 TMI를 알려드리면

1. hwp.get_pagedef_as_dict() 안에 as_="eng" 파라미터를 추가하면
    사전의 키가 영문 파라미터명으로 바뀐다. (기존 한/글 오토메이션API에 익숙하신 분들)

2. hwp.get_pagedef 메서드는 dict가 아닌 파라미터셋 자체를 리턴한다.

(사용할 분들이 많지는 않겠지만)
기존 win32 오토메이션API와의 호환성을 위해서
pset 자체를 리턴하는 메서드도 만들어 두었다.

 

더 자세한 정보는 docstring이나 구현내용을 참고하기 바람.

댓글