BUTTONGROUP.mappingImage

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer ersetzt. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, nach Möglichkeit für neuen Code MediaPlayer anstelle von Windows Medienwiedergabe SDK zu verwenden. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Das attribut mappingImage gibt den Namen des Bilds an, das die Schaltflächenzuordnung der BUTTONGROUP darstellt, oder ruft diese ab.

        elementID.mappingImage

Mögliche Werte

Bei diesem Attribut handelt es sich um eine Zeichenfolge mit Lese-/Schreibzugriff.

Bemerkungen

Dies ist ein obligatorisches Attribut, das angegeben werden muss.

Das Zuordnungsbild sollte dieselben Dimensionen wie das Standard Bilds aufweisen. Es handelt sich um eine Karte der anklickbaren Bereiche des Standard Bilds. Erstellen Sie die Karte, indem Sie jeden klickbaren Bereich mit einer anderen Farbe füllen.

Wenn Sie jedes BUTTONELEMENT definieren, legen Sie ihre Farbe aus der Karte mithilfe des attributs mappingColor fest. Wenn Sie z. B. eine Schaltflächengrafik im Standard haben, können Sie eine Karte mit dem Rot gefärbten Bereich des Zeichens erstellen. Das BUTTONELEMENT-Attribut muss dann als rot angegeben werden, damit das Stoppzeichenbild geklickt werden kann.

Die unterstützten Bildformate sind BMP, JPG, PNG und GIF (ohne animierte GIFs). Da JPGs verlustbehaftet sind und daher unerwarteten Farbänderungen unterliegen, werden sie nicht für die Zuordnung von Bildern empfohlen.

Beispiele

Die folgende Abbildung zeigt ein Beispiel für ein mappingImage und das sichtbare Bild, dem es entspricht. Diese Bilder sind Teil der Skin im Ordner Tiny, der im SDK enthalten ist.

Weitere Informationen finden Sie unter BUTTONELEMENT. mappingColor-Attribut für ein Codebeispiel, das die Verwendung dieses Attributs veranschaulicht.

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe Version 7.0 oder höher

Siehe auch

BUTTONELEMENT.mappingColor

BUTTONGROUP-Element

BUTTONGROUP.image

BUTTONGROUP.transparencyColor