Partilhar via


Elemento de imagem

Fornece o URL de um ficheiro de imagem que é utilizado como um ícone.

Tipo de suplemento: Painel de tarefas, Correio

Válido apenas nestes esquemas VersionOverrides:

  • Painel de tarefas 1.0
  • Email 1.0
  • Email 1.1

Para obter mais informações, veja Substituições de versões no manifesto apenas do suplemento.

Observação

Tem de utilizar Secure Sockets Layer (SSL) para todos os URLs no <elemento Imagem> e quaisquer elementos de Substituição subordinados<>.

Cada ícone tem de ter três <elementos imagem> , 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 necessários.

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

Os seguintes formatos de ficheiro de imagem são suportados.

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

Importante

  • Se a imagem for o ícone representativo do seu suplemento, consulte Criar listagens efetivas no AppSource e no Office para obter o tamanho e outros requisitos.
  • Os Suplementos do Office requerem a capacidade de colocar 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. Estas diretivas resultam na substituição automática de uma imagem genérica ou predefinida pelo Office. Para forçar a utilização de novos ícones no seu computador de desenvolvimento, limpe a cache do Office. Para forçar a utilização de novos ícones nos computadores do utilizador final, tem de dar aos novos ícones URLs diferentes dos antigos.

Elementos filho

Elemento Tipo Descrição
Override imagem Fornece uma forma de substituir o URL consoante uma região 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>