ClosedCaption.SAMILang

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

A propriedade SAMILang especifica ou recupera o idioma exibido para legendagem oculta.

player.closedCaption.SAMILang

Valores possíveis

Essa propriedade é uma cadeia de caracteres de leitura/ gravação.

Comentários

Um arquivo SAMI pode conter texto para um ou vários idiomas. Os idiomas disponíveis para legendagem oculta são definidos entre as <marcas STYLE> e no arquivo SAMI. Um identificador de linguagem é especificado com uma cadeia de caracteres alfanumérica exclusiva precedida por um ponto (.). O nome especificado para um idioma pode ser qualquer cadeia de caracteres. Por exemplo, o seguinte pode ser usado para definir o inglês dos EUA:

.ENUSCC {Name:'English Captions' lang: en-US; SAMIType:CC;}

Se nenhuma linguagem SAMI for especificada, o primeiro idioma definido no arquivo SAMI será usado por padrão.

O valor que você passa usando ClosedCaption. SAMILang deve corresponder ao atributo Name no especificador de idioma.

Reprodutor Multimídia do Windows 10 Mobile: essa propriedade é somente leitura e sempre retorna uma cadeia de caracteres vazia.

Exemplos

O exemplo de JScript a seguir usa ClosedCaption. SAMILang em um elemento HTML SELECT para especificar a linguagem de legenda fechada. O objeto Player foi criado com ID = "Player".

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

     /* Set the closed caption language when the SELECT element changes. */
        onChange = "Player.closedCaption.SAMILang = CCLANG.value;
        ">

        /* Fill in the SELECT element options. */
           <OPTION VALUE = "'Spanish Captions'">Spanish
           <OPTION VALUE = "'Japanese Captions'">Japanese
           <OPTION VALUE = "'English Captions'">English
           <OPTION VALUE = "'French Captions'">French
           <OPTION VALUE = "'German Captions'" SELECTED>German
</SELECT>

Requisitos

Requisito	Valor
Versão	Reprodutor Multimídia do Windows versão 7.0 ou posterior.
DLL	Wmp.dll

Confira também

Adicionando legendas ocultas à mídia digital

Objeto ClosedCaption