Image-Element

Artikel
06/13/2023

Stellt ein Bild dar.

Verbrauch

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

Attribute

attribute	type	Erforderlich	BESCHREIBUNG
Id	xs:positiveInteger union xs:string	Nein	Die eindeutige Ressourcen-ID. (Die Vereinigung von xs:positiveInteger und xs:string) Ein ganzzahliger Wert zwischen 2 und 59999, einschließlich oder 0x2 und 0xea5f hexadezimal, inklusive. Die maximale Länge beträgt 10 Zeichen, einschließlich optionaler führender Nullen.
MinDPI	xs:positiveInteger	Nein	(xs:positiveInteger) Jede Sequenz von Ziffern mit einem Mindestwert von 96. Wenn MinDPI nicht angegeben wird, ist der Standardwert 96.
Quelle	xs:anyURI	Nein	(xs:anyURI) Jede Sequenz von Zeichen, die einen URI darstellt. Der URI-Wert ist ein absoluter oder relativer Pfad (zur Menübandmarkierungsdatei) zu einer Bildressource vom Typ BMP.
Symbol	xs:string	Nein	Das Ressourcensymbol für das Bild. (xs:string) Eine Zeichenfolge, die aus einem Buchstaben oder Unterstrich besteht, gefolgt von einer beliebigen Sequenz von Buchstaben, Ziffern oder Unterstrichen bis zu maximal 100 Zeichen.

Untergeordnete Elemente

Element	BESCHREIBUNG
Image.Source	Kann höchstens einmal auftreten

Übergeordnete Elemente

Element
Command.LargeHighContrastImages
Command.LargeImages
Command.SmallHighContrastImages
Command.SmallImages

Bemerkungen

Optional.

Kann für jedes Command.SmallImages-, Command.SmallHighContrastImages-, Command.LargeImages- oder Command.LargeHighContrastImages-Element ein oder mehrere Male auftreten.

Wenn eine Sammlung von Bildressourcen zur Unterstützung bestimmter Dpi-Einstellungen (Dots per Inch) für das Menübandframework über eine Reihe von Bildelementen bereitgestellt wird, verwendet das Framework das Image mit einem MinDPI-Attributwert , der der aktuellen Dpi-Einstellung des Bildschirms entspricht.

Wenn kein Image-Element mit einem MinDPI-Wert deklariert wird, der der aktuellen Bildschirm-DPI-Einstellung entspricht, wählt das Framework das Bild aus, das den nächstgelegenen MinDPI-Wert kleiner als die aktuelle Bildschirm-DPI-Einstellung aufweist, und skaliert die Bildressource hoch. Wenn andernfalls kein Image-Element mit einem MinDPI-Attributwert deklariert wird, der kleiner als die aktuelle Bildschirm-DPI-Einstellung ist, wählt das Framework den nächstgelegenen MinDPI-Wert aus, der größer als die aktuelle Bildschirm-DPI-Einstellung ist, und skaliert die Bildressource herunter.

Beispiele

Das folgende Codebeispiel zeigt das Markup, das erforderlich ist, um über eine Reihe von Image-Elementen eine Sammlung von Bildressourcen zu deklarieren, die vier bestimmte Bildschirm-DPI-Einstellungen unterstützen.

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

Elementinformationen

Unterstützte Mindestsystem: Windows 7
Kann leer sein: Nein

Siehe auch

Angeben von Menübandbildressourcen

Freigeben über