> ## 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.

# Méthode AddReplaceWhitePixelsRegion de l'objet ImageModification

> Méthode AddReplaceWhitePixelsRegion de l'objet ImageModification dans l'API ABBYY FineReader Engine — ajoute une nouvelle région de remplacement des pixels blancs au tableau interne ; remplace les points blancs par une couleur spécifiée.

Cette méthode ajoute une nouvelle région de « remplacement des pixels blancs » au tableau interne des régions de « remplacement des pixels blancs » de l'objet [ImageModification](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification). Pour supprimer toutes les régions de « remplacement des pixels blancs » précédemment ajoutées, appelez la méthode [IImageModification::ClearReplaceWhitePixelsRegions](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification/clearreplacewhitepixelsregions-method). Si la modification doit être appliquée à un seul plan [couleur](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#color) (ou [gris](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#gray)) de l'image, les coordonnées de la région doivent être spécifiées dans ce plan couleur (ou gris). Si la modification doit être appliquée à l'ensemble de [ImageModification](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification), les coordonnées doivent être spécifiées dans le plan de l'image [noir et blanc](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white) redressée.

<div id="syntax">
  ## Syntaxe
</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">
  ## Paramètres
</div>

Region

\[in] Ce paramètre de type [Region](/fr/fine-reader/engine/api-reference/supplementary-objects-and-methods/region) spécifie la région « remplacement des pixels blancs » à ajouter.

Color

\[in] Cette variable spécifie la couleur par laquelle les pixels blancs sont remplacés. La valeur de ce paramètre peut être -1, ce qui signifie que la couleur est transparente.

<Note>
  La valeur int est calculée à partir du triplet RGB à l’aide de la formule : ( red value ) + (256 x green value ) + (65536 x blue value ), où red value est la première composante du triplet, green value la deuxième et blue value la troisième. Par exemple, la valeur int de la couleur blanche est égale à 16777215.
</Note>

StrokesExpansion

\[in] Cette variable spécifie l’extension (en pixels) des zones noires de l’image avant le remplacement. Ce paramètre doit être positif ou nul.

<div id="return-values">
  ## Valeurs de retour
</div>

Cette méthode n’a pas de valeur de retour spécifique. Elle renvoie les [valeurs de retour standard des fonctions d’ABBYY FineReader Engine](/fr/fine-reader/engine/api-reference/return-codes).

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

Les pixels blancs de l'image situés dans les régions « remplacement des pixels blancs » seront remplacés par des pixels de la couleur spécifiée lors de l'application de la méthode [IImageDocument::Modify](/fr/fine-reader/engine/api-reference/image-related-objects/imagedocument/modify-method). Cette opération est effectuée sur le plan d'image [noir et blanc](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white), mais les résultats seront également appliqués aux plans d'image [gris](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#gray) et [couleur](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#color).

<div id="see-also">
  ## Voir aussi
</div>

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

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