IWorkspaceItem - ABBYY Documentation

Representa un elemento del espacio de trabajo. Puede ser un lote, un Document o una Página.

Métodos

Definición	Descripción
ApplyAutoLevelsFilter()	Configura automáticamente los ajustes y aplica el filtro AdjustLevels. Solo se aplica a imágenes en escala de grises y en color.
ApplyPageProfile( name: string, [optional] onlyModificators: bool )	Aplica el perfil de mejora seleccionado a una imagen. Consulte Aplicar un perfil de mejora.
ApplyShadowsHighlightsFilter()	Aplica una mejora del contraste de imagen adaptativa local. Solo se aplica a imágenes en escala de grises y en color.
ApplySigmaFilter()	Aplica un filtro sigma para eliminar el ruido digital de las imágenes. Solo se aplica a imágenes en escala de grises y en color.
AutoCrop( [optional] type: string )	Busca automáticamente los límites de la página en una imagen, recorta el área que contiene los datos para la extracción y corrige inclinaciones y distorsiones. Los posibles valores del parámetro opcional `type` son `Photo`, `Scan` y `Generic`.
BackToSourceImage()	Vuelve a la imagen de origen.
ChangeResolution( int )	Cambia la resolución de imagen de una página (o de todas las páginas) de un documento o de un lote al valor especificado.
ConvertToBW()	Convierte una página (o todas las páginas) de un documento o de un lote a blanco y negro.
Copy( target: IWorkspaceItem, [optional] inside: bool ): IWorkspaceItem	Copia un documento o una página después del elemento de destino o dentro de él. El destino puede ser un lote, un documento o una página. Establezca `inside` en `false` para insertar después del destino en el mismo nivel. Establézcalo en `true` para insertar dentro del destino, al principio de la lista.
CorrectBrightness( brightness: int )	Corrige el brillo de una imagen. Los valores posibles van de `-100` a `100`. Solo se aplica a imágenes en escala de grises y en color.
CorrectContrast( contrast: int )	Corrige el contraste de una imagen. Los valores posibles van de `-100` a `100`. Solo se aplica a imágenes en escala de grises y en color.
Crop( rect: IPageRect )	Recorta un área de una página (o de todas las páginas) de un documento o de un lote.
Deskew( [optional] byLines: bool, [optional] byBlackSquares: bool, [optional] byText: bool )	Corrige la inclinación de una página (o de todas las páginas) de un documento o de un lote. De forma predeterminada, los parámetros `byLines` y `byBlackSquares` están establecidos en `false`, mientras que el parámetro `byText` está establecido en `true`.
Despeckle( [optional] garbageSize: VARIANT )	Elimina las motas de una página (o de todas las páginas) de un documento o de un lote.
Erase( rect: IPageRect, [optional] rColor: int, [optional] gColor: int, [optional] bColor: int )	Borra un área de una página (o de todas las páginas) de un documento o de un lote.
FlipHorizontal()	Voltea horizontalmente una página (o todas las páginas) de un documento o de un lote.
FlipVertical()	Voltea verticalmente una página (o todas las páginas) de un documento o de un lote.
FreeScale( newWidth: int, newHeight: int, newResolution: int )	Escala una página (o todas las páginas) de un documento o de un lote según los valores especificados.
Invert( [optional] rect: IPageRect )	Invierte una página (o todas las páginas) de un documento o de un lote.
IsPhoto: bool	Indica si una imagen es una foto.
IsSuitableForOcr: bool	Indica si una imagen es apta para OCR.
Move( target: IWorkspaceItem, [optional] inside: bool )	Mueve un documento o una página después del elemento de destino o dentro de él. El destino puede ser un lote, un documento o una página. Establezca `inside` en `false` para insertar después del destino en el mismo nivel. Establézcalo en `true` para insertar dentro del destino, al principio de la lista.
RemoveGeometricalDistortions()	Corrige las distorsiones geométricas de trapecios y líneas torcidas en una imagen.
RemoveMotionBlur()	Detecta y elimina el desenfoque causado por el movimiento de un documento o de una cámara/escáner. Solo se aplica a imágenes en escala de grises y en color.
RemoveScannerShadowFromImage()	Elimina la sombra del escáner (por ejemplo, en el pliegue central).
RemoveStamps( colorToFilter: string, [optional] rect: IPageRect )	Elimina sellos de las imágenes. Solo se aplica a imágenes en color. `colorToFilter` es el color de los sellos que se van a eliminar. Acepta `Red`, `Green`, `Blue` y `Yellow`, y no distingue entre mayúsculas y minúsculas. `rect` es el área de la que se eliminarán los sellos. Si se omite `rect`, los sellos se eliminan de toda la imagen. Para obtener más información, consulte Eliminar sellos de una parte de una imagen.
RemoveStampsExt( colorsToFilter: string )	Elimina sellos de las imágenes. Solo se aplica a imágenes en color. `colorsToFilter` es el color de los sellos que se van a eliminar. Acepta `Red`, `Green`, `Blue`, `Yellow`, `Orange`, `LightBlue` y `Purple`, y no distingue entre mayúsculas y minúsculas. Separe varios valores con una coma, por ejemplo `Red, Green`. Pase una cadena vacía para seleccionar los colores automáticamente. En ese caso, se elimina cada color admitido que se encuentre en la imagen. Para obtener más información, consulte Eliminar sellos de colores específicos.
ResetPageProfile()	Restablece el perfil de mejora de imagen y descarta todos los cambios.
Rotate( angle: int )	Gira una página (o todas las páginas) de un documento o de un lote.
SaveAs( fileName: string, [optional] options: IImageSavingOptions )	Guarda páginas, una imagen de página o un lote en un archivo. Al guardar un documento multipágina (o un lote) en un formato de una sola página, se devuelve una excepción.
Scale( ratio: int )	Escala una página (o todas las páginas) de un documento o un lote tomando como base el valor 100.
SplitHorizontal( pos: int )	Divide horizontalmente una página (o todas las páginas) de un documento o un lote.
SplitVertical( pos: int )	Divide verticalmente una página (o todas las páginas) de un documento o un lote.
SuitabilityForOCR: float	Muestra lo apta que es una imagen para OCR. Los valores posibles van de 0.0 a 1.0.

