IWorkspaceItem - ABBYY Documentation

Représente un élément de l’espace de travail. Il peut s’agir d’un lot, d’un document ou d’une page.

Méthodes

Définition	Description
ApplyAutoLevelsFilter()	Configure automatiquement les paramètres et applique le filtre AdjustLevels. S’applique uniquement aux images en niveaux de gris et en couleur.
ApplyPageProfile( name: string, [optional] onlyModificators: bool )	Applique à une image le profil d’amélioration sélectionné. Voir Appliquer un profil d’amélioration.
ApplyShadowsHighlightsFilter()	Applique un renforcement du contraste local adaptatif. S’applique uniquement aux images en niveaux de gris et en couleur.
ApplySigmaFilter()	Applique un filtre sigma pour supprimer le bruit numérique des images. S’applique uniquement aux images en niveaux de gris et en couleur.
AutoCrop( [optional] type: string )	Recherche automatiquement les limites de la page dans une image, rogne la zone contenant les données à extraire et corrige l’inclinaison ainsi que les distorsions. Les valeurs possibles du `type` facultatif sont `Photo`, `Scan` et `Generic`.
BackToSourceImage()	Revient à l’image source.
ChangeResolution( int )	Modifie la résolution d’image d’une page (ou de toutes les pages) d’un document ou d’un batch selon la valeur spécifiée.
ConvertToBW()	Convertit une page (ou toutes les pages) d’un document ou d’un batch en noir et blanc.
Copy( target: IWorkspaceItem, [optional] inside: bool ): IWorkspaceItem	Copie un document ou une page après l’élément cible, ou à l’intérieur de celui-ci. La cible peut être un batch, un document ou une page. Définissez `inside` sur `false` pour insérer après la cible, au même niveau. Définissez-le sur `true` pour insérer à l’intérieur de la cible, au début de la liste.
CorrectBrightness( brightness: int )	Corrige la luminosité d’une image. Les valeurs possibles vont de `-100` à `100`. S’applique uniquement aux images en niveaux de gris et en couleur.
CorrectContrast( contrast: int )	Corrige le contraste d’une image. Les valeurs possibles vont de `-100` à `100`. S’applique uniquement aux images en niveaux de gris et en couleur.
Crop( rect: IPageRect )	Rogne une zone sur une page (ou sur toutes les pages) d’un document ou d’un batch.
Deskew( [optional] byLines: bool, [optional] byBlackSquares: bool, [optional] byText: bool )	Redresse une page (ou toutes les pages) d’un document ou d’un batch. Par défaut, les paramètres `byLines` et `byBlackSquares` sont définis sur `false`, tandis que le paramètre `byText` est défini sur `true`.
Despeckle( [optional] garbageSize: VARIANT )	Effectue une suppression des taches parasites sur une page (ou sur toutes les pages) d’un document ou d’un batch.
Erase( rect: IPageRect, [optional] rColor: int, [optional] gColor: int, [optional] bColor: int )	Efface une zone sur une page (ou sur toutes les pages) d’un document ou d’un batch.
FlipHorizontal()	Retourne horizontalement une page (ou toutes les pages) d’un document ou d’un batch.
FlipVertical()	Retourne verticalement une page (ou toutes les pages) d’un document ou d’un batch.
FreeScale( newWidth: int, newHeight: int, newResolution: int )	Met à l’échelle une page (ou toutes les pages) d’un document ou d’un batch selon les valeurs spécifiées.
Invert( [optional] rect: IPageRect )	Inverse les couleurs d’une page (ou de toutes les pages) d’un document ou d’un batch.
IsPhoto: bool	Indique si une image est une photo.
IsSuitableForOcr: bool	Indique si une image est adaptée à la Reconnaissance optique de caractères (OCR).
Move( target: IWorkspaceItem, [optional] inside: bool )	Déplace un document ou une page après l’élément cible, ou à l’intérieur de celui-ci. La cible peut être un batch, un document ou une page. Définissez `inside` sur `false` pour insérer après la cible, au même niveau. Définissez-le sur `true` pour insérer à l’intérieur de la cible, au début de la liste.
RemoveGeometricalDistortions()	Corrige les distorsions géométriques des trapèzes et des lignes courbes dans une image.
RemoveMotionBlur()	Détecte et supprime le flou causé par le mouvement d’un document ou d’une caméra/d’un scanner. S’applique uniquement aux images en niveaux de gris et en couleur.
RemoveScannerShadowFromImage()	Supprime l’ombre du scanner (par exemple, au centre de la reliure).
RemoveStamps( colorToFilter: string, [optional] rect: IPageRect )	Supprime les cachets des images. S’applique uniquement aux images en couleur. `colorToFilter` est la couleur des cachets à supprimer. Ce paramètre accepte `Red`, `Green`, `Blue` et `Yellow`, et n’est pas sensible à la casse. `rect` est la zone dans laquelle supprimer les cachets. Si `rect` est omis, les cachets sont supprimés de l’image entière. Pour plus d’informations, voir Supprimer les cachets d’une partie d’une image.
RemoveStampsExt( colorsToFilter: string )	Supprime les cachets des images. S’applique uniquement aux images en couleur. `colorsToFilter` est la couleur des cachets à supprimer. Ce paramètre accepte `Red`, `Green`, `Blue`, `Yellow`, `Orange`, `LightBlue` et `Purple`, et n’est pas sensible à la casse. Séparez plusieurs valeurs par une virgule, par exemple `Red, Green`. Transmettez une chaîne vide pour que les couleurs soient sélectionnées automatiquement. Toutes les couleurs acceptées présentes sur l’image sont alors supprimées. Pour plus d’informations, voir Supprimer les cachets de couleurs spécifiques.
ResetPageProfile()	Réinitialise le profil d’amélioration d’image et annule toutes les modifications.
Rotate( angle: int )	Fait pivoter une page (ou toutes les pages) d’un document ou d’un batch.
SaveAs( fileName: string, [optional] options: IImageSavingOptions )	Enregistre des pages, une image de la page ou un batch dans un fichier. Lors de l’enregistrement d’un document multipage (ou d’un batch) dans un format monopage, une exception est renvoyée.
Scale( ratio: int )	Met à l’échelle une page (ou toutes les pages) d’un document ou d’un lot, sur la base de la valeur 100.
SplitHorizontal( pos: int )	Scinde horizontalement une page (ou toutes les pages) d’un document ou d’un lot.
SplitVertical( pos: int )	Scinde verticalement une page (ou toutes les pages) d’un document ou d’un lot.
SuitabilityForOCR: float	Indique dans quelle mesure une image se prête à la reconnaissance optique de caractères (OCR). Les valeurs possibles vont de 0.0 à 1.0.

