BitmapEncoder.GoToNextFrameAsync Метод

Определение

Пространство имен:

Windows.Graphics.Imaging

Перегрузки

GoToNextFrameAsync()	Асинхронно фиксирует данные текущего кадра и добавляет новый пустой кадр для редактирования.
GoToNextFrameAsync(IIterable<KeyValuePair<String,BitmapTypedValue>>)	Асинхронно фиксирует данные текущего кадра и добавляет новый пустой кадр с указанными параметрами кодирования для редактирования.

GoToNextFrameAsync()

Асинхронно фиксирует данные текущего кадра и добавляет новый пустой кадр для редактирования.

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

Возвращаемое значение

IAsyncAction

Объект , который управляет асинхронной операцией фиксации данных текущего кадра и добавления нового пустого кадра для редактирования.

Атрибуты

OverloadAttribute RemoteAsyncAttribute

Комментарии

После вызова этого метода данные в только что зафиксированном кадре больше не будут доступны. Вместо этого к изображению добавляется новый пустой кадр, и последующие операции чтения и записи в BitmapEncoder будут обращаться к этому кадру. Вы не можете "перемотать" к ранее зафиксированным кадрам.

Не вызывайте этот метод, если текущий кадр предназначен для последнего кадра на изображении, так как это приведет к созданию лишнего пустого кадра в конце изображения. Вместо этого вызовите FlushAsync , который зафиксует кадр и закроет весь BitmapEncoder. Например, в большинстве случаев приложению требуется сохранить только однокадровый образ. В таких случаях никогда не следует вызывать GoToNextFrameAsync.

При первом вызове этого метода фиксируется все данные уровня контейнера, а также данные первого кадра. После этого все попытки получить доступ к данным на уровне контейнера завершатся сбоем.

См. также раздел

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

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

Асинхронно фиксирует данные текущего кадра и добавляет новый пустой кадр с указанными параметрами кодирования для редактирования.

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

Параметры

encodingOptions

IIterable<IKeyValuePair<String,BitmapTypedValue>>

IEnumerable<KeyValuePair<String,BitmapTypedValue>>

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

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

Указанные параметры кодирования. Коллекция пар "ключ-значение", содержащая один или несколько параметров кодирования для кодека и требуемые значения.

Возвращаемое значение

IAsyncAction

Объект , который управляет асинхронной операцией фиксации данных текущего кадра и добавления нового пустого кадра для редактирования.

Атрибуты

OverloadAttribute RemoteAsyncAttribute

Комментарии

Вы можете получить коллекцию пар "ключ-значение", которые можно передать в параметр encodingOptions , создав новый bitmapPropertySet.

Дополнительные сведения об использовании параметров кодирования см. в статье CreateAsync(Guid, IRandomAccessStream, IIterable(IKeyValuePair)).

См. также раздел

• BitmapPropertySet
• GoToNextFrameAsync()