BitmapFrame.Create Метод

Ссылка

Определение

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

Сборка:: PresentationCore.dll

Важно!

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

Создает новый объект BitmapFrame на основе переданных аргументов.

Перегрузки

Create(Stream)	Создает новый объект BitmapFrame из заданного Stream.
Create(Uri)	Создает новый объект BitmapFrame из заданного Uri.
Create(BitmapSource)	Создает новый объект BitmapFrame из заданного BitmapSource.
Create(Uri, RequestCachePolicy)	Создает объект BitmapFrame из заданного объекта Uri с указанным параметром RequestCachePolicy.
Create(BitmapSource, BitmapSource)	Создает новый объект BitmapFrame из заданного объекта BitmapSource с указанным эскизом.
Create(Stream, BitmapCreateOptions, BitmapCacheOption)	Создает новый объект BitmapFrame из заданного объекта Stream с указанными параметрами BitmapCreateOptions и BitmapCacheOption.
Create(Uri, BitmapCreateOptions, BitmapCacheOption)	Создает объект BitmapFrame из заданного объекта Uri с указанными параметрами BitmapCreateOptions и BitmapCacheOption.
Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)	Создает объект BitmapFrame из заданного объекта Uri с указанными параметрами BitmapCreateOptions, BitmapCacheOption и RequestCachePolicy.
Create(BitmapSource, BitmapSource, BitmapMetadata, ReadOnlyCollection<ColorContext>)	Создает объект BitmapFrame из заданного источника BitmapSource с помощью указанных эскиза, BitmapMetadata и ColorContext.

Create(Stream)

Создает новый объект BitmapFrame из заданного Stream.

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(System::IO::Stream ^ bitmapStream);

public static System.Windows.Media.Imaging.BitmapFrame Create (System.IO.Stream bitmapStream);

static member Create : System.IO.Stream -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (bitmapStream As Stream) As BitmapFrame

Параметры

bitmapStream: Stream

Объект Stream, используемый для создания объекта BitmapFrame.

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

BitmapFrame

BitmapFrame из заданного Stream.

Его bitmapStream можно закрыть после создания кадра, только если используется параметр кэша OnLoad . Параметр кэша по умолчанию OnDemand сохраняет поток до тех пор, пока кадр не понадобится. Create(Stream, BitmapCreateOptions, BitmapCacheOption) Используйте метод, чтобы указать параметры создания и кэширования.

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

Create(Uri)

Создает новый объект BitmapFrame из заданного Uri.

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(Uri ^ bitmapUri);

public static System.Windows.Media.Imaging.BitmapFrame Create (Uri bitmapUri);

static member Create : Uri -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (bitmapUri As Uri) As BitmapFrame

Параметры

bitmapUri: Uri

Объект Uri, определяющий источник объекта BitmapFrame.

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

BitmapFrame

BitmapFrame из заданного Uri.

Примеры

В следующем примере кода показано, как создать объект BitmapFrame на основе заданного.Uri

int width = 128;
int height = width;
int stride = width/8;
byte[] pixels = new byte[height*stride];

// Try creating a new image with a custom palette.
List<System.Windows.Media.Color> colors = new List<System.Windows.Media.Color>();
colors.Add(System.Windows.Media.Colors.Red);
colors.Add(System.Windows.Media.Colors.Blue);
colors.Add(System.Windows.Media.Colors.Green);
BitmapPalette myPalette = new BitmapPalette(colors);

// Creates a new empty image with the pre-defined palette

BitmapSource image = BitmapSource.Create(
    width,
    height,
    96,
    96,
    PixelFormats.Indexed1,
    myPalette, 
    pixels, 
    stride);

FileStream stream = new FileStream("empty.tif", FileMode.Create);
TiffBitmapEncoder encoder = new TiffBitmapEncoder();
TextBlock myTextBlock = new TextBlock();
myTextBlock.Text = "Codec Author is: " + encoder.CodecInfo.Author.ToString();
encoder.Frames.Add(BitmapFrame.Create(image));
MessageBox.Show(myPalette.Colors.Count.ToString());
encoder.Save(stream);

Dim width As Integer = 128
Dim height As Integer = width
Dim stride As Integer = CType(width / 8, Integer)
Dim pixels(height * stride) As Byte

' Try creating a new image with a custom palette.
Dim colors As New List(Of System.Windows.Media.Color)()
colors.Add(System.Windows.Media.Colors.Red)
colors.Add(System.Windows.Media.Colors.Blue)
colors.Add(System.Windows.Media.Colors.Green)
Dim myPalette As New BitmapPalette(colors)

