跳轉到主要內容
此方法會將新的「替換白色像素」區域新增到 ImageModification 物件內部的「替換白色像素」區域陣列中。若要移除先前新增的所有「替換白色像素」區域，請呼叫 IImageModification::ClearReplaceWhitePixelsRegions 方法。若必須將修改套用至影像的單一 color (或 gray) 平面，則應在該彩色 (灰階) 平面上指定區域座標。若必須將修改套用至整個 ImageModification，則應在經過傾斜校正的 黑白 影像平面上指定座標。

​
語法

​
C++

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

​
C#

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

​
Visual Basic .NET

Sub AddReplaceWhitePixelsRegion( _
  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 ClearReplaceWhitePixelsRegions