Partilhar via


MediaElement.Position Propriedade

Definição

Obtém ou define a posição atual do progresso ao longo do tempo de reprodução da mídia.

public:
 property TimeSpan Position { TimeSpan get(); void set(TimeSpan value); };
TimeSpan Position();

void Position(TimeSpan value);
public System.TimeSpan Position { get; set; }
var timeSpan = mediaElement.position;
mediaElement.position = timeSpan;
Public Property Position As TimeSpan

Valor da propriedade

A quantidade de tempo desde o início da mídia. O padrão é um TimeSpan com o valor "0:0:0".

Comentários

Defina essa propriedade para definir uma posição de início de reprodução específica dentro da mídia.

Um TimeSpan é representado como tipos diferentes, dependendo da linguagem de programação que você está usando.

C# ou Microsoft Visual Basic Use uma estrutura System.TimeSpan . System.TimeSpan tem membros utilitários como Parse(String) que facilitam a criação, alteração ou comparação de valores de tempo.

Extensões de componente do Visual C++ (C++/CX) Use uma estrutura Windows::Foundation::TimeSpan . Essa estrutura tem apenas um membro de campo (Duração), que mede por unidades de 100 nanossegundos. Se você pretende exibir um valor Position em um formato hours:minutes:seconds, precisará escrever sua própria lógica para converter para esse formato a partir das unidades duration .

Se você não tiver certeza da fonte de mídia atual carregada como MediaElement.Source, sempre marcar CanSeek primeiro. Uma fonte de mídia de streaming resulta no Relatório MediaElementCanSeek como false e, nesse caso, você não pode usar Position para definir o ponto de reprodução.

Se Position for configurável, essas restrições de valor se aplicarão:

  • Se Position for definido como um valor negativo, o valor será reverter para um TimeSpan com o valor "0:0:0".
  • Se Position for definido como um valor maior que NaturalDuration da mídia, Position se tornará o valor de NaturalDuration.

Observações sobre a sintaxe XAML

Definir um valor position em XAML é tecnicamente possível, mas não é comum. Se você definir uma Posição em XAML, simule o comportamento de conversão de tipo "FromString" para um TimeSpan, em outras palavras, especifique o valor no formato "HH:MM:SS".

Aplica-se a

Confira também