Elemento de imagen

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

Tipo de complemento: Panel de tareas, Correo

Válido solo 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 la capa de sockets seguros (SSL) para todas las direcciones URL del <elemento Image> y cualquier elemento secundario <de Override> .

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

  • 16x16
  • 32x32
  • 80x80

Los siguientes tamaños adicionales también se admiten, pero no son obligatorios.

  • 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, vea Crear descripciones efectivas en AppSource y dentro de Office para conocer el tamaño y otros requisitos.
  • Los complementos de Office requieren la capacidad de almacenar en caché los recursos de imagen por motivos 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 hacen 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 caché de Office. Para forzar el uso de nuevos iconos en los equipos de los usuarios finales, debe proporcionar a los nuevos iconos direcciones URL diferentes de las antiguas.
  • El formato ICO no es compatible. Al usarlo en el manifiesto, se producirá un error en la validación del manifiesto y se impedirá que el complemento aparezca en la cinta de opciones o en la barra de acciones.

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>
  • Last updated on