Elemento de imagem

Fornece a URL de um arquivo de imagem usado como um ícone.

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 somente do suplemento.

Observação

Você deve usar SSL <(Secure Sockets Layer) para todas as URLs no elemento Image> e em qualquer elemento Override> filho<.

Cada ícone deve ter três <elementos Image> , um para cada um dos três tamanhos obrigatórios:

  • 16 x 16
  • 32x32
  • 80x80

Os seguintes tamanhos adicionais também são suportados, mas não são obrigatórios.

  • 20x20
  • 24x24
  • 40x40
  • 48x48
  • 64x64

Há suporte para os seguintes formatos de arquivo de imagem.

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

Importante

  • Se a imagem for o ícone representativo do suplemento, consulte Criar listagens efetivas no AppSource e no Office para tamanhos e outros requisitos.
  • Os suplementos do Office exigem a capacidade de armazenar recursos de imagem em cache para fins de desempenho. Por esse motivo, o servidor que hospeda um recurso de imagem não deve adicionar nenhuma diretriz CACHE-CONTROL ao cabeçalho da resposta. Essas diretivas resultam na substituição automática de uma imagem padrão ou genérica pelo Office. Para forçar o uso de novos ícones em seu computador de desenvolvimento, limpe o cache do Office. Para forçar o uso de novos ícones nos computadores dos usuários finais, você deve fornecer aos novos ícones URLs diferentes dos antigos.
  • Não há suporte para o formato ICO. Usá-lo no manifesto falhará na validação do manifesto e impedirá que o suplemento apareça na faixa de opções ou na barra de ações.

Elementos filho

Elemento Tipo Descrição
Override imagem Fornece uma maneira de substituir a URL, dependendo de uma localidade especificada.

Exemplo

<Resources>
      <bt:Images>
        <bt:Image id="icon1_16x16" DefaultValue="https://www.contoso.com/icon_default.png">
          <bt:Override Locale="ja-jp" Value="https://www.contoso.com/ja-jp16-icon_default.png" />
        </bt:Image>
        <bt:Image id="icon1_32x32" DefaultValue="https://www.contoso.com/icon_default.png">
          <bt:Override Locale="ja-jp" Value="https://www.contoso.com/ja-jp32-icon_default.png" />
        </bt:Image>
        <bt:Image id="icon1_80x80" DefaultValue="https://www.contoso.com/icon_default.png">
          <bt:Override Locale="ja-jp" Value="https://www.contoso.com/ja-jp80-icon_default.png" />
        </bt:Image>
      </bt:Images>
      <bt:Urls>
        <bt:Url id="residDesktopFuncUrl" DefaultValue="https://www.contoso.com/Pages/Home.aspx">
          <bt:Override Locale="ja-jp" Value="https://www.contoso.com/Pages/Home.aspx" />
        </bt:Url>
      </bt:Urls>
      <bt:ShortStrings>
        <bt:String id="residLabel" DefaultValue="GetData">
          <bt:Override Locale="ja-jp" Value="JA-JP-GetData" />
        </bt:String>
      </bt:ShortStrings>
      <bt:LongStrings>
        <bt:String id="residToolTip" DefaultValue="Get data for your document.">
          <bt:Override Locale="ja-jp" Value="JA-JP - Get data for your document." />
        </bt:String>
      </bt:LongStrings>
    </Resources>
  • Last updated on