Elemento Icon

Define um conjunto de elementos de< imagem> para controles button ou menu.

Tipo de suplemento: Painel de tarefas, Email

Válido somente nestes esquemas VersionOverrides:

• Painel de tarefas 1.0
• Email 1.0
• Email 1.1

Para obter mais informações, consulte Substituições de versão no manifesto.

Associado a esses conjuntos de requisitos:

• AddinCommands 1.1 quando o VersionOverrides> pai< é tipo Taskpane 1.0.
• Caixa de correio 1.3 quando o VersionOverrides> pai< é tipo Email 1.0.
• Caixa de correio 1.5 quando o VersionOverrides> pai< é tipo Email 1.1.

Atributos

Atributo	Obrigatório	Descrição
xsi:type	Não	O tipo de ícone que está sendo definido. Isso só é aplicável a ícones em fatores forma móveis. <Os elementos de ícone> contidos em um elemento MobileFormFactor devem ter esse atributo definido como bt:MobileIconList.

Elementos filho

Elemento	Obrigatório	Descrição
Imagem	Sim	resid de uma imagem a usar

Image

Uma imagem para o botão. O atributo resid não pode ter mais de 32 caracteres e deve ser definido como o valor do atributo id de um <elemento Image> no <elemento Images> no elemento Resources . O atributo tamanho indica o tamanho em pixels da imagem. São necessários três tamanhos de imagem (16, 32 e 80 pixels), enquanto outros cinco tamanhos têm suporte (20, 24, 40, 48 e 64 pixels).

<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>

Importante

Se essa imagem for o ícone representativo do suplemento, consulte Criar listagens efetivas no AppSource e no Office para obter tamanho e outros requisitos.

Requisitos adicionais para fatores forma móveis

Quando o elemento Ícone> pai< é descendente de um elemento MobileFormFactor, os tamanhos mínimos necessários são ligeiramente diferentes. O manifesto deve fornecer no mínimo tamanhos de pixel 25, 32 e 48. Cada tamanho fornecido deve aparecer três vezes, com um atributo scale definido como 1, 2 ou 3. Esse atributo especifica a UIScreen.scale propriedade para dispositivos iOS. Para obter mais informações, confira dimensionamento.

<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>