图像函数
Windows GDI+ 公开一个由大约 600 个函数组成的平面 API，这些函数在 Gdiplus.dll 中实现并在 Gdiplusflat.h 中声明。 GDI+ 平面 API 中的函数由大约 40 个 C++ 类的集合包装。 建议不要直接调用平面 API 中的函数。 每当调用 GDI+ 时，都应该通过调用 C++ 包装器提供的方法和函数来执行此操作。 Microsoft 产品支持服务不会为直接调用平面 API 的代码提供支持。 有关使用这些包装器方法的详细信息，请参阅 GDI+ 平面 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) |
状态图像：：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) |
状态图像：：Save ( IN IStream* stream，IN const CLSID* clsidEncoder，IN const EncoderParameters *encoderParams ) | 将此图像保存到流中。 |
| GpStatus WINGDIPAPI GdipSaveAdd (GpImage *image， GDIPCONST EncoderParameters* encoderParams) |
状态图像：：SaveAdd ( IN const EncoderParameters *encoderParams ) | 将帧添加到在对 Save 方法的上一次调用中指定的文件或流中。 使用此方法将多帧图像中的选定帧保存到另一个多帧图像。 |
| GpStatus WINGDIPAPI GdipSaveAddImage (GpImage *image， GpImage* newImage， GDIPCONST EncoderParameters* encoderParams) |
状态图像：：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) |
状态图像：：GetBounds ( OUT RectF *srcRect，OUT Unit *srcUnit ) | 获取此图像的边框。 |
| GpStatus WINGDIPAPI GdipGetImageDimension (GpImage *image，REAL *width，REAL *height) |
状态图像：：GetPhysicalDimension ( OUT SizeF* 大小) | 获取此图像的宽度和高度。 在平面函数中， 宽度 和 高度 参数一起对应于包装器方法中的 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 () | 获取此图像的水平分辨率（以每英寸点为单位）。 |
| GpStatus WINGDIPAPI GdipGetImageVerticalResolution (GpImage *image， REAL *resolution) |
REAL Image：：GetVerticalResolution () | 获取此图像的垂直分辨率（以点/英寸为单位）。 |
| GpStatus WINGDIPAPI GdipGetImageFlags (GpImage *image， UINT *flags) |
UINT Image：：GetFlags () | 获取一组标志，这些标志指示此 Image 对象的某些属性。 |
| GpStatus WINGDIPAPI GdipGetImageRawFormat (GpImage *image， GUID *format) |
状态图像：：GetRawFormat (OUT GUID *格式) | 获取标识此 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 callback， VOID * callbackData) |
Image* Image：：GetThumbnailImage ( IN UINT thumbWidth、IN UINT thumbHeight、IN GetThumbnailImageAbort callback、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) |
状态图像：：GetEncoderParameterList ( IN const CLSID* clsidEncoder，IN UINT size，OUT EncoderParameters* 缓冲区) | 获取指定图像编码器支持的参数列表。 |
| GpStatus WINGDIPAPI GdipImageGetFrameDimensionsCount (GpImage* image， UINT* count) |
UINT Image：：GetFrameDimensionsCount () | 获取此 Image 对象中的帧尺寸数。 |
| GpStatus WINGDIPAPI GdipImageGetFrameDimensionsList (GpImage* image，GUID* dimensionIDs，UINT count) |
状态图像：：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) |
状态图像：：SelectActiveFrame ( IN const GUID *dimensionID， IN UINT frameIndex ) | 选择由维度和索引指定的此 Image 对象中的帧。 |
| GpStatus WINGDIPAPI GdipImageRotateFlip (GpImage *image， RotateFlipType rfType) |
状态图像：：RotateFlip ( IN RotateFlipType rotateFlipType ) | 旋转和翻转此图像。 |
| GpStatus WINGDIPAPI GdipGetImagePalette (GpImage *image，ColorPalette *palette，INT 大小) |
状态图像：：GetPalette ( OUT ColorPalette *palette， INT 大小) | 获取此 Image 对象的 ColorPalette 。 |
| GpStatus WINGDIPAPI GdipSetImagePalette (GpImage *image， GDIPCONST ColorPalette *palette) |
状态图像：：SetPalette ( IN const ColorPalette *调色板) | 设置此 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) |
状态图像：：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) |
状态图像：：GetPropertyItem ( IN PROPID propId、IN UINT propSize、OUT PropertyItem* 缓冲区) | 从此 Image 对象) 获取指定的属性项 (一段元数据。 |
| GpStatus WINGDIPAPI GdipGetPropertySize (GpImage *image， UINT* totalBufferSize， UINT* numProperties) |
状态图像：：GetPropertySize ( OUT UINT* totalBufferSize， OUT UINT* numProperties ) | 获取此 Image 对象中存储的所有属性项的总大小（以字节为单位）。 此方法还获取存储在此 Image 对象中的属性项数。 |
| GpStatus WINGDIPAPI GdipGetAllPropertyItems (GpImage *image， UINT totalBufferSize， UINT numProperties， PropertyItem* allItems) |
状态图像：：GetAllPropertyItems ( IN UINT totalBufferSize， IN UINT numProperties， OUT PropertyItem* allItems ) | 获取存储在此 Image 对象 (元数据) 的所有属性项。 |
| GpStatus WINGDIPAPI GdipRemovePropertyItem (GpImage *image， PROPID propId) |
状态图像：：RemovePropertyItem ( IN PROPID propId ) | 从此 Image 对象中删除属性项 (元数据) 片段。 |
| GpStatus WINGDIPAPI GdipSetPropertyItem (GpImage *image， GDIPCONST PropertyItem* 项) |
状态图像：：SetPropertyItem | 设置一个属性项 (此 Image 对象的元数据) 段。 如果该项已存在，则更新其内容;否则，将添加新项。 |
| GpStatus WINGDIPAPI GdipFindFirstImageItem (GpImage *image， ImageItemData* 项) |
状态图像：：FindFirstItem ( IN ImageItemData* 项) | 检索此 Image 对象中第一个元数据项的说明和数据大小。 |
| GpStatus WINGDIPAPI GdipFindNextImageItem (GpImage *image， ImageItemData* 项) |
状态图像：：FindNextItem ( IN ImageItemData* 项) | 检索此 Image 对象中下一个元数据项的说明和数据大小。 此方法与 Image：：FindFirstItem 方法一起使用，以枚举存储在此 ImImageage 对象中的元数据项。 |
| GpStatus WINGDIPAPI GdipGetImageItemData (GpImage *image， ImageItemData* 项) |
状态图像：：GetItemData ( IN ImageItemData* 项) | 从此 Image 对象获取一段元数据。 |
| GpStatus WINGDIPAPI GdipImageSetAbort (GpImage *pImage，GdiplusAbort *pIAbort) |
状态图像：：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) |
不由包装器方法调用。 |
此函数强制验证映像。 |
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