RenderTargetBitmap.RenderAsync Метод

public:
 virtual IAsyncAction ^ RenderAsync(UIElement ^ element) = RenderAsync;

/// [Windows.Foundation.Metadata.Overload("RenderAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction RenderAsync(UIElement const& element);

[Windows.Foundation.Metadata.Overload("RenderAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction RenderAsync(UIElement element);

function renderAsync(element)

Public Function RenderAsync (element As UIElement) As IAsyncAction

Параметры

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

Объект IAsyncAction , который можно использовать для управления асинхронной операцией.

Атрибуты

OverloadAttribute RemoteAsyncAttribute

Комментарии

Отрисованное изображение не возвращается этим методом. Но после возврата, если значение асинхронного состояния не указывает на ошибку, объект RenderTargetBitmap , который его вызвал, будет иметь допустимые сведения об изображении. Затем RenderTargetBitmap можно назначить в коде в качестве источника изображения для элемента управления Image или экземпляра ImageBrush .

Если требуется представление отображаемого содержимого в буфере пикселей, а не только источника изображения, используйте Метод GetPixelsAsync после вызова RenderAsync.

Это асинхронный метод, поэтому нет гарантии точной синхронизации кадров с источником пользовательского интерфейса. Дополнительные сведения о некоторых других ограничениях см. в разделе Примечания в RenderTargetBitmap .

Вы можете передать значение NULL для параметра элемента , который отрисовывает корневое визуальное дерево приложения.

Визуальные элементы XAML и возможности захвата RenderTargetBitmap

Существует несколько сценариев для визуального содержимого, состоящего из XAML, которое невозможно записать в RenderTargetBitmap:

• Видеосодержимое в MediaElement или CaptureElement не может быть записано с помощью RenderTargetBitmap. Это включает в себя захват кадров из видеосодержимого.
• Пользовательское содержимое Microsoft DirectX (ваша собственная цепочка буферов) внутри SwapChainBackgroundPanel или SwapChainPanel не может быть записано с помощью RenderTargetBitmap.
• Содержимое, которое находится в дереве, но для параметра Видимость установлено значение Свернуто , не будет захватываться.
• Содержимое, которое не подключено непосредственно к визуальному дереву XAML, и содержимое окна main не будет захватываться. Сюда входит содержимое всплывающего окна , которое считается как вложенное окно.
• Для приложения Windows Phone версии 8.x содержимое элемента управления WebView не может быть отрисовано в RenderTargetBitmap.
• Содержимое, которое не может быть записано, будет отображаться как пустое на изображении, но другое содержимое в том же визуальном дереве по-прежнему может быть записано и отрисовывается (наличие содержимого, которое не может быть записано, не сделает недействительным весь захват этой композиции XAML).
• Содержимое, которое находится в визуальном дереве XAML, но за экраном, можно захватывать, если оно не = свернуто или в других ограниченных случаях.

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

• RenderAsync(UIElement, Int32, Int32)
• Пример отрисовки XAML в растровом рисунке

public:
 virtual IAsyncAction ^ RenderAsync(UIElement ^ element, int scaledWidth, int scaledHeight) = RenderAsync;

/// [Windows.Foundation.Metadata.Overload("RenderToSizeAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction RenderAsync(UIElement const& element, int const& scaledWidth, int const& scaledHeight);

[Windows.Foundation.Metadata.Overload("RenderToSizeAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction RenderAsync(UIElement element, int scaledWidth, int scaledHeight);

function renderAsync(element, scaledWidth, scaledHeight)

Public Function RenderAsync (element As UIElement, scaledWidth As Integer, scaledHeight As Integer) As IAsyncAction

Параметры

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

Объект IAsyncAction , который можно использовать для управления асинхронной операцией.

Атрибуты

OverloadAttribute RemoteAsyncAttribute

Комментарии

Отрисованное изображение не возвращается этим методом. Но после возврата, если значение асинхронного состояния не указывает на ошибку, объект RenderTargetBitmap , который его вызвал, будет иметь допустимые сведения об изображении. Затем RenderTargetBitmap можно назначить в коде в качестве источника изображения для элемента управления Image или экземпляра ImageBrush .

Если требуется представление отображаемого содержимого в буфере пикселей, а не только источника изображения, используйте Метод GetPixelsAsync после вызова RenderAsync.

Это асинхронный метод, поэтому нет гарантии точной синхронизации кадров с источником пользовательского интерфейса. Дополнительные сведения о некоторых других ограничениях см. в разделе Примечания в RenderTargetBitmap .

Вызов RenderAsync завершится ошибкой , если масштабируемая высота или ширина визуального дерева UIElement превышает объем видеопамяти, который система может выделить внутренне.

Вы можете передать значение NULL для параметра элемента , который отрисовывает корневое визуальное дерево приложения.

значения scaledWidth и scaledHeight

Если заданы значения scaledWidth и scaledHeight , пропорции исходного растрового изображения игнорируются, и ваши значения могут изменить пропорции.

Если указан параметр scaledWidth или scaledHeight , но не оба, то указанное значение определяет это измерение, но пропорции сохраняются (другое измерение вычисляется на основе разбиения пропорций исходного растрового рисунка).

Можно вызвать этот метод и оставить значения scaledWidth и scaledHeight как 0. В этом случае дерево UIElement будет отображаться в собственном размере. Это то же поведение, что и перегрузка RenderAsync(UIElement).

Максимальный размер отображаемого визуального дерева XAML ограничивается максимальными размерами текстуры Microsoft DirectX; Дополнительные сведения см. в разделе Ограничения ресурсов (). Это ограничение ресурсов может отличаться в зависимости от оборудования, на котором выполняется приложение. Очень большое содержимое, превышающее это ограничение, может быть масштабировано по размеру. Если ограничения масштабирования применяются таким образом, отображаемый размер после масштабирования можно запросить с помощью свойств PixelWidth и PixelHeight . Например, визуальное дерево XAML 10000 на 10000 пикселей может быть масштабировано до 4096 на 4096 пикселей, что является примером конкретного ограничения ресурсов для двухd-текстур.

Визуальные элементы XAML и возможности захвата RenderTargetBitmap

Существует несколько сценариев для визуального содержимого, состоящего из XAML, которое невозможно записать в RenderTargetBitmap:

• Видеосодержимое в MediaElement или CaptureElement не может быть записано с помощью RenderTargetBitmap. Это включает в себя захват кадров из видеосодержимого.
• Пользовательское содержимое Microsoft DirectX (ваша собственная цепочка буферов) внутри SwapChainBackgroundPanel или SwapChainPanel не может быть записано с помощью RenderTargetBitmap.
• Содержимое, которое находится в дереве, но для параметра Видимость установлено значение Свернуто , не будет захватываться.
• Содержимое, которое не подключено непосредственно к визуальному дереву XAML, и содержимое окна main не будет захватываться. Сюда входит содержимое всплывающего окна , которое считается как вложенное окно.
• Для приложения Windows Phone версии 8.x содержимое элемента управления WebView не может быть отрисовано в RenderTargetBitmap.
• Содержимое, которое не может быть записано, будет отображаться как пустое на изображении, но другое содержимое в том же визуальном дереве по-прежнему может быть записано и отрисовывается (наличие содержимого, которое не может быть записано, не сделает недействительным весь захват этой композиции XAML).
• Содержимое, которое находится в визуальном дереве XAML, но за экраном, можно захватывать, если оно не = свернуто или в других ограниченных случаях.

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

• RenderAsync(UIElement)
• Пример отрисовки XAML в растровом рисунке