RenderTargetBitmap Класс

Определение

Пространство имен:: System.Windows.Media.Imaging

Сборка:: PresentationCore.dll

Важно!

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

Visual Преобразует объект в растровое изображение.

public ref class RenderTargetBitmap sealed : System::Windows::Media::Imaging::BitmapSource

public sealed class RenderTargetBitmap : System.Windows.Media.Imaging.BitmapSource

type RenderTargetBitmap = class
    inherit BitmapSource

Public NotInheritable Class RenderTargetBitmap
Inherits BitmapSource

Наследование: Object

DispatcherObject

DependencyObject

Freezable

Animatable

ImageSource

BitmapSource
RenderTargetBitmap

Примеры

В следующем примере показано, как использовать RenderTargetBitmap для отрисовки текста в виде изображения.

using System;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Globalization;

namespace SDKSample
{
    public partial class RenderTargetBitmapExample : Page
    {
        public RenderTargetBitmapExample()
        {

            Image myImage = new Image();
            FormattedText text = new FormattedText("ABC",
                    new CultureInfo("en-us"),
                    FlowDirection.LeftToRight,
                    new Typeface(this.FontFamily, FontStyles.Normal, FontWeights.Normal, new FontStretch()),
                    this.FontSize,
                    this.Foreground);

            DrawingVisual drawingVisual = new DrawingVisual();
            DrawingContext drawingContext = drawingVisual.RenderOpen();
            drawingContext.DrawText(text, new Point(2, 2));
            drawingContext.Close();

            RenderTargetBitmap bmp = new RenderTargetBitmap(180, 180, 120, 96, PixelFormats.Pbgra32);
            bmp.Render(drawingVisual);
            myImage.Source = bmp;

            // Add Image to the UI
            StackPanel myStackPanel = new StackPanel();
            myStackPanel.Children.Add(myImage);
            this.Content = myStackPanel;
        }
    }
}

Imports System.Windows
Imports System.Windows.Controls
Imports System.Windows.Media
Imports System.Windows.Media.Imaging
Imports System.Globalization

Namespace SDKSample

    Class RenderTargetBitmapExample
        Inherits Page

        Public Sub New()

            Dim myImage As New Image()
            Dim [text] As New FormattedText("ABC", New CultureInfo("en-us"), System.Windows.FlowDirection.LeftToRight, New Typeface(Me.FontFamily, FontStyles.Normal, FontWeights.Normal, New FontStretch()), Me.FontSize, Me.Foreground)

            Dim drawingVisual As New DrawingVisual()
            Dim drawingContext As DrawingContext = drawingVisual.RenderOpen()
            drawingContext.DrawText([text], New System.Windows.Point(2, 2))
            drawingContext.Close()

            Dim bmp As New RenderTargetBitmap(180, 180, 120, 96, PixelFormats.Pbgra32)
            bmp.Render(drawingVisual)
            myImage.Source = bmp
            ' Add Image to the UI
            Dim myStackPanel As New StackPanel()
            myStackPanel.Children.Add(myImage)
            Me.Content = myStackPanel

        End Sub
    End Class
End Namespace 'ImagingSnippetGallery

Конструкторы

Имя	Описание
RenderTargetBitmap(Int32, Int32, Double, Double, PixelFormat)	Инициализирует новый экземпляр RenderTargetBitmap класса с указанными параметрами.

Свойства

Имя	Описание
CanFreeze	Возвращает значение, указывающее, можно ли изменить объект. (Унаследовано от Freezable)
DependencyObjectType	Возвращает объект DependencyObjectType , который упаковывает тип СРЕДЫ CLR этого экземпляра. (Унаследовано от DependencyObject)
Dispatcher	Dispatcher Возвращает это DispatcherObject значение, с которым связано. (Унаследовано от DispatcherObject)
DpiX	Получает горизонтальные точки на дюйм (dpi) изображения. (Унаследовано от BitmapSource)
DpiY	Получает вертикальные точки на дюйм (dpi) изображения. (Унаследовано от BitmapSource)
Format	Возвращает собственный PixelFormat код данных растрового изображения. (Унаследовано от BitmapSource)
HasAnimatedProperties	Возвращает значение, указывающее, связан ли один или несколько AnimationClock объектов с любым из свойств зависимостей этого объекта. (Унаследовано от Animatable)
Height	Получает высоту исходного растрового изображения в устройствах независимо от устройства (1/96-й дюйм на единицу). (Унаследовано от BitmapSource)
IsDownloading	Возвращает значение, указывающее, загружается ли BitmapSource содержимое в данный момент. (Унаследовано от BitmapSource)
IsFrozen	Возвращает значение, указывающее, является ли объект изменяемым в настоящее время. (Унаследовано от Freezable)
IsSealed	Возвращает значение, указывающее, запечатан ли этот экземпляр (только для чтения). (Унаследовано от DependencyObject)
Metadata	Возвращает метаданные, связанные с этим растровым изображением. (Унаследовано от BitmapSource)
Palette	Возвращает цветовую палитру растрового изображения, если он указан. (Унаследовано от BitmapSource)
PixelHeight	Возвращает высоту растрового изображения в пикселях. (Унаследовано от BitmapSource)
PixelWidth	Возвращает ширину растрового изображения в пикселях. (Унаследовано от BitmapSource)
Width	Получает ширину растрового изображения в единицах, независимых от устройства (1/96-й дюйм на единицу). (Унаследовано от BitmapSource)

