! 제품 버전을 정확하게 입력해 주세요.
제품 버전이 정확하게 기재되어 있지 않은 경우,
최신 버전을 기준으로 안내 드리므로
더욱 빠르고 명확한 안내를 위해
제품 버전을 정확하게 입력해 주세요!

PDF 내보내기 시 한글이 깨지는 경우 (글꼴 폴더 경로 설정) > FAQ

본문 바로가기

Java & Kotlin API

FAQ

제품설치 및 실행 PDF 내보내기 시 한글이 깨지는 경우 (글꼴 폴더 경로 설정)

페이지 정보

작성자 MESCIUS루카스 작성일 2023-11-24 11:02 조회 74회 댓글 0건

본문

* GcExcel Java가 2023년 11월 1일부터  DsExcel Java 로 변경되었습니다. DsExcel Java와 GcExcel Java는 동일한 제품임을 안내 드립니다. 


DsExcel은 엑셀 내보내기뿐 아니라 PDF 내보내기 기능도 지원하고 있습니다.


이때 한글이 종종 깨지는 현상이 발생하는 경우가 있습니다.


이번 글에서는 PDF 내보내기 시 한글이 깨졌을 때에 대한 해결 방법을 안내합니다.



1. 한글 글꼴 설치 여부 확인


가장 먼저 한글 글꼴이 해당 머신에 설치 되어 있는지를 확인합니다.


PDF의 한글을 정상적으로 표현하기 위해서는 한글 글꼴이 머신에 필수적으로 설치되어 있어야 합니다.



2. 글꼴 설치 경로 지정


한글 글꼴이 설치되어 있다면, 글꼴이 설치된 경로를 지정합니다.


Windows OS에서는 글꼴의 폴더 경로를 지정하지 않고 내보내기 하는 경우에는 기본 폴더 경로(C:\Windows\Fonts)가 설정됩니다. 


그 외 OS는 글꼴이 설치된 폴더 경로를 반드시 설정해 주어야 합니다.


IWorkbook 인터페이스getUsedFonts() 메소드를 사용하여 통합 문서에 사용된 모든 글꼴 컬렉션을 가지고 올 수 있습니다.


PDF 파일로 내보내는 동안 DsExcel Java는 PDF를 렌더링하기 위해 Workbook.FontsFolderPath에 지정된 글꼴을 사용합니다. 


그러나 통합문서에 사용된 글꼴이 지정한 경로에 없을 경우에는 일부 대체 글꼴을 사용하게 됩니다. 


대체 글꼴이 없는 경우에는,

"사용 가능한 글꼴이 없습니다. 통합 문서의 FontsFolderPath 메소드에 유효한 경로를 설정하십시오!" 혹은 "There are no available fonts. Please set a valid path to the FontsFolderPath method of the Workbook!" 라는 예외가 발생합니다.
 


아래 샘플 코드를 사용하여 글꼴 폴더 경로를 설정해 보시길 바랍니다.

// 새 워크북 생성 및 워크시트 추가
Workbook workbook = new Workbook();
IWorksheet sheet1 = workbook.getWorksheets().get(0);
IWorksheet sheet2 = workbook.getWorksheets().add();
 
// 스타일 설정
sheet1.getRange("A1").setValue("Sheet1");
sheet1.getRange("A1").getFont().setName("Malgun Gothic");
sheet1.getRange("A1").getFont().setColor(Color.GetRed());
sheet1.getRange("A1").getInterior().setColor(Color.GetGreen());
 
// 테이블 추가
ITable table = sheet1.getTables().add(sheet1.getRange("C1:E5"), true);
sheet2.getRange("A1").setValue("Sheet2");
 
// 글꼴 경로 지정
Workbook.FontsFolderPath = "C:\\Users\\GPCTAdmin\\Documents\\Fonts";
 
// 워크북에서 사용한 글꼴 목록을 가져옵니다. 목록은 "Malgun Gothic", "Calibri"입니다
List<FontInfo> fonts = workbook.getUsedFonts(); // PDF 파일로 저장 workbook.save("configureFontsAndSetStyle.pdf", SaveFileFormat.Pdf); // sheet1만 pdf 파일로 저장 sheet1.save("configureFontsAndSetStyle_sheet.pdf",SaveFileFormat.Pdf);



감사합니다.


  

지금 바로 DsExcel Java를 다운로드하여 직접 테스트해보세요!

dsexcel-java.png

 
  • 페이스북으로 공유
  • 트위터로  공유
  • 링크 복사
  • 카카오톡으로 보내기

댓글목록

등록된 댓글이 없습니다.

메시어스 홈페이지를 통해 제품에 대해서 더 자세히 알아 보세요!
홈페이지 바로가기

인기글

더보기
  • 인기 게시물이 없습니다.
메시어스 홈페이지를 통해 제품에 대해서 더 자세히 알아 보세요!
홈페이지 바로가기
이메일 : sales-kor@mescius.com | 전화 : 1670-0583 | 경기도 과천시 과천대로 7길 33, 디테크타워 B동 1107호 메시어스(주) 대표자 : 허경명 | 사업자등록번호 : 123-84-00981 | 통신판매업신고번호 : 2013-경기안양-00331 ⓒ 2024 MESCIUS inc. All rights reserved.