Elemento IconUrl

  • Artigo

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

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

Sintaxe

<IconUrl DefaultValue="string" />

Pode conter

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

Para um suplemento de email, o ícone é exibido na interface do usuário degerenciamento dearquivos> (Outlook) ou Configurações>Gerenciar interface do usuário 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 verticais para o 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 Script Lab e outro suplemento foram iniciados e os painéis de tarefa Code e Run de Script Lab foram abertos.

A polegada superior de um painel de tarefas, com três guias quadradas à direita do canto superior direito. Duas das guias têm o ícone Script Lab. O terceiro tem um ícone para um suplemento diferente.

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

A imagem deve estar em um dos seguintes formatos: GIF, JPG, PNG, EXIF, BMP ou TIFF. Para aplicativos de conteúdo e de painel de tarefas, a imagem especificada deve ter 32 x 32 pixels. Para aplicativos de email, a resolução de imagem deve ser de 64 x 64 pixels. Você também deve especificar um ícone para uso com aplicativos cliente do Office em execução em telas DPI altas usando o elemento HighResolutionIconUrl . Para saber mais, confira a seção Criar uma identidade visual consistente para seu aplicativo em Criar listagens eficazes no AppSource e no Office.

No momento, não há suporte para alterar o IconUrl valor do elemento no runtime.

Exemplos

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

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