Élément Image

Article
06/13/2023

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	Non	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, inclusif. La longueur maximale est de 10 caractères, y compris les zéros de début facultatifs.
MinDPI	xs:positiveInteger	Non	(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	Non	(xs:anyURI) Toute séquence de caractères qui représente un URI. La valeur de l’URI est un chemin absolu ou relatif (par rapport au fichier de balisage du ruban) vers une ressource d’image de type BMP.
Symbole	xs:string	Non	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 jusqu’à 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
Command.LargeHighContrastImages
Command.LargeImages
Command.SmallHighContrastImages
Command.SmallImages

Notes

Optionnel.

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

Lorsqu’une collection de ressources d’image conçues pour prendre en charge des paramètres de points d’écran par pouce (ppp) spécifiques est fournie à l’infrastructure du ruban par le biais d’un ensemble d’éléments 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, l’infrastructure sélectionne la valeur MinDPI la plus proche supérieure au paramètre ppp d’écran actuel et met à l’échelle la ressource image.

Exemples

L’exemple de code suivant montre le balisage requis pour déclarer, par le biais d’un ensemble d’éléments Image , une collection de ressources d’image conçues pour prendre en charge quatre paramètres ppp 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 minimum pris en charge : Windows 7
Peut être vide : Non

Voir aussi

Spécification des ressources d’image de ruban

Partager via