Методы

Имя	Описание
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Применяется к указанному объекту AnimationClock DependencyProperty. Если свойство уже анимировано, используется указанный HandoffBehavior параметр. (Унаследовано от Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Применяется к указанному объекту AnimationClock DependencyProperty. Если свойство уже анимировано, SnapshotAndReplace используется поведение передачи. (Унаследовано от Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Применяет анимацию к указанному DependencyProperty. Анимация запускается при отрисовки следующего кадра. Если указанное свойство уже анимировано, используется указанный HandoffBehavior параметр. (Унаследовано от Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Применяет анимацию к указанному DependencyProperty. Анимация запускается при отрисовки следующего кадра. Если указанное свойство уже анимировано, SnapshotAndReplace используется поведение передачи. (Унаследовано от Animatable)
CheckAccess()	Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)
CheckIfSiteOfOrigin()	Проверяет, находится ли исходное содержимое растрового изображения из известного сайта источника. Этот метод используется для обеспечения безопасности операций копирования пикселей. (Унаследовано от BitmapSource)
Clear()	Очищает целевой объект отрисовки и задает все пиксели прозрачным черным.
ClearValue(DependencyProperty)	Очищает локальное значение свойства. Свойство для очистки указывается идентификатором DependencyProperty . (Унаследовано от DependencyObject)
ClearValue(DependencyPropertyKey)	Очищает локальное значение свойства только для чтения. Свойство, которое необходимо очистить, задается параметром DependencyPropertyKey. (Унаследовано от DependencyObject)
Clone()	Создает модификаторный клон этого BitmapSourceобъекта, делая глубокие копии значений этого объекта. При копировании свойств зависимостей этот метод копирует ссылки на ресурсы и привязки данных (но они больше не могут разрешаться), но не анимации или их текущие значения. (Унаследовано от BitmapSource)
CloneCore(Freezable)	Делает этот экземпляр глубокой копией указанного BitmapSource. При копировании свойств зависимостей этот метод копирует ссылки на ресурсы и привязки данных (но они больше не могут разрешаться), но не анимации или их текущие значения. (Унаследовано от BitmapSource)
CloneCurrentValue()	Создает модификаторный клон этого объекта, делая глубокие копии текущих значений этого BitmapSource объекта. Ссылки на ресурсы, привязки данных и анимации не копируются, но их текущие значения. (Унаследовано от BitmapSource)
CloneCurrentValueCore(Freezable)	Делает этот экземпляр изменяемым глубоким копированием указанного BitmapSource с использованием текущих значений свойств. Ссылки на ресурсы, привязки данных и анимации не копируются, но их текущие значения. (Унаследовано от BitmapSource)
CoerceValue(DependencyProperty)	Принуждает значение указанного свойства зависимостей. Это достигается путем вызова любой CoerceValueCallback функции, указанной в метаданных свойств для свойства зависимостей, так как он существует при вызове DependencyObject. (Унаследовано от DependencyObject)
CopyPixels(Array, Int32, Int32)	Копирует данные пикселя растрового изображения в массив пикселей с указанным шагом, начиная с указанного смещения. (Унаследовано от BitmapSource)
CopyPixels(Int32Rect, Array, Int32, Int32)	Копирует данные пикселя растрового изображения в указанном прямоугольнике в массив пикселей с указанным шагом, начиная с указанного смещения. (Унаследовано от BitmapSource)
CopyPixels(Int32Rect, IntPtr, Int32, Int32)	Копирует данные пикселя растрового изображения в указанном прямоугольнике. (Унаследовано от BitmapSource)
CreateInstance()	Инициализирует новый экземпляр класса Freezable. (Унаследовано от Freezable)
CreateInstanceCore()	При реализации в производном классе создает новый экземпляр производного Freezable класса. (Унаследовано от Freezable)
Equals(Object)	Определяет, эквивалентен ли предоставленный DependencyObject объект текущему DependencyObject. (Унаследовано от DependencyObject)
Freeze()	Делает текущий объект неизменяемым и задает для свойства значение IsFrozen`true`. (Унаследовано от Freezable)
FreezeCore(Boolean)	Делает экземпляр BitmapSource или производный класс неизменяемым. (Унаследовано от BitmapSource)
GetAnimationBaseValue(DependencyProperty)	Возвращает неанимированное значение указанного DependencyProperty. (Унаследовано от Animatable)
GetAsFrozen()	Создает замороженную копию базовых Freezable(не анимированных) значений свойств. Так как копия заморожена, все замороженные вложенные объекты копируются по ссылке. (Унаследовано от Freezable)
GetAsFrozenCore(Freezable)	Делает этот экземпляр клоном указанного BitmapSource объекта. (Унаследовано от BitmapSource)
GetCurrentValueAsFrozen()	Создает замороженную копию с использованием текущих значений Freezable свойств. Так как копия заморожена, все замороженные вложенные объекты копируются по ссылке. (Унаследовано от Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Делает этот экземпляр замороженным клоном указанного.BitmapSource Ссылки на ресурсы, привязки данных и анимации не копируются, но их текущие значения. (Унаследовано от BitmapSource)
GetHashCode()	Получает хэш-код для этого DependencyObject. (Унаследовано от DependencyObject)
GetLocalValueEnumerator()	Создает специализированный перечислитель для определения того, какие свойства зависимостей имеют локальные значения для этого DependencyObject. (Унаследовано от DependencyObject)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
GetValue(DependencyProperty)	Возвращает текущее эффективное значение свойства зависимостей для этого экземпляра DependencyObject. (Унаследовано от DependencyObject)
InvalidateProperty(DependencyProperty)	Повторно вычисляет эффективное значение для указанного свойства зависимостей. (Унаследовано от DependencyObject)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
OnChanged()	Вызывается при изменении текущего Freezable объекта. (Унаследовано от Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Этот член поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для использования непосредственно из кода. (Унаследовано от Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Убедитесь, что для элемента данных, который только что был установлен, установлены DependencyObjectType соответствующие указатели контекста. (Унаследовано от Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Переопределяет DependencyObject реализацию OnPropertyChanged(DependencyPropertyChangedEventArgs) для вызова всех Changed обработчиков в ответ на изменение свойства зависимостей типа Freezable. (Унаследовано от Freezable)
ReadLocalValue(DependencyProperty)	Возвращает локальное значение свойства зависимостей, если оно существует. (Унаследовано от DependencyObject)
ReadPreamble()	Гарантирует, что Freezable доступ к ней осуществляется из допустимого потока. Наследующие метод Freezable должны вызывать этот метод в начале любого API, который считывает элементы данных, которые не являются свойствами зависимостей. (Унаследовано от Freezable)
Render(Visual)	Отрисовывает Visual объект.
SetCurrentValue(DependencyProperty, Object)	Задает значение свойства зависимостей, не изменяя его источник значений. (Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)	Задает локальное значение свойства зависимостей, указанное его идентификатором свойства зависимостей. (Унаследовано от DependencyObject)
SetValue(DependencyPropertyKey, Object)	Задает локальное значение свойства зависимостей только для чтения, указанное DependencyPropertyKey идентификатором свойства зависимости. (Унаследовано от DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Возвращает значение, указывающее, должны ли процессы сериализации сериализовать значение для указанного свойства зависимостей. (Унаследовано от DependencyObject)
ToString()	Создает строковое представление этого объекта на основе текущего языка и региональных параметров. (Унаследовано от ImageSource)
ToString(IFormatProvider)	Создает строковое представление этого объекта на основе переданного IFormatProvider объекта. Если поставщик имеет значение `null`, CurrentCulture используется. (Унаследовано от ImageSource)
VerifyAccess()	Принудительно применяет, что вызывающий поток имеет доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)
WritePostscript()	Changed Вызывает событие для Freezable метода и вызывает его OnChanged() метод. Классы, производные от Freezable этого метода, должны вызываться в конце любого API, который изменяет элементы класса, которые не хранятся в качестве свойств зависимостей. (Унаследовано от Freezable)
WritePreamble()	Проверяет, что Freezable он не заморожен и к нему осуществляется доступ из допустимого контекста потоков. Freezable наследующие метод должны вызывать этот метод в начале любого API, записывающего элементы данных, которые не являются свойствами зависимостей. (Унаследовано от Freezable)

События

Имя	Описание
Changed	Происходит при Freezable изменении объекта или объекта, содержащего его. (Унаследовано от Freezable)
DecodeFailed	Происходит при сбое загрузки изображения из-за поврежденного заголовка образа. (Унаследовано от BitmapSource)
DownloadCompleted	Происходит, когда содержимое растрового изображения было полностью загружено. (Унаследовано от BitmapSource)
DownloadFailed	Происходит при сбое скачивания содержимого растрового изображения. (Унаследовано от BitmapSource)
DownloadProgress	Происходит при изменении хода скачивания содержимого растрового изображения. (Унаследовано от BitmapSource)

Явные реализации интерфейса

Имя	Описание
IFormattable.ToString(String, IFormatProvider)	Форматирует значение текущего экземпляра с помощью указанного формата. (Унаследовано от ImageSource)

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?