Compartilhar via


Media.durationString

[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 durationString recupera um valor String que indica a duração do item de mídia atual no formato HH:MM:SS.

Sintaxe

player. currentMedia. durationString

Valores possíveis

Essa propriedade é uma cadeia de caracteres somente leitura.

Comentários

Se essa propriedade for usada com um item de mídia diferente do especificado no Player. currentMedia, ele pode não conter um valor válido. Se o item de mídia tiver menos de uma hora, a parte HH: do valor retornado será omitida.

Para recuperar o valor dessa propriedade, o acesso de leitura à biblioteca é necessário. Para obter mais informações, consulte Acesso à biblioteca.

Exemplos

O exemplo de JScript a seguir usa Mídia. durationString para exibir a duração do item de mídia atual como texto formatado. Um elemento DIV HTML chamado MediaInfo exibe as informações de duração. O objeto Player foi criado com ID = "Player".

<!-- Create an event handler to update the display when
 the current media item changes. -->
<SCRIPT LANGUAGE = "JScript"  FOR = Player  EVENT = OpenStateChange(NewState)>

// Test whether the new media item is open.
if (NewState == 13){

   // Write the formatted duration string to the DIV region.
   MediaInfo.innerHTML = "Duration: " + Player.currentMedia.durationString;
}
</SCRIPT>

Requisitos

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

Confira também

Objeto Media

Media.duration

Player.currentMedia

Settings.mediaAccessRights

Settings.requestMediaAccessRights