跳转到主要内容
此方法会在 ImageModification 对象内部的“替换黑色像素”区域数组中新增一个“替换黑色像素”区域。要删除之前添加的所有“替换黑色像素”区域，请调用 IImageModification::ClearReplaceBlackPixelsRegions 方法。如果要将修改应用于图像的单个彩色 (或灰度) 平面，则应在该彩色 (灰度) 平面上指定区域坐标。如果要将修改应用于整个 ImageModification 对象，则应在纠偏后的黑白图像平面上指定坐标。

​
语法

​
C++

HRESULT AddReplaceBlackPixelsRegion(
  IRegion* Region,
  int      Color,
  int      StrokesExpansion
);

​
C#

void AddReplaceBlackPixelsRegion(
  IRegion Region,
  int    Color,
  int    StrokesExpansion
);

​
Visual Basic .NET

Sub AddReplaceBlackPixelsRegion( _
  Region As IRegion, _
  Color As Integer, _
  [StrokesExpansion As Integer = 0] _
)

​
参数

Region [in] 此 Region 类型的参数指定要添加的“替换黑色像素”区域。 Color [in] 此变量指定用于替换黑色像素的颜色。此参数的值可以为 -1，表示颜色为透明。
int 值根据 RGB 三元组按以下公式计算：( 红色值 ) + (256 x 绿色值 ) + (65536 x 蓝色值 )，其中红色值是三元组的第一个分量，绿色值是第二个分量，蓝色值是第三个分量。例如，白色的 int 值等于 16777215。
StrokesExpansion [in] 此变量指定在替换前黑白图像平面上白色区域的扩展量 (以像素为单位) 。此参数必须为非负值。

​
返回值

此方法没有特定的返回值。它会返回 ABBYY FineReader Engine 函数的标准返回值。

​
备注

应用 IImageDocument::Modify 方法时，图像中“替换黑色像素”区域内的黑色像素会被替换为指定颜色的像素。此操作在黑白图像平面上执行，但其结果也会应用到灰度和彩色图像平面。

​
另请参见

ImageModification ClearReplaceBlackPixelsRegions