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(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。

注釈

ビットマップの作成後に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(Uri, BitmapCreateOptions, BitmapCacheOption, RequestCachePolicy) は、.NET Framework バージョン 3.5 で導入されています。 詳細については、「 バージョンと依存関係」を参照してください。

適用対象

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。

適用対象