> ## 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 Modify de l'objet ImageDocument

> Méthode Modify de l'objet ImageDocument dans l'API ABBYY FineReader Engine — applique toutes les modifications définies par un objet ImageModification (rognage, peinture, inversion, remplacement de pixels, suppression des parasites, étirement).

Cette méthode modifie l'objet ImageDocument actuel. Toutes les modifications définies par l'objet [ImageModification](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification) sont prises en charge.

Pour effectuer une modification, procédez comme suit :

1. Créez un objet [ImageModification](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification) à l'aide de la méthode [CreateImageModification](/fr/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods) de l'objet Engine.
2. Spécifiez les paramètres nécessaires.
3. Appelez la méthode Modify en passant cet objet en paramètre d'entrée. La modification n'est effectivement appliquée qu'au moment de l'appel de cette méthode.
4. Enregistrez les modifications à l'aide de la méthode [IImageDocument::SaveModified](/fr/fine-reader/engine/api-reference/image-related-objects/imagedocument/savemodified-method).

<Warning>
  Les modifications apportées à l'image ne sont pas enregistrées tant que la méthode IImageDocument::SaveModified n'a pas été appelée. Si l'objet [ImageDocument](/fr/fine-reader/engine/api-reference/image-related-objects/imagedocument) est libéré avant l'appel de cette méthode, les modifications ne sont pas enregistrées.
</Warning>

<Warning>
  Tous les blocs doivent être supprimés de la mise en page avant l'appel de cette méthode. Appelez la méthode [ILayoutBlocks::DeleteAll](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/deleteall-method) pour les collections [ILayout::Blocks](/fr/fine-reader/engine/api-reference/layout-related-objects/layout#blocks), [ILayout::BlackSeparators](/fr/fine-reader/engine/api-reference/layout-related-objects/layout#blackseparators) et [ILayout::VisualBlocks](/fr/fine-reader/engine/api-reference/layout-related-objects/layout#visualblocks) (Win) de la mise en page correspondante.
</Warning>

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

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

```cpp theme={null}
HRESULT Modify( IImageModification* Modification );
```

### C\#

```csharp theme={null}
void Modify( IImageModification Modification );
```

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

```vb theme={null}
Sub Modify(Modification As IImageModification)
```

<div id="parameters">
  ## Paramètres
</div>

**Modification**

\[in] Cette variable de type [ImageModification](/fr/fine-reader/engine/api-reference/image-related-objects/imagemodification) indique les transformations à effectuer sur l'objet [ImageDocument](/fr/fine-reader/engine/api-reference/image-related-objects/imagedocument).

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

Toutes les informations relatives à l’image initiale seront perdues après l’appel de la méthode.

Cette méthode applique des modifications aux plans d’image [noir et blanc](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white), [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) de l’[ImageDocument](/fr/fine-reader/engine/api-reference/image-related-objects/imagedocument). Toutes les autres pages de l’ImageDocument sont supprimées. Elles seront recréées à la demande.

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

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