Контентные надстройки Office

Мақала
02/14/2025

Контентные надстройки — это рабочие области, которые можно внедрять прямо в документы Excel или PowerPoint. Контентные надстройки предоставляют пользователям доступ к элементам управления интерфейсом, которые выполняют код для изменения документов или отображения данных. Используйте контентные надстройки, когда требуется внедрить функции непосредственно в документ.

Рис. 1. Типичный макет для контентных надстроек

Типичный макет для контентных надстроек в приложении Office.

Варианты

Размеры контентных надстроек для Excel и PowerPoint в классической версии Office и в веб-браузере указаны пользователем.

Меню личных данных могут перекрывать элементы навигации и управления, расположенные в правой верхней части надстройки. Ниже указаны текущие размеры меню личных данных в Windows и Mac.

Меню личных данных в Windows имеет размер 12 x 32 пикселей, как показано ниже.

Рис. 2. Меню "Личность" в Windows

В Mac меню личных данных имеет размер 26 x 26 точек, но сдвинуто на 8 пикселей влево и на 6 вниз, из-за чего оно занимает пространство размером 34 x 32 пикселей, как показано на изображении.

Рис. 3. Меню "Личность" на Компьютере Mac

Реализация

Существуют незначительные различия в манифестах между контентными надстройками и надстройками, которые используют области задач. Откройте вкладку для типа манифеста, который вы используете.

Унифицированный манифест для Microsoft 365
Манифест только надстройки

Примечание.

Унифицированный манифест доступен в Excel, PowerPoint и Word в качестве предварительной версии для разработчиков. Для Outlook она общедоступна и может использоваться в рабочих надстройках.

Настройте манифест, выполнив следующие действия.

Добавьте дочерний массив contentRuntimes в объект расширения в массиве extensions.
Удалите свойство runtimes, если оно присутствует. Массив runtimes предназначен для надстроек области задач или почтовых надстроек. Их нельзя комбинировать с контентной надстройкой.
Добавьте анонимный объект среды выполнения содержимого в массив contentRuntimes.
Задайте для свойства "id" объекта описательное имя.
Задайте для объекта "code.page" полный URL-адрес пользовательского содержимого, которое требуется внедрить в документ.
При необходимости задайте для свойств "requestedWidth" и "requestedHeight" размер от 32 до 1000 пикселей. Если эти свойства не используются, приложение Office определяет размер.
При необходимости присвойте свойству disableSnapshot значение , true чтобы запретить Office сохранять snapshot компонента содержимого с документом.

Ниже приведен пример свойства contentRuntimes.

"contentRuntimes": [
    {
        "id": "ContentRuntime",
        "code": {
            "page": "https://localhost:3000/content.html"
        },
        "requestedWidth": 100,
        "requestedHeight": 100,
        "disableSnapshot": true,
    }
]

Пример, реализующий контентную надстройку, см. в статье Контентная надстройка Excel Humongous Insurance на сайте GitHub.

Чтобы создать собственную контентную надстройку, см. статьи Краткое руководство по надстройке для содержимого Excel и Краткое руководство по надстройке с контентом PowerPoint.

Что касается поддержки

Проверьте, будет ли надстройка Office работать с определенным приложением Или платформой Office.
Чтобы надстройка могла читать и записывать данные в Excel или PowerPoint, может потребоваться добавление в список доверенных. Вы можете объявить нужный уровень разрешений для пользователя в манифесте надстройки.

Бөлісу құралы:

Контентные надстройки Office

Рекомендации

Варианты

Меню личных данных

Реализация

Что касается поддержки

См. также

Қосымша ресурстар