BitmapEncoder.GoToNextFrameAsync Método

Definição

Namespace:

Windows.Graphics.Imaging

Sobrecargas

GoToNextFrameAsync()	Confirma de forma assíncrona os dados de quadro atuais e acrescenta um novo quadro vazio a ser editado.
GoToNextFrameAsync(IIterable<KeyValuePair<String,BitmapTypedValue>>)	Confirma de forma assíncrona os dados de quadro atuais e acrescenta um novo quadro vazio, com as opções de codificação especificadas, a serem editadas.

GoToNextFrameAsync()

Confirma de forma assíncrona os dados de quadro atuais e acrescenta um novo quadro vazio a ser editado.

public:
 virtual IAsyncAction ^ GoToNextFrameAsync() = GoToNextFrameAsync;

/// [Windows.Foundation.Metadata.Overload("GoToNextFrameAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction GoToNextFrameAsync();

[Windows.Foundation.Metadata.Overload("GoToNextFrameAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction GoToNextFrameAsync();

function goToNextFrameAsync()

Public Function GoToNextFrameAsync () As IAsyncAction

Retornos

IAsyncAction

Um objeto que gerencia a operação assíncrona de confirmar os dados do quadro atual e acrescentar um novo quadro vazio a ser editado.

Atributos

OverloadAttribute RemoteAsyncAttribute

Comentários

Depois que esse método é chamado, os dados no quadro just-committed não são mais acessíveis. Em vez disso, um novo quadro vazio é acrescentado à imagem e as leituras e gravações subsequentes no BitmapEncoder acessarão esse quadro. Você não pode "retroceder" para um quadro confirmado anteriormente.

Não chame esse método se o quadro atual for destinado a ser o último quadro na imagem, pois isso resultará em um quadro vazio supérfluo no final da imagem. Em vez disso, chame FlushAsync , que confirmará o quadro e fechará todo o BitmapEncoder. Por exemplo, na maioria dos cenários, o aplicativo só precisa salvar uma imagem de quadro único. Nesses casos, GoToNextFrameAsync nunca deve ser chamado.

Na primeira vez que esse método for chamado, todos os dados no nível do contêiner, bem como os dados do primeiro quadro, serão confirmados. Posteriormente, todas as tentativas de acessar dados no nível do contêiner falharão.

Confira também

• GoToNextFrameAsync(IIterable<KeyValuePair<String,BitmapTypedValue>>)

GoToNextFrameAsync(IIterable<KeyValuePair<String,BitmapTypedValue>>)

Confirma de forma assíncrona os dados de quadro atuais e acrescenta um novo quadro vazio, com as opções de codificação especificadas, a serem editadas.

public:
 virtual IAsyncAction ^ GoToNextFrameAsync(IIterable<IKeyValuePair<Platform::String ^, BitmapTypedValue ^> ^> ^ encodingOptions) = GoToNextFrameAsync;

/// [Windows.Foundation.Metadata.Overload("GoToNextFrameWithEncodingOptionsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction GoToNextFrameAsync(IIterable<IKeyValuePair<winrt::hstring, BitmapTypedValue const&>> const& encodingOptions);

[Windows.Foundation.Metadata.Overload("GoToNextFrameWithEncodingOptionsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction GoToNextFrameAsync(IEnumerable<KeyValuePair<string,BitmapTypedValue>> encodingOptions);

function goToNextFrameAsync(encodingOptions)

Public Function GoToNextFrameAsync (encodingOptions As IEnumerable(Of KeyValuePair(Of String, BitmapTypedValue))) As IAsyncAction

Parâmetros

encodingOptions

IIterable<IKeyValuePair<String,BitmapTypedValue>>

IEnumerable<KeyValuePair<String,BitmapTypedValue>>

IIterable<IKeyValuePair<Platform::String,BitmapTypedValue>>

IIterable<IKeyValuePair<winrt::hstring,BitmapTypedValue>>

As opções de codificação especificadas. Uma coleção de pares chave-valor que contém uma ou mais opções de codificação específicas de codec e os valores desejados.

Retornos

IAsyncAction

Um objeto que gerencia a operação assíncrona de confirmar os dados do quadro atual e acrescentar um novo quadro vazio a ser editado.

Atributos

OverloadAttribute RemoteAsyncAttribute

Comentários

Você pode obter uma coleção de pares chave-valor que você pode passar para o parâmetro encodingOptions criando um novo BitmapPropertySet.

Consulte CreateAsync(Guid, IRandomAccessStream, IIterable(IKeyValuePair)) para obter mais informações sobre como usar opções de codificação.

Confira também

• BitmapPropertySet
• GoToNextFrameAsync()