DocumentBuilder을 사용하여 문서 요소를 삽입합니다
DocumentBuilder은 문서를 수정하는 데 사용됩니다. 이 문서에서는 여러 작업을 수행하는 방법을 설명하고 설명합니다.
텍스트 문자열 삽입
단순히DocumentBuilder.write메서드에 문서에 삽입 해야 하는 텍스트의 문자열을 전달 합니다. 텍스트 서식은Font속성에 의해 결정됩니다. 이 개체에는 다른 글꼴 속성(글꼴 이름,글꼴 크기,색상 등)이 포함되어 있습니다. 일부 중요한 글꼴 속성은DocumentBuilder속성으로 표시되므로 직접 액세스할 수 있습니다. 부울 속성Font.getBold,Font.getItalic및Font.getUnderline입니다.
다음 코드 예제에서는DocumentBuilder을 사용하여 서식이 지정된 텍스트를 삽입합니다.
단락 삽입
DocumentBuilder.또한 문서로 텍스트 문자열을 삽입하지만 단락 나누기를 추가합니다. 현재 글꼴 서식은DocumentBuilder에 의해 지정됩니다.getFont속성 및 현재 단락 서식은DocumentBuilder에 의해 결정됩니다.getParagraphFormat속성.
다음 코드 예제에서는 문서에 단락을 삽입하는 방법을 보여 줍니다.
테이블 삽입
DocumentBuilder을 사용하여 테이블을 만드는 기본 알고리즘은 간단합니다.:
- DocumentBuilder.startTable을 사용하여 테이블을 시작합니다.
- DocumentBuilder.insertCell을 사용하여 셀을 삽입합니다. 그러면 자동으로 새 행이 시작됩니다. 필요한 경우DocumentBuilder.getCellFormat속성을 사용하여 셀 서식을 지정합니다.
DocumentBuilder방법을 사용하여 셀 내용을 삽입합니다.- 행이 완료 될 때까지 2 단계와 3 단계를 반복하십시오.
- DocumentBuilder.endRow을 호출하여 현재 행을 종료합니다. 필요한 경우DocumentBuilder.RowFormat속성을 사용하여 행 서식을 지정합니다.
- 테이블이 완성될 때까지 2-5 단계를 반복합니다.
- 테이블 빌딩을 완료하려면DocumentBuilder.endTable을 호출하십시오. 적절한DocumentBuilder테이블 생성 방법은 아래에 설명되어 있습니다.
테이블 시작
DocumentBuilder을 호출합니다.startTable은 테이블을 만드는 첫 번째 단계입니다. 셀 내부에서도 호출 할 수 있습니다.이 경우 중첩 테이블을 시작합니다. 호출할 다음 메서드는DocumentBuilder입니다.insertCell.
셀 삽입
DocumentBuilder를 호출 한 후.insertCell,새 셀이 생성되고DocumentBuilder클래스의 다른 메서드를 사용하여 추가하는 모든 콘텐츠가 현재 셀에 추가됩니다. 같은 행에서 새 셀을 시작하려면DocumentBuilder를 호출합니다.insertCell다시. DocumentBuilder를 사용합니다.getCellFormat셀 서식을 지정하는 속성. 테이블 셀의 모든 서식을 나타내는getCellFormat개체를 반환합니다.
행 종료
DocumentBuilder를 호출합니다.endRow현재 행을 완료합니다. DocumentBuilder를 호출하는 경우.insertCell그 직후 테이블은 새 행에서 계속됩니다. DocumentBuilder.RowFormat속성을 사용하여 행 서식을 지정합니다. 테이블 행의 모든 서식을 나타내는RowFormat개체를 반환합니다.
테이블 종료
DocumentBuilder을 호출합니다.endTable현재 테이블을 완료합니다. 이 메서드는DocumentBuilder다음에 한 번만 호출해야 합니다.endRow호출되었습니다. 호출할 때,DocumentBuilder.endTable현재 셀에서 커서를 테이블 바로 뒤에 있는 위치로 이동합니다. 다음 예제에서는 2 개의 행과 2 개의 열이 포함된 서식이 지정된 테이블을 작성하는 방법을 보여 줍니다.
휴식 삽입
새 줄,단락,열,섹션 또는 페이지를 명시적으로 시작하려면DocumentBuilder을 호출합니다.insertBreak. BreakType열거형으로 표시되는 삽입해야 하는 나누기 형식을 이 메서드에 전달합니다.
다음 코드 예제에서는 문서에 페이지 나누기를 삽입하는 방법을 보여 줍니다.
이미지 삽입
DocumentBuilder는 인라인 또는 부동 이미지를 삽입할 수 있는DocumentBuilder.insertImage메서드의 여러 오버로드를 제공합니다. 이미지가EMF또는WMF메타파일인 경우 메타파일 형식으로 문서에 삽입됩니다. 다른 모든 이미지는PNG형식으로 저장됩니다. DocumentBuilderinsertImage방법은 다른 소스의 이미지를 사용할 수 있습니다:
- 문자열 매개 변수를 전달하여 파일 또는
URL에서 Stream매개 변수를 전달하여 스트림에서- 이미지 매개 변수를 전달하여 이미지 객체에서
- 바이트 배열 매개 변수를 전달하여 바이트 배열에서
- 및 기타
각DocumentBuilder에 대해insertImage메서드는 다음과 같은 옵션을 사용하여 이미지를 삽입 할 수 있도록 추가 오버로드가 있습니다:
- 특정 위치에서 인라인 또는 플로팅
- 백분율 가늠자 또는 주문 크기
또한,DocumentBuilder.insertImage메서드는 방금 생성되고 삽입된Shape개체를 반환하므로 셰이프의 속성을 추가로 수정할 수 있습니다.
인라인 이미지 삽입
이미지가 포함된 파일을 나타내는 단일 문자열을DocumentBuilder에 전달합니다.insertImage이미지를 인라인 그래픽으로 문서에 삽입합니다. 다음 코드 예제에서는 커서 위치에 있는 인라인 이미지를 문서에 삽입하는 방법을 보여 줍니다.
부동(절대 위치)이미지 삽입
이 예제에서는 파일 또는URL의 부동 이미지를 지정된 위치와 크기로 삽입합니다.
책갈피 삽입
문서에 책갈피를 삽입하려면 다음을 수행해야 합니다:
- 그것을 책갈피의 원하는 이름을 전달DocumentBuilder.startBookmark를 호출합니다.
DocumentBuilder방법을 사용하여 책갈피 텍스트를 삽입합니다.- DocumentBuilder.endBookmark을 호출하여DocumentBuilder에서 사용한 것과 동일한 이름을 전달합니다.startBookmark.
책갈피는 겹쳐서 모든 범위에 걸쳐 있을 수 있습니다. 유효한 책갈피를 만들려면DocumentBuilder을 모두 호출해야 합니다.startBookmark과DocumentBuilderendBookmark책갈피 이름이 동일합니다.
잘못 형성된 책갈피 또는 중복 이름을 가진 책갈피는 문서를 저장할 때 무시됩니다.
다음 코드 예제에서는 문서 작성기를 사용하여 문서에 책갈피를 삽입하는 방법을 보여 줍니다.
필드 삽입
Microsoft Word문서의 필드는 필드 코드와 필드 결과로 구성됩니다. 필드 코드는 수식과 같으며 필드 결과는 수식에서 생성하는 값입니다. 필드 코드는 또한 특정 작업을 수행하기 위한 추가 명령인 필드 스위치를 포함할 수 있습니다. 키보드 단축키 고도+F9를 사용하여Microsoft Word에서 문서의 필드 코드와 결과를 표시하는 사이를 전환할 수 있습니다. 필드 코드는 중괄호({ })사이에 나타납니다.DocumentBuilder.insertField을 사용하여 문서에 필드를 만듭니다. 필드 유형,필드 코드 및 필드 값을 지정해야합니다. 특정 필드 코드 구문에 대해 잘 모르는 경우 먼저Microsoft Word에서 필드를 만들고 해당 필드 코드를 표시하도록 전환합니다.
다음 코드 예제에서는DocumentBuilder을 사용하여 병합 필드를 문서에 삽입합니다.
Form필드 삽입
양식 필드는 사용자와의"교류"를 허용하는 단어 필드의 특정 사례입니다. Microsoft Word의 양식 필드에는 텍스트 상자,Combobox및checkbox이 포함됩니다.DocumentBuilder는DocumentBuilder.insertTextInput,DocumentBuilder.insertCheckBox및DocumentBuilder.insertComboBox의 각 양식 필드 유형을 문서에 삽입하는 특별한 방법을 제공합니다. 양식 필드의 이름을 지정하면 같은 이름으로 책갈피가 자동으로 만들어집니다.
텍스트 입력 삽입
DocumentBuilder.insertTextInput문서에 텍스트 상자를 삽입합니다. 다음 코드 예제에서는 텍스트 입력 양식 필드를 문서에 삽입하는 방법을 보여 줍니다.
CheckBox삽입
DocumentBuilder을 호출합니다.insertCheckBoxcheckbox를 문서에 삽입합니다. 다음 코드 예제에서는checkbox양식 필드를 문서에 삽입하는 방법을 보여 줍니다.
콤보 상자 삽입
DocumentBuilder을 호출합니다.insertComboBox문서에 콤보 상자를 삽입합니다. 다음 코드 예제에서는 콤보 상자 양식 필드를 문서에 삽입하는 방법을 보여 줍니다.
필드 수준에서 로캘 삽입
고객은 이제 필드 수준에서 로케일을 지정할 수 있으며 더 나은 제어를 달성 할 수 있습니다. 로캘 아이디는DocumentBuilder내의 각 필드와 연관될 수 있습니다. 아래 예제에서는 이 옵션을 사용하는 방법을 보여 줍니다.
HTML삽입
HTML조각 또는 전체HTML문서가 포함된HTML문자열을 단어 문서에 쉽게 삽입할 수 있습니다. 이 문자열을DocumentBuilder에 전달하십시오.insertHtml방법 이 방법의 유용한 구현 중 하나는 데이터베이스에HTML문자열을 저장하고Mail Merge동안 문서에 삽입하여 문서 작성기의 다양한 방법을 사용하여 작성하는 대신 포맷 된 콘텐츠를 추가하는 것입니다. 다음 코드 예제에서는DocumentBuilder을 사용하여 문서에HTML삽입을 보여 줍니다.
하이퍼링크 삽입
DocumentBuilder을 사용합니다.insertHyperlink문서에 하이퍼링크를 삽입합니다. 이 메서드는 문서에 표시할 링크의 텍스트,링크 대상(URL또는 문서 내부의 책갈피 이름)및URL가 문서 내부의 책갈피 이름인 경우 참이어야 하는 부울 매개 변수의 세 가지 매개 변수를 허용합니다.DocumentBuilder.insertHyperlink은 내부적으로DocumentBuilder을 호출합니다.insertField. 메서드는 항상URL의 시작과 끝에 아포스트로피를 추가합니다. Font속성을 사용하여 하이퍼링크 표시 텍스트의 글꼴 서식을 명시적으로 지정해야 합니다. 다음 코드 예제에서는DocumentBuilder을 사용하여 하이퍼링크를 문서에 삽입합니다.
목차 삽입
DocumentBuilder.insertTableOfContents메서드를 호출하여 현재 위치에서TOC(목차)필드를 문서에 삽입할 수 있습니다. DocumentBuilderinsertTableOfContents메서드는TOC필드 만 문서에 삽입합니다. 목차를 만들고 페이지 번호에 따라 표시하려면 필드를 삽입한 후Document.UpdateFields메서드를 모두 호출해야 합니다. 다음 코드 예제에서는 목차 필드를 문서에 삽입하는 방법을 보여 줍니다.
Ole개체 삽입
Ole개체 호출DocumentBuilder.insertOleObjectAsIcon을 원하는 경우.
Ole개체를 삽입할 때 파일 이름 및 확장명 설정
OLE패키지는OLE핸들러를 알 수없는 경우 포함 된 객체를 저장하는 레거시 및"문서화되지 않은"방법입니다. Windows 3.1,95 및 98 과 같은 초기Windows버전에는Packager.exe응용 프로그램이 있었는데,이는 문서에 모든 유형의 데이터를 포함시키는 데 사용할 수있었습니다. 이제 이 응용 프로그램은Windows에서 제외되지만MS워드 및 기타 응용 프로그램은OLE핸들러가 없거나 알 수 없는 경우 데이터를 포함하는 데 여전히 사용합니다. OlePackage클래스는OLE Package속성에 액세스 할 수 있습니다.다음 코드 예제에서는OLE Package의 파일 이름,확장명 및 표시 이름을 설정하는 방법을 보여 줍니다.
OLE개체 원시 데이터에 액세스
다음 코드 예제에서는OleFormat.GetRawData()메서드를 사용하여OLE개체 원시 데이터를 가져오는 방법을 보여 줍니다.
문서에 가로 규칙 삽입
다음 코드 예제에서는DocumentBuilder.InsertHorizontalRule메서드를 사용하여 가로 규칙 모양을 문서에 삽입하는 방법을 보여 줍니다.
도형 작업
인라인 및 자유 플로팅 도형 삽입
DocumentBuilder.InsertShape방법을 사용하여 지정된 유형 및 크기의 인라인 모양과 지정된 위치,크기 및 텍스트 줄 바꿈 유형의 자유 부동 모양을 문서에 삽입 할 수 있습니다. DocumentBuilder.InsertShape메서드를 사용하면DML도형을 문서 모델에 삽입할 수 있습니다. 문서는DML모양을 지원하는 형식으로 저장되어야 하며,그렇지 않으면 문서 저장 중에 이러한 노드가VML모양으로 변환됩니다. 다음 코드 예제에서는 이러한 형식의 도형을 문서에 삽입하는 방법을 보여 줍니다.
캡처 코너 사각형 만들기
Aspose.Words를 사용하여 캡처 모서리 사각형을 만들 수 있습니다. 모양 유형은SingleCornerSnipped, TopCornersSnipped, DiagonalCornersSnipped, TopCornersOneRoundedOneSnipped, SingleCornerRounded, TopCornersRounded, 그리고DiagonalCornersRounded DML모양은 이러한 모양 유형을 사용하여DocumentBuilder.InsertShape방법을 사용하여 만들어집니다. 이러한 유형은VML모양을 만드는 데 사용할 수 없습니다. “모양"클래스의 공용 생성자를 사용하여 모양을 만들려고 하면"NotSupportedException"예외가 발생합니다. 다음 코드 예제에서는 이러한 형식의 도형을 문서에 삽입하는 방법을 보여 줍니다.
XML을 도형으로DOM로 사용하여 도형을 가져옵니다.
LoadOptions.ConvertShapeToOfficeMath속성을 사용하여EquationXML이 있는 도형을 사무실 수학 개체로 변환할 수 있습니다. 이 속성의 기본값은MS단어 동작에 해당합니다.즉,방정식XML이 있는 모양은 사무실 수학 객체로 변환되지 않습니다.