跳轉到主要內容
此方法會將新的「替換黑色像素」區域新增至 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 三元組，使用以下公式計算：( red value ) + (256 x green value ) + (65536 x blue value )，其中 red value 是三元組的第一個分量，green value 是第二個分量，blue value 是第三個分量。例如，白色的 int 值為 16777215。
StrokesExpansion [in] 此變數指定在替換前，黑白影像平面上白色區域的擴張量 (以像素為單位) 。此參數必須為非負值。

​
傳回值

此方法沒有特定的傳回值。它會傳回 ABBYY FineReader Engine 函式的標準傳回值。

​
備註

套用 IImageDocument::Modify 方法時，影像中位於「替換黑色像素」區域內的黑色像素，會以指定顏色的像素加以取代。此作業會在 黑白 影像平面上執行，但其結果也會套用到 灰階 和 彩色 影像平面。

​
另請參閱

ImageModification ClearReplaceBlackPixelsRegions