Freigeben über

Image-Element

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

  • Last updated on