Контентные надстройки OfficeContent Office Add-ins

Контентные надстройки — это рабочие области, которые можно внедрять прямо в документы Excel или PowerPoint.Content add-ins are surfaces that can be embedded directly into Excel or PowerPoint documents. Контентные надстройки предоставляют пользователям доступ к элементам управления интерфейсом, которые выполняют код для изменения документов или отображения данных.Content add-ins give users access to interface controls that run code to modify documents or display data from a data source. Используйте контентные надстройки, когда требуется внедрить функции непосредственно в документ.Use content add-ins when you want to embed functionality directly into the document.

Рисунок 1. Макет для контентных надстроекFigure 1. Typical layout for content add-ins

Изображение, на котором показан типичный макет контентной надстройки.

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

  • Добавьте элемент навигации или управления, такой как CommandBar или Pivot, в верхнюю часть надстройки.Include some navigational or commanding element such as the CommandBar or Pivot at the top of your add-in.
  • Добавьте элемент фирменной символики, такой как BrandBar, в нижнюю часть надстройки (применимо только к надстройкам Excel и PowerPoint).Include a branding element such as the BrandBar at the bottom of your add-in (applies to Excel and PowerPoint add-ins only).

ВариантыVariants

Размеры контентных надстроек для Excel и PowerPoint в Office для настольных систем и Office 365 указывает пользователь.Content add-in sizes for Excel and PowerPoint in Office desktop and Office 365 are user specified.

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

Меню личных данных могут перекрывать элементы навигации и управления, расположенные в правой верхней части надстройки. Ниже указаны текущие размеры меню личных данных в Windows и Mac.Personality menus can obstruct navigational and commanding elements located near the top right of the add-in. The following are the current dimensions of the personality menu on Windows and Mac.

В Windows меню личных данных имеет размер 12 x 32 пикселей, как показано на изображении.For Windows, the personality menu measures 12x32 pixels, as shown.

Рисунок 2. Меню личных данных в WindowsFigure 2. Personality menu on Windows

Изображение меню личных данных на компьютере с Windows

В Mac меню личных данных имеет размер 26 x 26 точек, но сдвинуто на 8 пикселей влево и на 6 вниз, из-за чего оно занимает пространство размером 34 x 32 пикселей, как показано на изображении.For Mac, the personality menu measures 26x26 pixels, but floats 8 pixels in from the right and 6 pixels from the top, which increases the occupied space to 34x32 pixels, as shown.

Рисунок 3. Меню личных данных на MacFigure 3. Personality menu on Mac

Изображение меню личных данных на компьютере с Mac

РеализацияImplementation

Пример реализации контентной надстройки для Excel: Humongous Insurance на сайте GitHub.For a sample that implements a content add-in, see Excel Content Add-in Humongous Insurance in GitHub.

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

  • Проверьте, будет ли ваша надстройка Office работать на конкретной платформе Office.Check to see if your Office Add-in will work on a specific Office host platform.
  • Чтобы надстройка могла читать и записывать данные в Excel или PowerPoint, может потребоваться добавление в список доверенных.Some content add-ins may require the user to "trust" the add-in to read and write to Excel or PowerPoint. Вы можете объявить нужный уровень разрешений для пользователя в манифесте надстройки.You can declare what level of permissions you want your user to have in the add-in's manifest.
  • Контентные надстройки поддерживаются в Excel и PowerPoint в Office 2013 и более поздних версий. Если вы откроете надстройку в версии Office, которая не поддерживает веб-надстройки, вместо надстройки будет показано изображение.Content add-ins are supported in Excel and PowerPoint in Office 2013 version and later. If you open an add-in in a version of Office that doesn't support Office web add-ins, the add-in will be displayed as an image.

См. такжеSee also