AmbientAttributes.nineGridMargins

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

The nineGridMargins attribute specifies margin widths for non-uniform scaling of the skin element.

        elementID.nineGridMargins

Possible Values

This attribute is a read/write String that contains the widths of the margins in the form "widthLeft,widthTop,widthRight,widthBottom". Each width value is a number representing the width, in pixels, of a margin for the nine grid.

Remarks

A nine grid is a technique used to divide user interface elements into nine rectangular regions arranged in a 3 by 3 matrix. When an element is resized, the nine grid regions can each scale by a different factor.

Each of the four width values you specify represents the width of a row or column of three adjacent regions. Each row or column forms the left side, top, right side, or bottom of the nine grid.

AmbientAttributes.resizeImages must be set to true for this attribute to work.

Requirements

See also

Ambient Attributes