연습: Visual Basic 프로젝트에서 VBA의 코드 호출

아티클
06/19/2023

이 연습에서는 문서의 VBA(Visual Basic for Applications) 코드에서 Microsoft Office Word에 대한 문서 수준 사용자 지정의 메서드를 호출하는 방법을 보여 줍니다. 이 절차에는 세 가지 기본 단계( ThisDocument 호스트 항목 클래스에 메서드 추가, VBA 코드에 메서드 노출, 문서의 VBA 코드에서 메서드 호출)가 포함됩니다.

적용 대상: 이 항목의 정보는 Excel 및 Word의 문서 수준 프로젝트에 적용됩니다. 자세한 내용은 Office 애플리케이션 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하세요.

이 연습에서는 Word를 사용하지만 Excel용 문서 수준 프로젝트에도 연습에서 설명하는 개념이 적용됩니다.

이 연습에서는 다음 작업을 수행합니다.

VBA 코드를 포함하는 문서 만들기
Word의 보안 센터를 사용하여 문서 위치 신뢰
ThisDocument 호스트 항목 클래스에 메서드 추가
VBA 코드에 메서드 노출
VBA 코드에서 메서드 호출

참고 항목

일부 Visual Studio 사용자 인터페이스 요소의 경우 다음 지침에 설명된 것과 다른 이름 또는 위치가 시스템에 표시될 수 있습니다. 이러한 요소는 사용하는 Visual Studio 버전 및 설정에 따라 결정됩니다. 자세한 내용은 Visual Studio IDE 개인 설정을 참조하세요.

필수 조건

이 연습을 완료하려면 다음과 같은 구성 요소가 필요합니다.

Microsoft Office 개발자 도구를 포함하는 Visual Studio 버전입니다. 자세한 내용은 Office 솔루션을 개발하기 위한 컴퓨터 구성을 참조하세요.
Microsoft Word

VBA 코드를 포함하는 문서 만들기

첫 번째 단계는 간단한 VBA 매크로를 포함하는 매크로 사용 문서를 만드는 것입니다. 해당 문서를 기반으로 하는 Visual Studio 프로젝트를 만들기 전에 문서에 VBA 프로젝트가 포함되어야 합니다. 그렇지 않으면 Visual Studio가 VBA 코드에서 사용자 지정 어셈블리를 호출할 수 있도록 VBA 프로젝트를 수정할 수 없습니다.

사용하려는 VBA 코드를 포함하는 문서가 이미 있는 경우 이 단계를 건너뛸 수 있습니다.

VBA 코드를 포함하는 문서를 만들려면

Word를 시작합니다.
활성 문서를 이름이 DocumentWithVBA인 Word 매크로 사용 문서(*.docm) 로 저장합니다. 통합 문서를 바탕 화면과 같은 편리한 위치에 저장합니다.
리본에서 개발자 탭을 클릭합니다.

참고 항목

개발자 탭이 표시되지 않는 경우 먼저 개발자 탭을 표시해야 합니다. 자세한 내용은 방법: 리본에 개발자 도구 탭 표시을 참조하세요.
코드 그룹에서 Visual Basic을 클릭합니다.

Visual Basic Editor가 열립니다.
프로젝트 창에서 ThisDocument를 두 번 클릭합니다.

ThisDocument 개체의 코드 파일이 열립니다.
다음 VBA 코드를 코드 파일에 추가합니다. 이 코드는 아무 작업도 수행하지 않는 간단한 함수를 정의합니다. 이 함수의 유일한 목적은 VBA 프로젝트가 문서에 있는지 확인하는 것입니다. 이 작업은 이 연습의 이후 단계에 필요합니다.
```
Sub EmptySub()
End Sub
```
문서를 저장하고 Word를 종료합니다.

프로젝트 만들기

이제 이전에 만든 매크로 사용 문서를 사용하는 Word용 문서 수준 프로젝트를 만들 수 있습니다.

새 프로젝트를 만들려면

