buttons.md

title	description	ms.assetid	keywords	ms.topic	ms.date	ms.custom
Buttons (Windows Media Player SDK)	Buttons	1212e2d9-e8f8-45d8-8c7f-20865c9c9c94	Windows Media Player Mobile skins,button overview skins,button overview reference for skins,buttons buttons in skins,about	article	4/26/2023	UpdateFrequency5

Buttons (Windows Media Player SDK)

[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

You will want to use one or more buttons in your skin, and each button must be defined in the skin definition file. If you do not define a button in this section, your skin will not be able to use it.

The buttons section of the skin definition file begins with this line:

[ Buttons ]

You then must add one or more lines that contain information about each of the buttons in your skin. A typical line might be:

    PlayPause  2PushHit   84,99,67,67   Pushed @ 44,50    Disabled @ 44,50     0,255,255  Pushed @ 160,5      Pushed @ 160,98

Note that this code should be typed as one line starting with "PlayPause" and ending with "Pushed @ 160,98".

You can use the following template for the Button section of your skin definition file:

//  <Function> <Type>     <Location>     <Push Image Src> <Dis Image Src>    <Hit R,G,B> <Norm 2 Image Src> <Push 2 Image Src>
//  ---------- ------     ----------     ---------------- ---------------    ----------- ------------------ ------------------

Again, note that these should be typed as single lines, the first starting with "// <Function>" and ending with "<Push 2 Image Src>". The second line starts with "// ----------" and ends with "------------------."

Button information for each line in the Button section must appear in the following order. Only the first six parts of the line are required. Secondary images are not included unless they are needed.

1. Button Function
2. Button Type
3. Button Location
4. Pushed Image Source
5. Image Source for Disabled Button
6. Hit RGB Color
7. Normal Secondary Image Source
8. Normal Tertiary Image Source
9. Pushed Secondary Image Source
10. Pushed Tertiary Image Source

For an example of button code, see Sample Button Section.

Related topics

Skin Reference