Regionsdateien

  • Artikel

[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.]

Regionsdateien sind erforderlich, wenn Sie eine beliebige Art von Trefferschaltfläche (2PushHit, PushHit oder ToggleHit) verwenden.

Regionsdateien werden verwendet, um Bereiche zu definieren, die auf ein Tippen (auch als Treffer bezeichnet) auf einer bestimmten Schaltfläche reagieren. Für jede Trefferschaltfläche erhält ein Bereich in der Bitmap Region eine bestimmte Webfarbe (z. B. #FF0000, was der Wert für einfarbiges Rot ist). Die Farbzahl wird in der Regionsschaltfläche-Definition angegeben. Wenn der Benutzer die Skin anzeigt, wird das Schaltflächenbild mithilfe der Koordinaten des Bereichs in der Bitmap Region im Hintergrund überlagert.

Sie könnten beispielsweise einen roten Kreis an einer Position zeichnen, die der Position der Schaltfläche Weiter entspricht, und sie einfarbig rot (#FF0000) einfärben. Anschließend können Sie in der Schaltflächendefinition den RGB-Trefferwert 255,0,0 zuweisen (dies ist das RGB-Äquivalent zu #FF0000). In diesem Fall reagiert die Schaltfläche Weiter nur auf Tippen (Treffer) innerhalb des roten Kreises.

Trefferschaltflächen werden verwendet, wenn Sie andere Formen als Rechtecke definieren möchten. Sie müssen weiterhin die Koordinaten für jede Schaltfläche definieren, damit sekundäre Bilder wie Pushed und Disabled korrekt lokalisiert werden können. In der Praxis ist jede Schaltfläche durch ein Rechteck begrenzt, und diese imaginären Begrenzungsrechtecke dürfen sich nicht überlappen.

Hinweis

Regionsartdateien werden in Windows Medienwiedergabe 10 Mobile-Skins nicht benötigt, da Schaltflächentypen in Windows Medienwiedergabe 10 Mobile oder höher nicht unterstützt werden.

 

Die folgende Abbildung ist eine typische Region-Datei.

Regionsdatei

Diese Datei definiert die Teile der Skin für jede Treffertypschaltfläche. Jede Farbe wird durch ihre Farbnummer im Abschnitt Schaltflächen der Skindefinitionsdatei identifiziert.

Kunstdateien