' Creates a new empty image with the pre-defined palette
Dim image As BitmapSource = System.Windows.Media.Imaging.BitmapSource.Create(width, height, 96, 96, PixelFormats.Indexed1, myPalette, pixels, stride)
Dim stream As New FileStream("empty.tif", FileMode.Create)
Dim encoder As New TiffBitmapEncoder()
Dim myTextBlock As New TextBlock()
myTextBlock.Text = "Codec Author is: " + encoder.CodecInfo.Author.ToString()
encoder.Frames.Add(BitmapFrame.Create(image))
MessageBox.Show(myPalette.Colors.Count.ToString())
encoder.Save(stream)

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

Create(BitmapSource)

Создает новый объект BitmapFrame из заданного BitmapSource.

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(System::Windows::Media::Imaging::BitmapSource ^ source);

public static System.Windows.Media.Imaging.BitmapFrame Create (System.Windows.Media.Imaging.BitmapSource source);

static member Create : System.Windows.Media.Imaging.BitmapSource -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (source As BitmapSource) As BitmapFrame

Параметры

source: BitmapSource

Объект BitmapSource, который используется для создания BitmapFrame.

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

BitmapFrame

BitmapFrame из заданного BitmapSource.

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

Create(Uri, RequestCachePolicy)

Создает объект BitmapFrame из заданного объекта Uri с указанным параметром RequestCachePolicy.

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(Uri ^ bitmapUri, System::Net::Cache::RequestCachePolicy ^ uriCachePolicy);

public static System.Windows.Media.Imaging.BitmapFrame Create (Uri bitmapUri, System.Net.Cache.RequestCachePolicy uriCachePolicy);

static member Create : Uri * System.Net.Cache.RequestCachePolicy -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (bitmapUri As Uri, uriCachePolicy As RequestCachePolicy) As BitmapFrame

Параметры

bitmapUri: Uri

Расположение растрового изображения, на основе которого создается объект BitmapFrame.

uriCachePolicy: RequestCachePolicy

Требования к кэшированию объекта BitmapFrame.

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

BitmapFrame

BitmapFrame из заданного Uri с заданными RequestCachePolicy.

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

Create(BitmapSource, BitmapSource)

Создает новый объект BitmapFrame из заданного объекта BitmapSource с указанным эскизом.

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(System::Windows::Media::Imaging::BitmapSource ^ source, System::Windows::Media::Imaging::BitmapSource ^ thumbnail);

public static System.Windows.Media.Imaging.BitmapFrame Create (System.Windows.Media.Imaging.BitmapSource source, System.Windows.Media.Imaging.BitmapSource thumbnail);

static member Create : System.Windows.Media.Imaging.BitmapSource * System.Windows.Media.Imaging.BitmapSource -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (source As BitmapSource, thumbnail As BitmapSource) As BitmapFrame

Параметры

source: BitmapSource

Источник, из которого создается объект BitmapFrame.

thumbnail: BitmapSource

Изображение эскиза конечного объекта BitmapFrame.

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

BitmapFrame

BitmapFrame из заданного BitmapSource с заданным эскизом.

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

Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Создает новый объект BitmapFrame из заданного объекта Stream с указанными параметрами BitmapCreateOptions и BitmapCacheOption.

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(System::IO::Stream ^ bitmapStream, System::Windows::Media::Imaging::BitmapCreateOptions createOptions, System::Windows::Media::Imaging::BitmapCacheOption cacheOption);

public static System.Windows.Media.Imaging.BitmapFrame Create (System.IO.Stream bitmapStream, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption);

static member Create : System.IO.Stream * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (bitmapStream As Stream, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption) As BitmapFrame

Параметры

bitmapStream: Stream

Поток, из которого создается объект BitmapFrame.

createOptions: BitmapCreateOptions

Параметры, которые используются для создания объекта BitmapFrame.

cacheOption: BitmapCacheOption

Вариант кэширования, который используется для создания объекта BitmapFrame.

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

BitmapFrame

BitmapFrame из заданных Stream с заданными BitmapCreateOptions и BitmapCacheOption.

OnLoad Используйте параметр кэша, если вы хотите закрыть bitmapStream после создания растрового изображения. Параметр кэша по умолчанию OnDemand сохраняет доступ к потоку, пока не потребуется растровое изображение и очистка не будет обработана сборщиком мусора.

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

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

Создает объект BitmapFrame из заданного объекта Uri с указанными параметрами BitmapCreateOptions и BitmapCacheOption.

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(Uri ^ bitmapUri, System::Windows::Media::Imaging::BitmapCreateOptions createOptions, System::Windows::Media::Imaging::BitmapCacheOption cacheOption);

public static System.Windows.Media.Imaging.BitmapFrame Create (Uri bitmapUri, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption);

static member Create : Uri * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (bitmapUri As Uri, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption) As BitmapFrame

Параметры

bitmapUri: Uri

Расположение растрового изображения, на основе которого создается объект BitmapFrame.

createOptions: BitmapCreateOptions

Параметры, которые используются для создания объекта BitmapFrame.

