BitmapFrame.Create 方法

參考

定義

命名空間:: System.Windows.Media.Imaging

組件:: PresentationCore.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

根據提供的引數建立新的 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>)	使用指定的縮圖、BitmapMetadata 和 ColorContext，從指定的 BitmapSource 建立新的 BitmapFrame。

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。

範例

下列程式碼範例示範如何從指定的 Uri 建構 BitmapFrame 。

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

用來建構這個 BitmapFrame 的 BitmapSource。

傳回

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(Uri, RequestCachePolicy).NET Framework 3.5 版引進。如需詳細資訊，請參閱版本和相依性。

適用於

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。

備註

如果您想要在建立點陣圖之後關閉 bitmapStream ，請使用快 OnLoad 取選項。預設快 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(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy).NET Framework 3.5 版引進。如需詳細資訊，請參閱版本和相依性。

適用於

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

使用指定的縮圖、BitmapMetadata 和 ColorContext，從指定的 BitmapSource 建立新的 BitmapFrame。

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

用來建構這個 BitmapFrame 的 BitmapSource。

thumbnail: BitmapSource

產生之 BitmapFrame 的縮圖影像。

metadata: BitmapMetadata

要與這個 BitmapFrame 建立關聯的中繼資料。

colorContexts: ReadOnlyCollection<ColorContext>

與這個 BitmapFrame 相關聯的 ColorContext 物件。

傳回

BitmapFrame

來自指定之 BitmapSource 的 BitmapFrame，其具有指定的縮圖、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>)

參數

傳回

適用於

其他資源