Элемент Icon
Определяет набор <элементов Image> для элементов управления "Кнопка" или "Меню ".
Тип надстройки: Область задач, почта
Допустимо только в следующих схемах VersionOverrides:
- Область задач 1.0
- Почта 1.0
- Почта 1.1
Дополнительные сведения см. в разделе Переопределения версий в манифесте только надстройки.
Связаны с этими наборами требований:
- AddinCommands 1.1 , если родительская <версияOverrides> имеет тип Taskpane 1.0.
- Почтовый ящик 1.3 , если родительская <версияOverrides> имеет тип Mail 1.0.
- Почтовый ящик 1.5 , если родительская <версияOverrides> имеет тип Почта 1.1.
Атрибуты
Атрибут | Обязательный | Описание |
---|---|---|
xsi:type | Нет | Тип определяемого значка. Относится только к значкам в форм-факторах мобильных устройств.
<Для элементов icon> , содержащихся в элементе MobileFormFactor , этот атрибут должен иметь значение bt:MobileIconList . |
Дочерние элементы
Элемент | Обязательный | Описание |
---|---|---|
Image | Да | атрибут resid используемого изображения |
Изображение
Изображение кнопки. Атрибут resid может содержать не более 32 символов и должен иметь значение атрибута <id элемента Image> в элементе< Images> элемента Resources. Атрибут size указывает размер изображения в пикселях. Необходимо использовать три размера изображения (16, 32 и 80 пикселей), а поддерживается еще пять размеров (20, 24, 40, 48 и 64 пикселя).
<Icon>
<bt:Image size="16" resid="blue-icon-16" />
<bt:Image size="32" resid="blue-icon-32" />
<bt:Image size="80" resid="blue-icon-80" />
</Icon>
Важно!
Если это изображение является репрезентативным значком надстройки, см. статью Создание эффективных списков в AppSource и в Office , чтобы узнать о размере и других требованиях.
Дополнительные требования для форм-факторов мобильных устройств
Если родительский <элемент Icon> является потомком элемента MobileFormFactor , минимальные обязательные размеры немного отличаются. В манифесте должны быть указаны размеры, составляющие по крайней мере 48 x 48, 32 x 32 и 25 x 25 пикселей. Каждый указанный размер должен встречаться три раза, при этом атрибуту scale
должно быть присвоено значение 1
, 2
или 3
. Этот атрибут задает UIScreen.scale
свойство для устройств iOS. Дополнительные сведения см. в разделе Масштабирование.
<Icon xsi:type="bt:MobileIconList">
<bt:Image resid="blue-icon-16" size="25" scale="1" />
<bt:Image resid="blue-icon-16" size="25" scale="2" />
<bt:Image resid="blue-icon-16" size="25" scale="3" />
<bt:Image resid="blue-icon-32" size="32" scale="1" />
<bt:Image resid="blue-icon-32" size="32" scale="2" />
<bt:Image resid="blue-icon-32" size="32" scale="3" />
<bt:Image resid="blue-icon-80" size="48" scale="1" />
<bt:Image resid="blue-icon-80" size="48" scale="2" />
<bt:Image resid="blue-icon-80" size="48" scale="3" />
</Icon>
Office Add-ins