Propriétés

Nom	Type	Accès	Description
Attachments	IAttachments	Lecture seule	Pièces jointes.
BatchInfo (DocumentInfo ou PageInfo)	IBatchInfo / IDocumentInfo / IExportPageInfo	Lecture seule	Propriétés de l’élément. Si la propriété demandée ne correspond pas au type d’élément, la vérification `IsBatch` (`IsDocument` ou `IsPage`) est effectuée.
Children	IWorkspaceItems	Lecture seule	Éléments enfants.
IsBatch (IsDocument ou IsPage)	bool	Lecture seule	Indique si l’élément est un lot, un document ou une page.
IsExported	bool	Lecture/écriture	Indique si l’élément est exporté. Cette propriété ne peut être modifiée que pour les éléments de type lot dans les scripts de pré-export.
IsSelected	bool	Lecture/écriture	Indique si l’élément est sélectionné. La modification de la valeur de cette propriété pour un élément donné n’affecte pas les autres éléments. Ne fonctionne pas si la sélection actuelle se compose d’éléments d’un type différent.
Index	int	Lecture seule	L’indice de l’élément dans la collection parente.
Name	string	Lecture/écriture	Le nom de l’élément. Si `IWorkspaceItem` représente une page, cette propriété est en lecture seule.
Next	IWorkspaceItem	Lecture seule	L’élément suivant.
Parent	IWorkspaceItem	Lecture seule	L’élément parent.
Prev	IWorkspaceItem	Lecture seule	L’élément précédent.
ScriptProperties	IScriptProperties	Lecture seule	Propriétés du script.

Exemples

Appliquer un profil d’amélioration

Exemple de script appliquant le profil d’amélioration Photo à toutes les images de type photo :

foreach (IWorkspaceItem item in Workspace.Selection)
{
    if (item.PageInfo.IsPhoto)
    {
        item.ApplyPageProfile("Photo");
    }
}

Supprimer les cachets sur une partie d’une image

Un gestionnaire d’événements qui supprime les cachets bleus de la moitié gauche de toutes les images de la sélection :

foreach (IWorkspaceItem item in Workspace.Selection)
{
    if (item.IsPage && item.PageInfo.IsColor)
    {
        IPageRect rect = Workspace.NewPageRect();
        rect.Left = 0;
        rect.Right = item.PageInfo.Width / 2;
        rect.Top = 0;
        rect.Bottom = item.PageInfo.Height;
        item.RemoveStamps("blue", rect);
    }
}

Supprimer les cachets de couleurs spécifiques

Un script qui supprime les cachets et les marques rouges et verts de toutes les pages du document :

foreach (IWorkspaceItem item in Workspace.Selection)
{
    if (item.PageInfo.IsColor)
    {
        item.RemoveStampsExt("Red,Green");
    }
}