Compartir a través de


Elemento Image

Proporciona la dirección URL de un archivo de imagen que se usa como icono.

Tipo de complemento: Panel de tareas, Correo

Solo es válido en estos esquemas VersionOverrides:

  • Panel de tareas 1.0
  • Correo 1.0
  • Correo 1.1

Para obtener más información, vea Invalidaciones de versión en el manifiesto de solo complemento.

Nota:

Debe usar Capa de sockets seguros (SSL) para todas las direcciones URL del <elemento Image> y cualquier elemento Override> secundario<.

Cada icono debe tener tres <elementos Image> , uno para cada uno de los tres tamaños obligatorios:

  • 16x16
  • 32x32
  • 80x80

También se admiten los siguientes tamaños adicionales, pero no son necesarios.

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

Se admiten los siguientes formatos de archivo de imagen.

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

Importante

  • Si la imagen es el icono representativo del complemento, consulte Creación de descripciones efectivas en AppSource y en Office para conocer el tamaño y otros requisitos.
  • Los complementos de Office requieren la capacidad de almacenar en caché los recursos de imagen con fines de rendimiento. Por este motivo, el servidor donde se hospede un recurso de imagen no tiene que agregar directivas Cache-Control al encabezado de respuesta. Estas directivas dan como resultado que Office sustituya automáticamente una imagen genérica o predeterminada. Para forzar el uso de nuevos iconos en el equipo de desarrollo, borre la memoria caché de Office. Para forzar el uso de nuevos iconos en los equipos del usuario final, debe proporcionar a los nuevos iconos direcciones URL diferentes de las antiguas.

Elementos secundarios

Elemento Tipo Descripción
Override imagen Proporciona una manera de invalidar la dirección URL en función de una configuración regional especificada.

Ejemplo

<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>