勇芳软件工作室.汉化:  GDI+ Flat API > Bitmap Functions >

GdipBitmapSetPixel

Previous pageReturn to chapter overviewNext page

描述

 

设置此位图中指定像素的颜色。

 

C++ 语法

 

GpStatus WINGDIPAPI GdipBitmapSetPixel(

   GpBitmap* bitmap,

   INT x,

   INT y,

   ARGB color

);

 

PowerBASIC 语法

 

FUNCTION GdipBitmapSetPixel ( _

   BYVAL pbitmap AS DWORD, _

   BYVAL x AS LONG, _

   BYVAL y AS LONG, _

   BYVAL pcolor AS DWORD _

) AS LONG

 

参数

 

bitmap

 

[in]指向位图对象的指针。

 

x

 

[in]指定像素的x坐标(列)的长整数值。

 

y

 

[in]指定像素的y坐标(行)的长整数值。

 

color

 

[in]ARGB颜色值,指定要设置的颜色。

 

返回值

 

如果函数成功,则返回Ok,它是状态枚举的一个元素。

 

如果函数失败,它返回状态枚举的其他元素之一。

 

备注

 

根据位图的格式,GetPixel可能不会返回与SetPixel设置的相同的值。例如,如果您在像素格式为32bppPARGB位图对象上调用SetPixel,则会将RGB组件预乘。随后调用GetPixel可能会因为四舍五入而返回一个不同的值。另外,如果您在位图上调用SetPixel,其颜色深度为每像素16位,则从32位转换为16位的信息可能会丢失,随后调用GetPixel可能会返回一个不同的值。