웹 확장 프로그램

웹 확장

이 가이드는 Aspose.Words FOSS for .NET를 사용하여 .docx 파일에 포함된 Office Add-in 작업 창 메타데이터를 읽고 수정하는 방법을 보여줍니다. Aspose.Words FOSS for .NET는 Document.WebExtensionTaskPanes와 TaskPane/WebExtension 객체 모델을 통해 .docx 파일에 포함된 웹 확장(Office Add-in) 작업 창을 읽고 수정할 수 있습니다 — 문서를 Office Add-in과 연결하고 문서 데이터에 바인딩하는 메타데이터 —.

작업 창

Document.WebExtensionTaskPanes은 TaskPane 객체의 TaskPaneCollection을 반환합니다. 각 TaskPane은 추가 기능의 창이 어디에 어떻게 도킹되는지를 설명합니다: DockState (TaskPaneDockState of Right or Left), Row, Width, IsLocked, 및 IsVisible, 그리고 추가 기능 자체에 연결되는 WebExtension 속성도 포함합니다.

웹 확장 식별 및 참조

WebExtension은 Id와 IsFrozen를 통해 추가 기능을 식별하고, 그 Reference 속성(WebExtensionReference)은 Id, Version, Store, 및 StoreType(예: SPCatalog, Exchange, 또는 FileSystem와 같은 WebExtensionStoreType)을 노출하여 추가 기능이 배포되는 위치를 설명합니다. AlternateReferences은 대체 참조들의 WebExtensionReferenceCollection를 보유합니다.

바인딩 및 사용자 정의 속성

WebExtension.Bindings은(는) WebExtensionBinding 객체들의 WebExtensionBindingCollection이며, 각각은 new WebExtensionBinding(id, bindingType, appRef)으로 구성되고 WebExtensionBindingType(Matrix, Table, 또는 Text)를 통해 문서 데이터의 일부를 애드인에 연결합니다. WebExtension.Properties은(는) 간단한 WebExtensionProperty 이름/값 쌍들의 WebExtensionPropertyCollection이며, new WebExtensionProperty(name, value)으로 구성되어 전체 바인딩이 필요하지 않은 애드인 전용 사용자 지정 설정에 사용됩니다.

컬렉션 멤버십

TaskPaneCollection, WebExtensionBindingCollection, WebExtensionPropertyCollection, 및 WebExtensionReferenceCollection은 모두 동일한 기본 컬렉션 동작을 공유합니다: Add(item), Clear(), Remove(index), GetEnumerator(), 및 Count.

팁 및 모범 사례

• 애드인의 패널이 현재 사용자에게 표시된 것으로 가정하기 전에 TaskPane.IsVisible을(를) 확인하십시오 — 작업 창은 등록될 수 있지만 숨겨질 수 있습니다.
• WebExtensionReference.StoreType은(는) 애드인이 어디에서 가져왔는지(카탈로그, Exchange, 파일 시스템, 레지스트리)를 알려줍니다; 이를 사용하여 퍼스트 파티와 사이드로드된 애드인을 구분하십시오.
• 바인딩은 특정 WebExtensionBindingType(매트릭스, 표, 또는 일반 텍스트)를 문서 데이터에 연결합니다 — 애드인이 기대하는 데이터 형태를 가정하기 전에 바인딩 유형을 확인하십시오.
• 문서의 다른 곳에 저장하려고 시도하기보다는 간단한 이름/값 애드인 구성 값을 위해 WebExtension.Properties을(를) 사용하십시오.

일반적인 문제

FAQ

문서에 등록된 모든 Office Add-ins를 어떻게 찾을 수 있나요?

Document.WebExtensionTaskPanes을(를) 열거하십시오 (TaskPaneCollection); 각 TaskPane.WebExtension는 애드인의 ID와 구성을 제공합니다.

이 API를 사용하여 새로운 웹 확장 바인딩이나 속성을 추가할 수 있나요?

예 — 컬렉션(WebExtensionBindingCollection, WebExtensionPropertyCollection 등)은 Add()를 지원하므로 기존 WebExtension에 새로운 WebExtensionBinding/WebExtensionProperty 객체를 구성하고 추가할 수 있습니다.

실제로 WebExtensionBinding는 무엇을 바인딩합니까?

문서 데이터의 일부를 애드인에 연결하며, 해당 데이터의 형태를 설명하기 위해 WebExtensionBindingType(Matrix, Table, 또는 Text)를 사용합니다.

문서에 저장된 사용자 정의 추가 기능 설정을 어떻게 읽을 수 있나요?

Iterate WebExtension.Properties (a WebExtensionPropertyCollection); 각 WebExtensionProperty는 Name/Value 쌍을 노출합니다.

API Reference 요약

참조

• Aspose.Words for .NET — Enterprise Documentation