Compartilhar 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.
  • O formato ICO não é suportado. A sua utilização no manifesto falhará na validação do manifesto e impedirá que o suplemento apareça no friso ou na barra de ação.

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>