Microsoft Word 커넥터 메서드

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 소요 시간: 12분

    • Microsoft Word 커넥터 메서드를 사용하면 Microsoft Word 문서로 다양한 일상적인 작업을 수행하고 자동화할 수 있습니다. 예를 들어 페이지 바닥글을 추가합니다.

    오픈

    로컬 디스크에 Microsoft 저장된 Word 파일을 엽니다.
    주:
    Microsoft Word 커넥터에서 다른 메서드를 실행하기 전에 이 메서드를 실행해야 합니다.
    표 1. Open 메서드 매개변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    파일 경로 로컬 디스크에 있는 Word 파일의 경로를 Microsoft 지정합니다. 의 데이터 문자열 기본값 없음 예
    시간 제한 작업 시간이 초과되는 시간을 지정합니다. 의 데이터 정수 기본값 없음 아니요
    암호 문서가 암호로 보호되어 있는 경우 암호를 사용합니다. 의 데이터 문자열 없음 아니요
    반환 운영 결과에 따라 부울 값을 반환합니다. True이면 파일이 열립니다. 그렇지 않고 False인 경우 파일을 열지 못했습니다. 데이터 출력 부울 해당 사항 없음 해당 사항 없음

    Open 메서드와 관련된 문제에 대한 자세한 내용은 KB 문서 KB1123558 및 KB 문서 KB1123548를 참조하세요.

    AddFooter (영문)

    지정된 글꼴 크기로 Word 문서에 바닥글을 Microsoft 추가합니다.

    이 메서드를 사용하려면 Text 매개 변수에 추가할 텍스트와 바닥글 텍스트를 표시해야 하는 글꼴 크기를 FontSize 매개 변수에 제공합니다. FontSize 매개 변수의 기본값은 12입니다.

    주:
    이 메서드를 실행하기 전에 Open 메서드를 실행해야 합니다.
    표 2. AddFooter 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형
    텍스트 바닥글의 텍스트를 지정합니다. 의 데이터 문자열
    글꼴 크기 바닥글에 있는 텍스트의 글꼴 크기를 지정합니다. 기본값은 12입니다. 의 데이터 정수

    입력을 제공하려면 다음을 참조하십시오. 포트 속성 구성

    AddHeader (헤더 추가)

    지정된 글꼴 크기로 Word 문서에 헤더를 Microsoft 추가합니다.

    이 메서드를 사용하려면 Text 매개 변수에 추가할 텍스트와 FontSize 매개 변수에 헤더 텍스트를 표시해야 하는 글꼴 크기를 제공합니다. FontSize 매개 변수의 기본값은 12입니다.

    주:
    이 메서드를 실행하기 전에 Open 메서드를 실행해야 합니다.
    표 3. AddHeader 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형
    텍스트 머리글의 텍스트를 지정합니다. 의 데이터 문자열
    글꼴 크기 머리글에 있는 텍스트의 글꼴 크기를 지정합니다. 기본값은 12입니다. 의 데이터 정수

    셀카피

    문서에서 테이블의 행 인덱스와 열 인덱스를 사용하여 식별된 테이블 셀의 내용을 복사합니다 Microsoft 단어 .

    이 메서드를 사용하려면 RowIndex 매개 변수에 행 인덱스를 제공하고 ColumnIndex 매개 변수에 열 인덱스를 제공합니다. RowIndex 및 ColumnIndex의 기본값은 각각 -1입니다.

    주:
    이 메서드를 실행하기 전에 SetTable 메서드를 실행해야 합니다.
    표 4. CellCopy 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형
    행 인덱스 복사해야 하는 셀 행의 인덱스입니다. 행 인덱스 값은 0보다 크거나 같아야 합니다. 기본값은 -1이며, 이는 사용할 수 있는 셀이 없음을 의미합니다. 의 데이터 정수
    열 인덱스 복사해야 하는 셀의 열 인덱스입니다. 열 인덱스는 0보다 크거나 같아야 합니다. 기본값은 -1이며 이는 사용할 수 있는 셀이 없음을 의미합니다. 의 데이터 정수

    셀페이스트

    복사한 테이블 셀 내용을 문서에 있는 테이블의 행 인덱스와 열 인덱스를 사용하여 식별된 테이블 셀에 Microsoft 단어 붙여넣습니다.

    이 메서드를 사용하려면 RowIndex 매개 변수에 행 인덱스를 제공하고 ColumnIndex 매개 변수에 열 인덱스를 제공합니다. RowIndex 및 ColumnIndex의 기본값은 각각 -1입니다.

    주:
    이 메서드를 실행하기 전에 CellCopy 메서드를 실행해야 합니다.
    표 5. CellPaste 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형
    행 인덱스 데이터를 붙여 넣어야 하는 셀의 행 인덱스입니다. 행 인덱스 값은 0보다 크거나 같아야 합니다. 기본값은 -1이며, 이는 데이터를 붙여 넣을 수 있는 행이 없음을 의미합니다. 의 데이터 정수
    열 인덱스 데이터를 붙여 넣어야 하는 셀의 열 인덱스입니다. 열 인덱스는 0보다 크거나 같아야 합니다. 기본값은 -1이며, 이는 데이터를 붙여 넣을 수 있는 열이 없음을 의미합니다. 의 데이터 정수

    닫기

    마지막으로 열었던 Microsoft 단어 문서를 닫습니다. 문서를 닫는 동안 변경 사항을 저장하는 것은 선택 사항입니다.

    단어 문서에 대한 수정 사항을 저장해야 하는 경우 saveChanges 부울 매개 변수를 True로 설정하고, 그렇지 않으면 False로 설정합니다. 기본적으로 saveChanges 부울 매개 변수는 True로 설정됩니다.

    주:
    이 메서드를 실행하기 전에 Open 메서드를 실행해야 합니다.
    표 6. Close 메서드 매개변수
    매개변수 설명 데이터 포트 유형 데이터 유형
    변경 내용 저장 닫기 전에 Word 문서에서 변경한 내용을 저장할지 여부를 지정합니다. 기본적으로 True로 설정되어 있으며, 이는 변경 내용이 닫히기 전에 저장됨을 의미합니다. 닫기 전에 변경 내용을 저장할 필요가 없는 경우 False로 설정합니다. 의 데이터 부울

    DeleteColumn입니다.

    문서 내 열의 지정된 인덱스 Microsoft 단어 값을 기준으로 테이블에서 열을 삭제합니다.

    이 메서드를 사용하려면 삭제해야 하는 열의 인덱스를 ColumnIndex 매개 변수에 제공합니다. 기본값은 -1입니다.

    주:
    이 메서드를 실행하기 전에 SetTable 메서드를 실행해야 합니다.
    표 7. DeleteColumn 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형
    열 인덱스 삭제해야 하는 열의 인덱스입니다. 열 인덱스는 0보다 크거나 같아야 합니다. 기본값은 -1이며, 이는 삭제할 수 있는 열이 없음을 의미합니다. 의 데이터 정수

    삭제 페이지

    문서에서 지정된 인덱스 값을 Microsoft 단어 기준으로 페이지를 삭제합니다.

    이 메서드를 사용하려면 삭제해야 하는 페이지의 인덱스 값을 PageIndex 매개 변수에 제공합니다.

    주:
    이 메서드를 실행하기 전에 Open 메서드를 실행해야 합니다.
    표 8. DeletePage 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형
    페이지인덱스 제거하거나 삭제해야 하는 페이지의 색인 번호를 지정합니다.

    인덱스 번호를 제공하지 않으면 메서드는 기본적으로 첫 번째 페이지를 삭제합니다.

    		 의 데이터 정수

    행 삭제(DeleteRow)

    문서의 테이블에서 지정된 인덱스 값을 기준으로 행을 Microsoft 단어 삭제합니다.

    이 메서드를 사용하려면 삭제해야 하는 행의 인덱스를 RowIndex 매개 변수에 제공합니다. 기본값은 -1입니다.

    주:
    이 메서드를 실행하기 전에 SetTable 메서드를 실행해야 합니다.
    표 9. DeleteRow 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형
    행 인덱스 삭제해야 하는 행의 인덱스입니다. 행 인덱스 값은 0보다 크거나 같아야 합니다. 기본값은 -1이며, 이는 삭제할 수 있는 행이 없음을 의미합니다. 의 데이터 정수

    DeleteTable

    문서에서 테이블을 Microsoft 단어 삭제합니다.

    문서에 여러 테이블이 있는 경우 메서드는 문서의 첫 번째 테이블을 삭제합니다.

    주:
    이 메서드를 실행하기 전에 SetTable 메서드를 실행해야 합니다.

    PDF로 익스포트

    문서를 PDF 문서로 내보냅니다 Microsoft 단어 .
    주:
    이 메서드를 실행하기 전에 Open 메서드를 실행해야 합니다.
    표 10. ExportToPDF 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    파일 경로 Word 문서를 PDF로 내보내는 위치의 경로를 지정합니다. 의 데이터 문자열 기본값 없음 예

    찾기

    문서에서 지정한 Microsoft 단어 텍스트를 찾고 부울 응답을 반환합니다.
    입력
    텍스트
    출력
    반환(부울)

    GetCellValueByIndex (영문)

    문서에 있는 테이블의 Microsoft 단어 셀에 있는 값을 반환합니다.
    입력
    셀인덱스

    GetFooterText (푸터텍스트 가져오기)

    문서에서 바닥글 Microsoft 단어 의 내용을 반환합니다.

    주:
    이 메서드를 실행하기 전에 Open 메서드를 실행해야 합니다.
    출력
    return(문자열)

    GetHeaderText

    문서에서 헤더 Microsoft 단어 의 내용을 반환합니다.

    주:
    이 메서드를 실행하기 전에 Open 메서드를 실행해야 합니다.
    출력
    return(문자열)

    페이지 수 가져오기

    문서의 페이지 Microsoft 단어 수를 반환합니다.

    출력
    반환(정수)

    GetRowIndexByValue (영문)

    행의 값을 기준으로 행의 행 인덱스 값을 반환합니다.
    주:
    이 메서드를 실행하기 전에 GetTable 및 SetTable 메서드를 실행해야 합니다.
    입력
    테이블, 값

    GetTable

    Word 문서의 테이블에 Microsoft 있는 데이터를 테이블 객체 및 데이터 테이블로 반환합니다. 문서에 여러 테이블이 포함되어 있는 경우 테이블 인덱스를 지정하여 메서드의 테이블을 식별할 수 있습니다. 필요한 경우 테이블 유형을 지정할 수도 있습니다.

    테이블 구조에 따라 메서드의 테이블 유형을 선택적으로 구성할 수 있습니다. 테이블을 구성하려면 다음 단계를 수행합니다.
    1. 방법 설정 아이콘( 방법 설정 아이콘. )을 클릭합니다.
    2. 테이블 유형을 선택합니다.
    3. 확인을 클릭합니다.
    입력
    TableIndex, FirstRowIsHeader
    출력
    테이블(객체)
    데이터(DataTable)

    GetTableCellValues (영문)

    하나 이상의 테이블 셀에 값을 반환합니다.

    셀 수를 지정하려면 셀의 인덱스 값을 구성해야 합니다. 구성하려면 다음을 수행합니다.
    1. 방법 설정 아이콘( 방법 설정 아이콘. )을 클릭합니다.
    2. 클릭( 셀 인덱스를 추가하려면 클릭 아이콘.).
    3. 셀의 인덱스 값을 입력합니다.
    4. 이 단계를 반복하여 인덱스 값을 더 추가합니다.
    5. 확인을 클릭합니다.
    출력
    셀 인덱스(객체)

    GetTableCount (영문)

    문서의 테이블 Microsoft 단어 수를 반환합니다. 식별할 메서드에 대한 테이블 유형을 선택적으로 지정할 수 있습니다.

    테이블 유형을 구성하려면 다음 단계를 수행합니다.
    1. 방법 설정 아이콘( 방법 설정 아이콘. )을 클릭합니다.
    2. 테이블 유형을 선택합니다.
    3. 확인을 클릭합니다.
    출력
    반환(정수)

    GetTableRowData 가져오기

    Word 문서에 있는 행의 하나 이상의 셀에 Microsoft 있는 값을 반환합니다. 행 셀의 인덱스 값을 지정할 수 있습니다.

    행에 있는 셀의 인덱스 값을 구성할 수 있습니다. 구성하려면 다음 단계를 수행합니다.
    1. 방법 설정 아이콘( 방법 설정 아이콘. )을 클릭합니다.
    2. 인덱스 값 추가 아이콘( 인덱스 값 추가 아이콘. )을 클릭합니다.
    3. 셀의 인덱스 값을 입력합니다.
    4. 이 단계를 반복하여 인덱스 값을 더 추가합니다.
    5. 확인을 클릭합니다.
    출력
    행 인덱스(객체)

    텍스트 가져오기

    Word 문서의 모든 텍스트 내용을 Microsoft 반환합니다.

    표 11. GetText 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    반환 Word 문서에서 텍스트를 반환합니다. 데이터 출력 문자열 기본값 없음 해당 사항 없음

    새 열 삽입

    지정한 열의 인덱스 값에 따라 문서의 첫 번째 테이블에 새 열을 삽입합니다.
    입력
    열 인덱스

    새 행 삽입

    인덱스 값을 기준으로 새 행을 삽입합니다.
    입력
    행 인덱스

    삽입그림

    이미지를 삽입합니다.
    입력
    이미지 파일 경로
    책갈피

    테이블 삽입

    문서에 표를 삽입합니다 Microsoft 단어 . 문서에 표를 삽입합니다 Microsoft . 삽입하기 전에 문서를 구성하여 선택적으로 문서를 사용자 지정할 수 있습니다.

    주:
    이 메서드를 실행하기 전에 GetTable 및 SetTable 메서드를 실행해야 합니다.
    삽입하기 전에 테이블을 사용자 지정하려면 다음 단계를 수행합니다.
    1. Method settings 아이콘( Method settings 아이콘. )을 클릭합니다.
    2. 헤더 포함을 선택합니다.
    3. 테두리 스타일 및 자동 맞춤 동작을 선택합니다.
    4. 빈 행 포함을 선택합니다.
    5. 특정 열을 무시하려면 인덱스 값 추가 아이콘( Add index value)을 클릭합니다.
    6. 열의 인덱스 값을 입력합니다.
    7. 확인을 클릭합니다.
    입력
    책갈피
    데이터

    텍스트 삽입

    Word 문서의 시작 부분에 텍스트를 삽입합니다.

    표 12. InsertText 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    텍스트 텍스트를 가져옵니다. 데이터 입력 문자열 기본값 없음 예

    오픈(IsOpen)

    문서가 열려 있는지 확인합니다 Microsoft 단어 .

    출력
    반환(부울)

    MergeByCellIndices (영문)

    인덱스 값 범위의 형태로 지정된 셀 범위를 병합합니다.
    입력
    StartCellIndex, EndCellIndex, EndCellIndex,

    MergeByRowCol

    문서에서 표의 셀 범위를 병합합니다 Microsoft 단어 .
    입력
    StartRowIndex StartColIndex EndRowIndex EndColIndex

    책갈피 바꾸기

    문서의 책갈피를 Microsoft 단어 지정된 텍스트로 바꿉니다.
    입력
    책갈피 ReplaceText

    ReplaceBookmarks

    문서에서 지정된 텍스트가 Microsoft 단어 있는 여러 책갈피를 찾아서 바꿉니다.
    입력
    텍스트
    바꿀 책갈피 텍스트에 대한 자세한 내용을 다음과 같이 제공합니다.
    1. 구성요소를 두 번 클릭합니다.
    2. 레이블/책갈피 제공 대화 상자에서 레이블을 추가하려면 클릭 아이콘( 레이블을 추가하려면 클릭 아이콘. )을 클릭하고 책갈피를 입력하여 바꿉니다.

      책갈피를 더 추가하려면 이 단계를 반복합니다.

    3. 확인을 클릭합니다.

    ReplaceFooterText

    문서에서 바닥글 텍스트를 Microsoft 단어 찾아서 지정된 텍스트로 바꿉니다.
    입력
    텍스트 찾기
    텍스트 바꾸기

    Replace헤더텍스트

    문서에서 헤더 텍스트를 Microsoft 단어 찾아서 지정된 텍스트로 바꿉니다.
    입력
    텍스트 찾기
    텍스트 바꾸기

    ReplaceStaticText (정적 텍스트 바꾸기)

    문서의 텍스트를 Microsoft 단어 찾아서 지정된 텍스트로 바꿉니다. 구성에 따라 책갈피, 제목 또는 텍스트를 바꿉니다.

    실행하기 전에 메서드를 구성해야 합니다. 구성하려면 다음 단계를 수행합니다.
    1. 방법 설정 아이콘( 방법 설정 아이콘. )을 클릭합니다.
    2. 텍스트 추가 아이콘( 텍스트 추가 아이콘.)
    3. 바꾸려는 제목, 책갈피 또는 텍스트를 입력합니다.
    4. 단계를 반복하여 더 많은 텍스트를 입력합니다.
    5. 확인을 클릭합니다.
    입력
    개체

    텍스트 바꾸기

    문서의 텍스트를 Microsoft 단어 찾아서 지정된 텍스트로 바꿉니다.
    입력
    텍스트 찾기
    텍스트 바꾸기

    크기 조정

    문서 창 Microsoft 단어 의 크기를 조정합니다.
    입력
    왼쪽
    상위
    너비
    높이

    저장

    열려 Microsoft 단어 있는 문서를 저장합니다.

    다른 이름으로 저장

    열려 Microsoft 단어 있는 문서를 지정된 파일 이름으로 저장합니다.
    입력
    파일 경로

    설정할

    문서에서 테이블을 Microsoft 단어 설정합니다.
    입력
    테이블

    SetTableCellValues (테이블 셀 값 설정)

    문서에서 테이블 셀 Microsoft 단어 의 내용을 설정합니다.

    다음과 같이 하나 이상의 셀 인덱스와 값 유형을 제공합니다.
    1. 구성요소를 두 번 클릭합니다.
    2. PROVIDE CELL INDEXES 대화 상자에서 셀 인덱스를 추가하려면 클릭 아이콘( 셀 인덱스를 추가하려면 클릭 아이콘)을 클릭하고 셀 인덱스를 입력하고 값 유형을 선택합니다.

      이 단계를 반복하여 셀 인덱스와 값 형식을 더 추가합니다.

    3. 확인을 클릭합니다.

    SetTableRowData (테이블 행 데이터)

    문서의 워크시트 Microsoft 단어 에 있는 표 행의 내용을 설정합니다.
    입력
    행 인덱스
    다음과 같이 열 인덱스를 제공합니다.
    1. 구성요소를 두 번 클릭합니다.
    2. PROVIDE COLUMN INDEXES 대화 상자에서 셀 인덱스를 추가하려면 클릭 아이콘( 셀 인덱스를 추가하려면 클릭 아이콘)을 클릭하고 열 인덱스를 입력합니다.
    3. 확인을 클릭합니다.