Visual Studio를 시작합니다.
파일 메뉴에서 새로 만들기를 가리킨 다음 프로젝트를 클릭합니다. IDE가 Visual Basic 개발 설정을 사용하도록 설정되면 파일 메뉴에서 새 프로젝트를 클릭합니다.
템플릿 창에서 Visual Basic을 확장한 다음 Office/SharePoint를 확장합니다.
Office 추가 기능 노드를 선택합니다.
프로젝트 템플릿 목록에서 Word 2010 문서 또는 Word 2013 문서 프로젝트를 선택합니다.
이름 상자에 CallingCodeFromVBA를 입력합니다.
확인을 클릭합니다.

Visual Studio Tools for Office 프로젝트 마법사 가 열립니다.
기존 문서 복사를 선택하고 기존 문서의 전체 경로 상자에서 이전에 만든 DocumentWithVBA 문서의 위치를 지정합니다. 사용자 고유의 매크로 사용 문서를 사용하는 경우 대신 이 문서의 위치를 지정합니다.
Finish를 클릭합니다.

Visual Studio의 디자이너에 DocumentWithVBA 문서가 열리고 CallingCodeFromVBA 프로젝트가 솔루션 탐색기에 추가됩니다.

문서 위치 신뢰

문서의 VBA 코드에 솔루션의 코드를 노출하려면 먼저 실행할 문서의 VBA를 신뢰해야 합니다. 이 작업을 수행하는 데는 몇 가지 방법이 있습니다. 이 연습의 경우 Word의 보안 센터 에서 문서 위치를 신뢰합니다.

문서 위치를 신뢰하려면

Word를 시작합니다.
파일 탭을 클릭합니다.
Word 옵션 단추를 클릭합니다.
범주 창에서 보안 센터를 클릭합니다.
세부 정보 창에서 보안 센터 설정을 클릭합니다.
범주 창에서 신뢰할 수 있는 위치를 클릭합니다.
세부 정보 창에서 새 위치 추가를 클릭합니다.
Microsoft Office 신뢰할 수 있는 위치 대화 상자에서 CallingCodeFromVBA 프로젝트가 들어 있는 폴더를 찾습니다.
이 위치의 하위 폴더도 신뢰할 수 있음을 선택합니다.
Microsoft Office 신뢰할 수 있는 위치 대화 상자에서 확인을 클릭합니다.
보안 센터 대화 상자에서 확인을 클릭합니다.
Word 옵션 대화 상자에서 확인을 클릭합니다.
Word를 종료합니다.

ThisDocument 클래스에 메서드 추가

이제 VBA 프로젝트가 설정되었으므로 VBA 코드에서 호출할 수 있는 ThisDocument 호스트 항목 클래스에 메서드를 추가합니다.

ThisDocument 클래스에 메서드를 추가하려면

솔루션 탐색기에서 ThisDocument.vb를 마우스 오른쪽 단추로 클릭한 다음 코드 보기를 클릭합니다.

ThisDocument.vb 파일이 코드 편집기에서 열립니다.

다음 메서드를 ThisDocument 클래스에 추가합니다. 이 메서드는 문서의 시작 부분에 두 행과 두 열이 있는 테이블을 만듭니다. 매개 변수는 첫 번째 행에 표시되는 텍스트를 지정합니다. 이 연습의 뒷부분에서는 문서의 VBA 코드에서 이 메서드를 호출합니다.

Public Sub CreateTable(ByVal firstColumnHeader As String, _
    ByVal secondColumnHeader As String)

    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim table1 As Word.Table = Me.Tables.Add(Me.Paragraphs(1).Range, 2, 2)

    With table1
        .Style = "Table Professional"
        .Cell(1, 1).Range.Text = firstColumnHeader
        .Cell(1, 2).Range.Text = secondColumnHeader
    End With
End Sub

프로젝트를 빌드합니다.

VBA 코드에 메서드 노출

문서의 VBA 코드에 CreateTable 메서드를 노출하려면 호스트 항목의 EnableVbaCallers ThisDocument 속성을 True로 설정합니다.

VBA 코드에 메서드를 노출하려면

