Elemento IconUrl

Especifica a URL completa e absoluta da imagem usada para representar seu Suplemento do Office na UX de inserção, no AppSource e na barra de guias do painel de tarefas vertical.

Importante

Esse elemento e o elemento HighResolutionIconUrl agora são necessários para suplementos distribuídos no AppSource.

Tipo de suplemento: Conteúdo, Painel de tarefas, Email

Sintaxe

<IconUrl DefaultValue="string" />

Pode conter

• Override

Atributos

Atributo	Tipo	Obrigatório	Descrição
DefaultValue	string	Sim	Especifica o valor padrão para essa configuração, expresso para a localidade especificada no elemento DefaultLocale.

Comentários

A imagem deve estar em um dos seguintes formatos de arquivo.

• BMP
• EXIF
• GIF
• JPG
• PNG
• TIFF

Os requisitos de resolução de imagem são os seguintes.

Tipo de suplemento	Resolução (pixels)
Conteúdo	32 x 32
Email	64 x 64
Painel de tarefas	32 x 32

Você também deve especificar um ícone para uso com aplicativos cliente do Office em execução em telas de DPI alto usando o elemento HighResolutionIconUrl . Para obter mais informações, consulte a seção Criar uma identidade visual consistente em Criar listagens efetivas no AppSource e no Office.

Para um suplemento de email, o ícone é exibido na interface do usuáriode Gerenciamento de Arquivos > deSuplementos (Outlook) ou na Interface do Usuáriode Gerenciamento de Configurações> de Suplementos (Outlook na Web). Para um suplemento de conteúdo ou de painel de tarefas, o ícone é exibido na interface de usuário Inserir>Suplementos.

A imagem também é usada na barra de guias vertical do painel de tarefas quando mais de um painel de tarefas está aberto. A barra de guias aparece ao lado do painel de tarefas sempre que um segundo painel de tarefas é aberto, independentemente de ser um painel de tarefas no mesmo suplemento ou em um suplemento diferente. A imagem a seguir mostra a barra de guias quando o suplemento do Script Lab e outro suplemento foram iniciados e os painéis de tarefas Código e Executar do Script Lab foram abertos.

Para todos os tipos de suplemento, o ícone também será usado no AppSource, se você publicar seu suplemento no AppSource.

No momento, não há suporte para a alteração do valor do IconUrl elemento em tempo de execução.

Exemplos

<IconUrl DefaultValue="https://localhost:3000/assets/images/icon-32.png" />

<IconUrl DefaultValue="https://script-lab.azureedge.net/assets/images/icon-32.png" />