소개

이 종합 가이드에서는 Aspose.Words for .NET을 사용하여 웹 확장 작업창을 Word 문서에 통합하는 강력한 기능을 자세히 살펴봅니다. 작업창은 사용자가 Word 문서 내에서 직접 동적인 대화형 도구를 사용할 수 있도록 지원하여 워크플로를 더욱 원활하고 효율적으로 만들어 줍니다. Aspose.Words를 사용하여 웹 확장 작업창을 설정하고 구성하는 방법을 살펴보겠습니다.

필수 조건

이 튜토리얼을 따라하려면 다음 사항이 있는지 확인하세요.

필수 네임스페이스 가져오기

시작하기 전에 프로젝트에 다음 네임스페이스를 포함하세요.

using Aspose.Words;
using Aspose.Words.WebExtensions;

1단계: 문서 디렉토리 정의

Word 문서가 생성되고 저장될 디렉토리를 정의합니다.

string dataDir = "YOUR_DOCUMENT_DIRECTORY_PATH";

바꾸다 "YOUR_DOCUMENT_DIRECTORY_PATH" 실제 디렉토리 경로를 사용합니다.

2단계: 새 문서 만들기

새 Word 문서 인스턴스를 초기화합니다.

Document doc = new Document();

이 개체는 작업창을 추가하기 위한 기반 역할을 합니다.

3단계: 작업창 추가

문서에 새 작업 창을 만들고 추가합니다.

TaskPane taskPane = new TaskPane();
doc.WebExtensionTaskPanes.Add(taskPane);

그만큼 WebExtensionTaskPanes 컬렉션은 문서와 연관된 모든 작업 창을 관리합니다.

4단계: 작업 창 구성

작업창 속성을 사용자 정의합니다.

taskPane.DockState = TaskPaneDockState.Right;
taskPane.IsVisible = true;
taskPane.Width = 300;
  • DockState: 작업창이 나타나는 위치(예: 오른쪽, 왼쪽)를 결정합니다.
  • IsVisible: 창이 사용자에게 표시되는지 확인합니다.
  • 너비: 창의 너비를 픽셀 단위로 설정합니다.

5단계: 웹 확장 참조 정의

참조를 구성하여 작업 창을 웹 확장 프로그램에 연결합니다.

taskPane.WebExtension.Reference.Id = "extension_id";
taskPane.WebExtension.Reference.Version = "1.0.0.0";
taskPane.WebExtension.Reference.StoreType = WebExtensionStoreType.OMEX;
taskPane.WebExtension.Reference.Store = "en-US";
  • ID: 웹 확장 프로그램의 고유 식별자입니다.
  • 버전: 확장 프로그램의 버전을 지정합니다.
  • StoreType: 소스 유형을 나타냅니다(예: Office Marketplace의 경우 OMEX).
  • 저장: 언어 또는 지역 코드를 정의합니다.

6단계: 웹 확장 프로그램에 속성 추가

기능을 향상시키려면 웹 확장 프로그램에 사용자 정의 속성을 첨부하세요.

taskPane.WebExtension.Properties.Add(new WebExtensionProperty("key", "value"));

속성은 구성 설정이나 데이터 포인트를 정의하는 데 유용합니다.

7단계: 웹 확장 프로그램 바인딩

문서의 특정 부분에 확장자를 바인딩합니다.

taskPane.WebExtension.Bindings.Add(
    new WebExtensionBinding("binding_name", WebExtensionBindingType.Text, "binding_id")
);
  • 바인딩 이름: 바인딩의 고유한 이름입니다.
  • 바인딩 유형: 바인딩 유형(예: 텍스트)을 정의합니다.
  • 바인딩 ID: 바인딩된 콘텐츠를 식별합니다.

8단계: 문서 저장

구성 후, 지정된 디렉토리에 문서를 저장합니다.

doc.Save(dataDir + "DocumentWithTaskPane.docx");

9단계: 작업 창 정보 검증

문서를 로드하고 작업창 설정을 확인하세요.

doc = new Document(dataDir + "DocumentWithTaskPane.docx");

foreach (TaskPane pane in doc.WebExtensionTaskPanes)
{
    WebExtensionReference reference = pane.WebExtension.Reference;
    Console.WriteLine($"Store: {reference.Store}, Version: {reference.Version}, ID: {reference.Id}");
}

이렇게 하면 콘솔에 각 작업 창의 세부 정보가 출력됩니다.

결론

Aspose.Words for .NET을 사용하여 웹 확장 작업 창을 Word 문서에 통합하면 정적 문서가 동적인 대화형 인터페이스로 변환됩니다. 이 튜토리얼을 따라 작업 창을 원활하게 구성하고 관리하여 사용자에게 강력한 기능 향상을 제공할 수 있습니다.

자주 묻는 질문

Word에서 작업창의 목적은 무엇인가요?

작업창은 추가 도구와 기능을 갖춘 측면 패널을 제공하여 Word 문서를 향상시킵니다.

작업 창을 사용자 지정할 수 있나요?

네, 너비, 가시성, 도킹 상태와 같은 속성을 조정하여 맞춤형 사용자 환경을 제공할 수 있습니다.

웹 확장 속성은 어떻게 작동하나요?

이들은 웹 확장에 대한 메타데이터나 설정을 정의하여 동적 동작을 가능하게 합니다.

작업창을 문서에 바인딩해야 합니까?

바인딩은 작업 창을 특정 문서 섹션에 연결하여 상황에 맞는 기능을 향상시킵니다.

Aspose.Words for .NET에 대한 지원은 어디에서 찾을 수 있나요?

방문하세요 Aspose 지원 포럼 도움이 필요하면.