cacheOption: BitmapCacheOption

Вариант кэширования, который используется для создания объекта BitmapFrame.

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

BitmapFrame

BitmapFrame из заданных Uri с заданными BitmapCreateOptions и BitmapCacheOption.

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

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Создает объект BitmapFrame из заданного объекта Uri с указанными параметрами BitmapCreateOptions, BitmapCacheOption и RequestCachePolicy.

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(Uri ^ bitmapUri, System::Windows::Media::Imaging::BitmapCreateOptions createOptions, System::Windows::Media::Imaging::BitmapCacheOption cacheOption, System::Net::Cache::RequestCachePolicy ^ uriCachePolicy);

public static System.Windows.Media.Imaging.BitmapFrame Create (Uri bitmapUri, System.Windows.Media.Imaging.BitmapCreateOptions createOptions, System.Windows.Media.Imaging.BitmapCacheOption cacheOption, System.Net.Cache.RequestCachePolicy uriCachePolicy);

static member Create : Uri * System.Windows.Media.Imaging.BitmapCreateOptions * System.Windows.Media.Imaging.BitmapCacheOption * System.Net.Cache.RequestCachePolicy -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (bitmapUri As Uri, createOptions As BitmapCreateOptions, cacheOption As BitmapCacheOption, uriCachePolicy As RequestCachePolicy) As BitmapFrame

Параметры

bitmapUri: Uri

Расположение растрового изображения, на основе которого создается объект BitmapFrame.

createOptions: BitmapCreateOptions

Параметры, которые используются для создания объекта BitmapFrame.

cacheOption: BitmapCacheOption

Вариант кэширования, который используется для создания объекта BitmapFrame.

uriCachePolicy: RequestCachePolicy

Требования к кэшированию объекта BitmapFrame.

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

BitmapFrame

BitmapFrame из заданного Uri с заданными BitmapCreateOptions, BitmapCacheOption и RequestCachePolicy.

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

Create(BitmapSource, BitmapSource, BitmapMetadata, ReadOnlyCollection<ColorContext>)

Создает объект BitmapFrame из заданного источника BitmapSource с помощью указанных эскиза, BitmapMetadata и ColorContext.

public:
 static System::Windows::Media::Imaging::BitmapFrame ^ Create(System::Windows::Media::Imaging::BitmapSource ^ source, System::Windows::Media::Imaging::BitmapSource ^ thumbnail, System::Windows::Media::Imaging::BitmapMetadata ^ metadata, System::Collections::ObjectModel::ReadOnlyCollection<System::Windows::Media::ColorContext ^> ^ colorContexts);

public static System.Windows.Media.Imaging.BitmapFrame Create (System.Windows.Media.Imaging.BitmapSource source, System.Windows.Media.Imaging.BitmapSource thumbnail, System.Windows.Media.Imaging.BitmapMetadata metadata, System.Collections.ObjectModel.ReadOnlyCollection<System.Windows.Media.ColorContext> colorContexts);

static member Create : System.Windows.Media.Imaging.BitmapSource * System.Windows.Media.Imaging.BitmapSource * System.Windows.Media.Imaging.BitmapMetadata * System.Collections.ObjectModel.ReadOnlyCollection<System.Windows.Media.ColorContext> -> System.Windows.Media.Imaging.BitmapFrame

Public Shared Function Create (source As BitmapSource, thumbnail As BitmapSource, metadata As BitmapMetadata, colorContexts As ReadOnlyCollection(Of ColorContext)) As BitmapFrame

Параметры

source: BitmapSource

Объект BitmapSource, который используется для создания BitmapFrame.

thumbnail: BitmapSource

Изображение эскиза конечного объекта BitmapFrame.

metadata: BitmapMetadata

Метаданные для связи с BitmapFrame.

colorContexts: ReadOnlyCollection<ColorContext>

Объекты ColorContext, связанные с BitmapFrame.

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

BitmapFrame

BitmapFrame из заданного объекта BitmapSource с указанным эскизом, BitmapMetadata и ColorContext.

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

Поделиться через

BitmapFrame.Create Метод

Определение

Перегрузки

Create(Stream)

Параметры

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

Комментарии

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

Create(Uri)

Параметры

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

Примеры

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

Create(BitmapSource)

Параметры

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

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

Create(Uri, RequestCachePolicy)

Параметры

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

Комментарии

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

Create(BitmapSource, BitmapSource)

Параметры

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

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

Create(Stream, BitmapCreateOptions, BitmapCacheOption)

Параметры

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

Комментарии

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

Create(Uri, BitmapCreateOptions, BitmapCacheOption)

Параметры

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

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

Create(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy)

Параметры

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

Комментарии

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

Create(BitmapSource, BitmapSource, BitmapMetadata, ReadOnlyCollection<ColorContext>)

Параметры

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

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

Дополнительные ресурсы