ClosedCaption.SAMIStyle

Applies to: desktop apps only

The SAMIStyle property specifies or retrieves the closed captioning style.

player.closedCaption.SAMIStyle

Possible Values

This property is a read/write String.

Remarks

A SAMI file can contain several format style definitions. SAMI styles are defined between the <STYLE> and </STYLE> tags in the SAMI file. A style is defined with a text string preceded by a # character. For example:

#Emphasis1 {Name: Big Bold Italic; font-size: 14pt; text-align: center;
            color: blue; font-family: sans-serif; font-weight: bold;
            font-style: italic;}

This specifies a style that produces a particular font.

If no SAMI style is specified, the first style defined in the SAMI file is used by default.

Windows Media Player 10 Mobile: This property is read only, and always returns an empty string.

Examples

The following JScript example creates an HTML SELECT element that uses closedCaption.SAMIStyle to change the appearance of the closed caption text. The Player object was created with ID = "Player".

<!-- Create the SELECT element. -->
<SELECT ID = CCMode  NAME = "CCMode"  LANGUAGE = "JScript"

       /* Change the text style when the SELECT element changes. */
        onChange = "Player.closedCaption.SAMIStyle = CCMode.value;
        ">

       /* Fill the SELECT list with options, set the default to Strong. */
        <OPTION VALUE = "Normal">Normal
        <OPTION VALUE = "Small">Small 
        <OPTION VALUE = "Big Bold Italic" SELECTED>Strong
</SELECT>

Requirements

See also

Adding Closed Captions to Digital Media

ClosedCaption Object

Send comments about this topic to Microsoft

Build date: 2/15/2012