솔루션 탐색기에서 ThisDocument.vb를 두 번 클릭합니다.

DocumentWithVBA 파일이 디자이너에서 열립니다.
속성 창에서 EnableVbaCallers 속성을 선택하고 값을 True로 변경합니다.
표시되는 메시지에서 확인 을 클릭합니다.
프로젝트를 빌드합니다.

VBA 코드에서 메서드 호출

이제 문서의 VBA 코드에서 CreateTable 메서드를 호출할 수 있습니다.

참고 항목

이 연습에서는 프로젝트를 디버그하는 동안 문서에 VBA 코드를 추가합니다. Visual Studio에서 빌드 출력 폴더의 문서를 주 프로젝트 폴더의 문서 복사본으로 바꾸기 때문에 이 문서에 추가하는 모든 VBA 코드는 다음번에 프로젝트를 빌드할 때 덮어쓰입니다. VBA 코드를 저장하려는 경우 프로젝트 폴더의 문서에 복사할 수 있습니다. 자세한 내용은 VBA 및 문서 수준 사용자 지정 결합을 참조하세요.

VBA 코드에서 메서드를 호출하려면

F5 키를 눌러 프로젝트를 실행합니다.
개발자 탭의 코드 그룹에서 Visual Basic을 클릭합니다.

Visual Basic Editor가 열립니다.
삽입 메뉴에서 모듈을 클릭합니다.
새 모듈에 다음 코드를 추가합니다.

이 코드는 사용자 지정 어셈블리의 CreateTable 메서드를 호출합니다. 매크로는 CallVSTOAssembly 개체의 ThisDocument 속성을 사용하여 이 메서드에 액세스합니다. 이 속성은 이 연습의 앞부분에서 EnableVbaCallers 속성을 설정할 때 자동으로 생성되었습니다.
```
Sub CreateTable()
    Call ThisDocument.CallVSTOAssembly.CreateTable("Employee Name", "Start Date")
End Sub
```
F5키를 누릅니다.
문서에 새 테이블이 추가되었는지 확인합니다.
변경 내용을 저장하지 않고 Word를 종료합니다.

다음 단계

다음 항목에서는 VBA에서 Office 솔루션의 코드를 호출하는 방법에 대해 자세히 알아볼 수 있습니다.

VBA에서 Visual C# 사용자 지정의 코드를 호출합니다. 이 프로세스는 Visual Basic 프로세스와 다릅니다. 자세한 내용은 연습: Visual C# 프로젝트의 VBA에서 코드 호출을 참조하세요.
VBA에서 VSTO 추가 기능의 코드를 호출합니다. 자세한 내용은 연습: VBA에서 VSTO 추가 기능의 코드 호출을 참조하세요.

다음을 통해 공유

연습: Visual Basic 프로젝트에서 VBA의 코드 호출

필수 조건

VBA 코드를 포함하는 문서 만들기

VBA 코드를 포함하는 문서를 만들려면

프로젝트 만들기

새 프로젝트를 만들려면

문서 위치 신뢰

문서 위치를 신뢰하려면

ThisDocument 클래스에 메서드 추가

ThisDocument 클래스에 메서드를 추가하려면

VBA 코드에 메서드 노출

VBA 코드에 메서드를 노출하려면

VBA 코드에서 메서드 호출

VBA 코드에서 메서드를 호출하려면

다음 단계

피드백

추가 리소스

다음을 통해 공유

연습: Visual Basic 프로젝트에서 VBA의 코드 호출

필수 조건

VBA 코드를 포함하는 문서 만들기

VBA 코드를 포함하는 문서를 만들려면

프로젝트 만들기

새 프로젝트를 만들려면

문서 위치 신뢰

문서 위치를 신뢰하려면

ThisDocument 클래스에 메서드 추가

ThisDocument 클래스에 메서드를 추가하려면

VBA 코드에 메서드 노출

VBA 코드에 메서드를 노출하려면

VBA 코드에서 메서드 호출

VBA 코드에서 메서드를 호출하려면

다음 단계

관련 콘텐츠

피드백

추가 리소스