ApplicationFactory.GetVstoObject 메서드

아티클
08/10/2011

지정된 네이티브 문서 개체의 기능을 확장하는 Microsoft.Office.Tools.Word.Document 호스트 항목을 반환합니다.

네임스페이스: Microsoft.Office.Tools.Word
어셈블리: Microsoft.Office.Tools.Word(Microsoft.Office.Tools.Word.dll)

구문

‘선언
Function GetVstoObject ( _
    document As _Document _
) As Document

Document GetVstoObject(
    _Document document
)

매개 변수

document
형식: Microsoft.Office.Interop.Word._Document
확장할 네이티브 문서 개체입니다.이 매개 변수는 Microsoft.Office.Interop.Word._Document 형식이지만 일반적으로 Microsoft.Office.Interop.Word.Document 개체를 이 메서드에 전달합니다.

반환 값

형식: Microsoft.Office.Tools.Word.Document
네이티브 문서 개체의 기능을 확장하는 호스트 항목입니다.

설명

Word에 열려 있는 문서를 사용자 지정하려면 응용 프로그램 수준 추가 기능에서 이 메서드를 호출하십시오. Microsoft.Office.Tools.Word.Document 개체가 이미 생성되어 있지 않은 경우 이 메서드는 이 개체를 새로 생성합니다. 이 메서드를 다시 호출하면 기존 Microsoft.Office.Tools.Word.Document 개체의 캐시된 인스턴스가 반환됩니다. 자세한 내용은 런타임에 응용 프로그램 수준 추가 기능의 Word 문서 및 Excel 통합 문서 확장을 참조하십시오.

참고

document 매개 변수는 Microsoft.Office.Interop.Word._Document 형식인데 이 형식은 Microsoft.Office.Interop.Word.Document의 부모 인터페이스입니다. 따라서 이 메서드는 두 유형의 개체 Microsoft.Office.Interop.Word._Document 및 Microsoft.Office.Interop.Word.Document를 받아들일 수 있습니다. 대개 Word 문서를 참조할 때는 Microsoft.Office.Interop.Word.Document를 사용합니다.

예제

다음 코드 예제에서는 현재 Word 문서에 대한 Microsoft.Office.Tools.Word.Document 호스트 항목을 만듭니다. 이 예제는 PlainTextContentControl을 문서에 추가합니다. 이 코드를 사용하려면 .NET Framework 4을 대상으로 하는 Word 추가 기능 프로젝트의 ThisAddIn 클래스에서 실행하십시오.

Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)

vstoDoc.Paragraphs.Last.Range.InsertParagraphAfter()
Dim myPlainTextControl As PlainTextContentControl = _
    vstoDoc.Controls.AddPlainTextContentControl( _
    vstoDoc.Paragraphs.Last.Range, _
    "myPlainTextControl")
myPlainTextControl.PlaceholderText = "Insert first name"

Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);

vstoDoc.Paragraphs.Last.Range.InsertParagraphAfter();
PlainTextContentControl myPlainTextControl =
    vstoDoc.Controls.AddPlainTextContentControl(
    vstoDoc.Paragraphs.Last.Range,
    "myPlainTextControl");
myPlainTextControl.PlaceholderText = "Insert first name";