Propiedades

Nombre	Tipo	Acceso	Descripción
Attachments	IAttachments	De solo lectura	Archivos adjuntos.
BatchInfo (DocumentInfo or PageInfo)	IBatchInfo / IDocumentInfo / IExportPageInfo	De solo lectura	Propiedades del elemento. Si la propiedad solicitada no corresponde al tipo de elemento, se realiza la comprobación `IsBatch` (`IsDocument` o `IsPage`).
Children	IWorkspaceItems	De solo lectura	Elementos secundarios.
IsBatch (IsDocument or IsPage)	bool	De solo lectura	Especifica si el elemento es un lote, un documento o una página.
IsExported	bool	Lectura/escritura	Especifica si el elemento se ha exportado. Solo se puede modificar para elementos de lote en scripts de preexportación.
IsSelected	bool	Lectura/escritura	Especifica si el elemento está seleccionado. Cambiar el valor de esta propiedad para un elemento concreto no afecta a los demás elementos. No funciona si la selección actual consta de elementos de otro tipo.
Index	int	De solo lectura	El índice del elemento en la colección padre.
Name	string	Lectura/escritura	El nombre del elemento. Si `IWorkspaceItem` representa una página, esta propiedad es de solo lectura.
Next	IWorkspaceItem	De solo lectura	El elemento siguiente.
Parent	IWorkspaceItem	De solo lectura	El elemento padre.
Prev	IWorkspaceItem	De solo lectura	El elemento anterior.
ScriptProperties	IScriptProperties	De solo lectura	Propiedades del script.

Ejemplos

Aplicar un perfil de mejora

Ejemplo de script que aplica el perfil de mejora Photo a todas las imágenes de tipo photo:

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

Eliminar sellos de una parte de la imagen

Un controlador de eventos que elimina los sellos azules de la mitad izquierda de todas las imágenes de la selección:

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);
    }
}

Eliminar sellos de colores específicos

Un script que elimina los sellos y las marcas rojas y verdes de todas las páginas del documento:

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