Élément Image

Représente une image.

Utilisation

<Image
  Source = "xs:anyURI"
  MinDPI = "xs:positiveInteger"
  Symbol = "xs:string"
  Id = "xs:positiveInteger union xs:string">
  child elements
</Image>

Attributs

Attribut Type Obligatoire Description
Id
XS : positiveInteger Union XS : String
No
ID de ressource unique.

(Union de XS : positiveInteger et XS : String)
Valeur entière comprise entre 2 et 59999, inclusive, ou 0X2 et 0xea5f en hexadécimal, inclus.
La longueur maximale est de 10 caractères, y compris des zéros non significatifs facultatifs.
MinDPI
xs:positiveInteger
No
(XS : positiveInteger)
Toute séquence de chiffres avec une valeur minimale de 96.
Si MinDPI est omis, la valeur par défaut est 96.
Source
xs:anyURI
No
(XS : anyURI)
Séquence de caractères qui représente un URI. La valeur de l’URI est un chemin d’accès absolu ou relatif (au fichier de balisage du ruban) à une ressource image de type BMP.
Symbole
xs:string
No
Symbole de ressource pour l’image.

(XS : String)
Chaîne composée d’une lettre ou d’un trait de soulignement suivi d’une séquence de lettres, de chiffres ou de traits de soulignement, avec un maximum de 100 caractères.

Éléments enfants

Élément Description
Image. source
Peut se produire au plus une fois

Éléments parents

Élément
Commande. LargeHighContrastImages
Commande. LargeImages
Commande. SmallHighContrastImages
Commande. SmallImages

Remarques

Optionnel.

Peut se produire une ou plusieurs fois pour chaque élément Command. SmallImages, Command. SmallHighContrastImages, Command. LargeImagesou Command. LargeHighContrastImages .

Lorsqu’une collection de ressources d’image conçues pour prendre en charge des paramètres de points par pouce (dpi) spécifiques est fournie à l’infrastructure du ruban via un ensemble d’éléments d' image , l’infrastructure utilise l' image avec une valeur d’attribut MinDPI qui correspond au paramètre PPP d’écran actuel.

Si aucun élément image n’est déclaré avec une valeur MinDPI qui correspond au paramètre PPP d’écran actuel, l’infrastructure sélectionne l' image qui a la valeur MinDPI la plus proche inférieure au paramètre PPP d’écran actuel et met à l’échelle la ressource d’image. Sinon, si aucun élément image n’est déclaré avec une valeur d’attribut MinDPI inférieure au paramètre PPP d’écran actuel, le Framework choisit la valeur MinDPI la plus proche supérieure au paramètre PPP d’écran actuel et met à l’échelle la ressource d’image.

Exemples

L’exemple de code suivant montre le balisage requis pour déclarer, via un ensemble d’éléments image , une collection de ressources d’image conçues pour prendre en charge quatre paramètres de résolution d’écran spécifiques.

<Command Name="cmdSizeAndColor" Symbol="IDR_CMD_SIZEANDCOLOR">
  <Command.LabelTitle>
    <String Id="250">Size and Color</String>
  </Command.LabelTitle>
  <Command.LargeImages>
    <Image Id="251" MinDPI="96">res/sizeAndColor_96.bmp</Image>
    <Image Id="252" MinDPI="120">res/sizeAndColor_120.bmp</Image>
    <Image Id="253" MinDPI="144">res/sizeAndColor_144.bmp</Image>
    <Image Id="254" MinDPI="192">res/sizeAndColor_192.bmp</Image>
  </Command.LargeImages>
</Command>

Informations sur les éléments

  • système minimal pris en charge: Windows 7
  • Peut être vide: non

Voir aussi

Spécification des ressources d’image du ruban