イメージ関数

Windows GDI+ は、約 600 個の関数で構成されるフラット API を公開します。これは、Gdiplus.dllに実装され、Gdiplusflat.h で宣言されています。 GDI+ フラット API の関数は、約 40 個の C++ クラスのコレクションによってラップされます。 フラット API で関数を直接呼び出さないでください。 GDI+ を呼び出す場合は常に、C++ ラッパーによって提供されるメソッドと関数を呼び出します。 Microsoft 製品サポート サービスでは、フラット API を直接呼び出すコードのサポートは提供されません。 これらのラッパー メソッドの使用方法の詳細については、「 GDI+ Flat API」を参照してください。

次のフラット API 関数は、 Image C++ クラスによってラップされます。

HatchBrush 関数と対応するラッパー メソッド

フラット関数	ラッパー メソッド	注釈
GpStatus WINGDIPAPI GdipLoadImageFromStream(IStream* stream, GpImage **image)	Image::Image(IN IStream* stream, IN BOOL useEmbeddedColorManagement)	ストリームに基づいて Image オブジェクトを作成します。 このフラット関数では、イメージ カラー管理 (ICM) は使用されません。
GpStatus WINGDIPAPI GdipLoadImageFromFile(GDIPCONST WCHAR* filename, GpImage **image)	Image::Image(IN const WCHAR* filename, IN BOOL useEmbeddedColorManagement)	ファイルに基づいて Image オブジェクトを作成します。 このフラット関数では ICM は使用されません。
GpStatus WINGDIPAPI GdipLoadImageFromStreamICM(IStream* stream, GpImage **image)	Image::Image(IN IStream* stream, IN BOOL useEmbeddedColorManagement)	ストリームに基づいて Image オブジェクトを作成します。 このフラット関数では ICM は使用されません。
GpStatus WINGDIPAPI GdipLoadImageFromFileICM(GDIPCONST WCHAR* filename, GpImage **image)	Image::Image(IN const WCHAR* filename, IN BOOL useEmbeddedColorManagement)	ファイルに基づいて Image オブジェクトを作成します。 このフラット関数では ICM は使用されません。
GpStatus WINGDIPAPI GdipCloneImage(GpImage *image, GpImage **cloneImage)	Image* Image::Clone()	新しい Image オブジェクトを作成し、この Image オブジェクトの内容を使用して初期化します。
GpStatus WINGDIPAPI GdipDisposeImage(GpImage *image)	Image::~Image()	Image オブジェクトで使用されるリソースを解放します。
GpStatus WINGDIPAPI GdipSaveImageToFile(GpImage *image, GDIPCONST WCHAR* filename, GDIPCONST CLSID* clsidEncoder, GDIPCONST EncoderParameters* encoderParams)	Status Image::Save( IN const WCHAR* filename, IN const CLSID* clsidEncoder, IN const EncoderParameters *encoderParams )	このイメージをファイルに保存します。
GpStatus WINGDIPAPI GdipSaveImageToStream(GpImage *image, IStream* stream, GDIPCONST CLSID* clsidEncoder, GDIPCONST EncoderParameters* encoderParams)	Status Image::Save( IN IStream* stream, IN const CLSID* clsidEncoder, IN const EncoderParameters *encoderParams )	このイメージをストリームに保存します。
GpStatus WINGDIPAPI GdipSaveAdd(GpImage *image, GDIPCONST EncoderParameters* encoderParams)	Status Image::SaveAdd( IN const EncoderParameters *encoderParams )	Save メソッドの前の呼び出しで指定したファイルまたはストリームにフレームを追加します。 このメソッドは、多重フレーム イメージから選択したフレームを別の多重フレーム イメージに保存する場合に使用します。
GpStatus WINGDIPAPI GdipSaveAddImage(GpImage *image, GpImage* newImage, GDIPCONST EncoderParameters* encoderParams)	Status Image::SaveAdd( IN Image* newImage, IN const EncoderParameters *encoderParams )	Save メソッドの前の呼び出しで指定したファイルまたはストリームにフレームを追加します。
GpStatus WINGDIPAPI GdipGetImageGraphicsContext(GpImage *image, GpGraphics **graphics)	Graphics::Graphics(IN Image* image)	Image オブジェクトに関連付けられた Graphics オブジェクトを作成します。
GpStatus WINGDIPAPI GdipGetImageBounds(GpImage *image, GpRectF *srcRect, GpUnit *srcUnit)	Status Image::GetBounds( OUT RectF *srcRect, OUT Unit *srcUnit )	このイメージの外接する四角形を取得します。
GpStatus WINGDIPAPI GdipGetImageDimension(GpImage *image, REAL *width, REAL *height)	Status Image::GetPhysicalDimension( OUT SizeF* size )	このイメージの幅と高さを取得します。 フラット関数では、 width パラメーターと height パラメーターは、ラッパー メソッドの size パラメーターに対応します。
GpStatus WINGDIPAPI GdipGetImageType(GpImage *image, ImageType *type)	ImageType Image::GetType() const	この Image オブジェクトの型 (ビットマップまたはメタファイル) を取得します。
GpStatus WINGDIPAPI GdipGetImageWidth(GpImage *image, UINT *width)	UINT Image::GetWidth()	このイメージの幅をピクセル単位で取得します。
GpStatus WINGDIPAPI GdipGetImageHeight(GpImage *image, UINT *height)	UINT Image::GetHeight()	このイメージのイメージの高さをピクセル単位で取得します。
GpStatus WINGDIPAPI GdipGetImageHorizontalResolution(GpImage *image, REAL *resolution)	REAL Image::GetHorizontalResolution()	この画像の水平方向の解像度 (1 インチあたりのドット数) を取得します。
GpStatus WINGDIPAPI GdipGetImageVerticalResolution(GpImage *image, REAL *resolution)	REAL Image::GetVerticalResolution()	この画像の垂直方向の解像度 (1 インチあたりのドット数) を取得します。
GpStatus WINGDIPAPI GdipGetImageFlags(GpImage *image, UINT *flags)	UINT Image::GetFlags()	この Image オブジェクトの特定の属性を示すフラグのセットを取得します。
GpStatus WINGDIPAPI GdipGetImageRawFormat(GpImage *image, GUID *format)	Status Image::GetRawFormat(OUT GUID *format)	この Image オブジェクトの形式を識別するグローバル一意識別子 (GUID) を取得します。 さまざまなファイル形式を識別する GUID は、Gdiplusimaging.h で定義されます。
GpStatus WINGDIPAPI GdipGetImagePixelFormat(GpImage *image, PixelFormat *format)	PixelFormat Image::GetPixelFormat()	この Image オブジェクトのピクセル形式を取得します。
GpStatus WINGDIPAPI GdipGetImageThumbnail(GpImage *image, UINT thumbWidth, UINT thumbHeight, GpImage **thumbImage, GetThumbnailImageAbort コールバック, VOID * callbackData)	Image* Image::GetThumbnailImage( IN UINT thumbWidth, IN UINT thumbHeight, IN GetThumbnailImageAbort コールバック, IN VOID* callbackData )	この Image オブジェクトからサムネイル画像 を 取得します。
GpStatus WINGDIPAPI GdipGetEncoderParameterListSize(GpImage *image, GDIPCONST CLSID* clsidEncoder, UINT* size)	UINT Image::GetEncoderParameterListSize( IN const CLSID* clsidEncoder )	指定したイメージ エンコーダーのパラメーター リストのサイズをバイト単位で取得します。
GpStatus WINGDIPAPI GdipGetEncoderParameterList(GpImage *image, GDIPCONST CLSID* clsidEncoder, UINT size, EncoderParameters* buffer)	Status Image::GetEncoderParameterList( IN const CLSID* clsidEncoder, IN UINT size, OUT EncoderParameters* buffer )	指定したイメージ エンコーダーでサポートされているパラメーターの一覧を取得します。
GpStatus WINGDIPAPI GdipImageGetFrameDimensionsCount(GpImage* image, UINT* count)	UINT Image::GetFrameDimensionsCount()	この Image オブジェクトのフレーム寸法の数を取得します。
GpStatus WINGDIPAPI GdipImageGetFrameDimensionsList(GpImage* image, GUID* dimensionIDs, UINT count)	Status Image::GetFrameDimensionsList( OUT GUID* dimensionIDs, IN UINT count )	この Image オブジェクトのフレーム ディメンションの識別子を取得します。
GpStatus WINGDIPAPI GdipImageGetFrameCount(GpImage *image, GDIPCONST GUID* dimensionID, UINT* count)	UINT Image::GetFrameCount( IN const GUID* dimensionID )	この Image オブジェクトの指定したディメンション内のフレーム数を取得します。
GpStatus WINGDIPAPI GdipImageSelectActiveFrame(GpImage *image, GDIPCONST GUID* dimensionID, UINT frameIndex)	Status Image::SelectActiveFrame( IN const GUID *dimensionID, IN UINT frameIndex )	ディメンションとインデックスで指定されたこの Image オブジェクト内のフレームを選択します。
GpStatus WINGDIPAPI GdipImageRotateFlip(GpImage *image, RotateFlipType rfType)	Status Image::RotateFlip( IN RotateFlipType rotateFlipType )	このイメージを回転および反転します。
GpStatus WINGDIPAPI GdipGetImagePalette(GpImage *image, ColorPalette *palette, INT size)	Status Image::GetPalette( OUT ColorPalette *palette, INT size )	この Image オブジェクトの ColorPalette を取得します。
GpStatus WINGDIPAPI GdipSetImagePalette(GpImage *image, GDIPCONST ColorPalette *palette)	Status Image::SetPalette( IN const ColorPalette *palette )	この Image オブジェクトのカラー パレット を 設定します。
GpStatus WINGDIPAPI GdipGetImagePaletteSize(GpImage *image, INT *size)	INT Image::GetPaletteSize()	この Image オブジェクトのカラー パレットのサイズをバイト単位で取得します。
GpStatus WINGDIPAPI GdipGetPropertyCount(GpImage *image, UINT* numOfProperty)	UINT Image::GetPropertyCount()	この Image オブジェクトのピクセル形式を取得します。
GpStatus WINGDIPAPI GdipGetPropertyIdList(GpImage *image, UINT numOfProperty, PROPID* list)	Status Image::GetPropertyIdList( IN UINT numOfProperty, OUT PROPID* list )	この Image オブジェクトのメタデータで使用されるプロパティ識別子の一覧 を 取得します。
GpStatus WINGDIPAPI GdipGetPropertyItemSize(GpImage *image, PROPID propId, UINT* size)	UINT Image::GetPropertyItemSize( IN PROPID propId )	この Image オブジェクトの指定したプロパティ項目のサイズをバイト単位で取得します。
GpStatus WINGDIPAPI GdipGetPropertyItem(GpImage *image, PROPID propId,UINT propSize, PropertyItem* buffer)	Status Image::GetPropertyItem( IN PROPID propId, IN UINT propSize, OUT PropertyItem* buffer )	この Image オブジェクトから、指定したプロパティ項目 (メタデータの一部) を 取得します。
GpStatus WINGDIPAPI GdipGetPropertySize(GpImage *image, UINT* totalBufferSize, UINT* numProperties)	Status Image::GetPropertySize( OUT UINT* totalBufferSize, OUT UINT* numProperties )	この Image オブジェクトに格納されているすべてのプロパティ項目の合計サイズをバイト単位で取得します。 このメソッドは、この Image オブジェクトに格納されているプロパティ項目の数も取得します。
GpStatus WINGDIPAPI GdipGetAllPropertyItems(GpImage *image, UINT totalBufferSize, UINT numProperties, PropertyItem* allItems)	Status Image::GetAllPropertyItems( IN UINT totalBufferSize, IN UINT numProperties, OUT PropertyItem* allItems )	この Image オブジェクトに格納されているすべてのプロパティ項目 (メタデータ) を 取得します。
GpStatus WINGDIPAPI GdipRemovePropertyItem(GpImage *image, PROPID propId)	Status Image::RemovePropertyItem( IN PROPID propId )	この Image オブジェクトからプロパティ項目 (メタデータの一部) を 削除します。
GpStatus WINGDIPAPI GdipSetPropertyItem(GpImage *image, GDIPCONST PropertyItem* item)	状態イメージ::SetPropertyItem	この Image オブジェクトのプロパティ項目 (メタデータの一部) を設定します。 項目が既に存在する場合は、その内容が更新されます。それ以外の場合は、新しい項目が追加されます。
GpStatus WINGDIPAPI GdipFindFirstImageItem(GpImage *image, ImageItemData* item)	Status Image::FindFirstItem( IN ImageItemData* item )	この Image オブジェクトの最初のメタデータ項目の説明とデータ サイズ を 取得します。
GpStatus WINGDIPAPI GdipFindNextImageItem(GpImage *image, ImageItemData* item)	Status Image::FindNextItem( IN ImageItemData* item )	この Image オブジェクト内の次のメタデータ項目の説明とデータ サイズ を 取得します。 このメソッドは、 Image::FindFirstItem メソッドと共に使用して、この ImImageage オブジェクトに格納されているメタデータ項目を列挙します。
GpStatus WINGDIPAPI GdipGetImageItemData(GpImage *image, ImageItemData* item)	Status Image::GetItemData( IN ImageItemData* item )	この Image オブジェクトから 1 つのメタデータを取得します。
GpStatus WINGDIPAPI GdipImageSetAbort(GpImage *pImage, GdiplusAbort *pIAbort)	Status Image::SetAbort( GdiplusAbort *pIAbort )	レンダリング操作に時間がかかる間に Abort メソッドが定期的に呼び出されるオブジェクトを設定します。
GpStatus WINGDIPAPI GdipConvertToEmfPlus(const GpGraphics* refGraphics, GpMetafile* metafile, BOOL* conversionSuccess, EmfType emfType, const WCHAR* description, GpMetafile** out_metafile)	Status Metafile::ConvertToEmfPlus( const Graphics* refGraphics, BOOL* conversionSuccess, EmfType emfType, const WCHAR* description )	この メタファイル オブジェクトを EMF+ 形式に変換します。
GpStatus WINGDIPAPI GdipConvertToEmfPlusToFile(const GpGraphics* refGraphics, GpMetafile* metafile, BOOL* conversionSuccess, const WCHAR* filename, EmfType emfType, const WCHAR* description, GpMetafile** out_metafile)	Status Metafile::ConvertToEmfPlus( const Graphics* refGraphics, const WCHAR* filename, BOOL* conversionSuccess, EmfType emfType, const WCHAR* description )	この メタファイル オブジェクトを EMF+ 形式に変換します。
GpStatus WINGDIPAPI GdipConvertToEmfPlusToStream(const GpGraphics* refGraphics, GpMetafile* metafile, BOOL* conversionSuccess, IStream* stream, EmfType emfType, const WCHAR* description, GpMetafile** out_metafile)	Status Metafile::ConvertToEmfPlus( const Graphics* refGraphics, IStream* stream, BOOL* conversionSuccess, EmfType emfType, const WCHAR* description )	この メタファイル オブジェクトを EMF+ 形式に変換します。
GpStatus WINGDIPAPI GdipImageForceValidation(GpImage *image)	ラッパー メソッドによって呼び出されません。	この関数は、イメージの検証を強制します。