> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AddReplaceWhitePixelsRegion-Methode des ImageModification-Objekts

> AddReplaceWhitePixelsRegion-Methode des ImageModification-Objekts in der ABBYY FineReader Engine API — Fügt dem internen Array eine neue Region zum Ersetzen weißer Pixel hinzu; ersetzt weiße Punkte durch eine angegebene Farbe.

Diese Methode fügt dem internen Array von Regionen zum „Ersetzen weißer Pixel“ des Objekts [ImageModification](/de/fine-reader/engine/api-reference/image-related-objects/imagemodification) eine neue Region zum „Ersetzen weißer Pixel“ hinzu. Um alle zuvor hinzugefügten Regionen zum „Ersetzen weißer Pixel“ zu entfernen, rufen Sie die Methode [IImageModification::ClearReplaceWhitePixelsRegions](/de/fine-reader/engine/api-reference/image-related-objects/imagemodification/clearreplacewhitepixelsregions-method) auf. Wenn die Änderung auf nur eine einzelne [color](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#color) (oder [gray](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#gray)) des Bildes angewendet werden soll, sollten die Koordinaten der Region auf dieser color- bzw. gray-Ebene angegeben werden. Wenn die Änderung auf die gesamte [ImageModification](/de/fine-reader/engine/api-reference/image-related-objects/imagemodification) angewendet werden soll, sollten die Koordinaten auf der entzerrten [black-and-white-Bildebene](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white) angegeben werden.

<div id="syntax">
  ## Syntax
</div>

<div id="c">
  ### C++
</div>

```cpp theme={null}
HRESULT AddReplaceWhitePixelsRegion(
  IRegion* Region,
  int      Color,
  int      StrokesExpansion
);
```

### C\#

```csharp theme={null}
void AddReplaceWhitePixelsRegion(
  IRegion Region,
  int     Color,
  int     StrokesExpansion
);
```

<div id="visual-basic-net">
  ### Visual Basic .NET
</div>

```vb theme={null}
Sub AddReplaceWhitePixelsRegion( _
  Region As IRegion, _
  Color  As Integer, _
  [StrokesExpansion As Integer = 0] _
)
```

<div id="parameters">
  ## Parameter
</div>

Region

\[in] Dieser Parameter vom Typ [Region](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/region) gibt die hinzuzufügende „Ersetzen weißer Pixel"-Region an.

Color

\[in] Diese Variable gibt die Farbe an, durch die die weißen Pixel ersetzt werden. Der Wert dieses Parameters kann -1 sein; das bedeutet, dass die Farbe transparent ist.

<Note>
  Der int-Wert wird aus dem RGB-Tripel nach folgender Formel berechnet: ( Rotwert ) + (256 x Grünwert ) + (65536 x Blauwert ), wobei der Rotwert die erste Komponente des Tripels ist, der Grünwert die zweite Komponente und der Blauwert die dritte Komponente. Zum Beispiel entspricht der int-Wert der Farbe Weiß 16777215.
</Note>

StrokesExpansion

\[in] Diese Variable gibt die Ausdehnung (in Pixeln) schwarzer Bereiche im Bild vor dem Ersetzen an. Dieser Parameter muss null oder positiv sein.

<div id="return-values">
  ## Rückgabewerte
</div>

Diese Methode hat keine spezifischen Rückgabewerte. Sie liefert die [Standard-Rückgabewerte von ABBYY FineReader Engine-Funktionen](/de/fine-reader/engine/api-reference/return-codes) zurück.

<div id="remarks">
  ## Hinweise
</div>

Weiße Pixel im Bild innerhalb der Regionen „Ersetzen weißer Pixel

<div id="see-also">
  ## Siehe auch
</div>

[ImageModification](/de/fine-reader/engine/api-reference/image-related-objects/imagemodification)

[ClearReplaceWhitePixelsRegions](/de/fine-reader/engine/api-reference/image-related-objects/imagemodification/clearreplacewhitepixelsregions-method)