IWorkspaceItem - ABBYY Documentation

Stellt ein Element des Arbeitsbereichs dar. Dies kann ein Batch, ein Document oder eine Seite sein.

Methoden

Definition	Beschreibung
ApplyAutoLevelsFilter()	Konfiguriert die Einstellungen automatisch und wendet den Filter AdjustLevels an. Kann nur auf Graustufen- und Farbbilder angewendet werden.
ApplyPageProfile( name: string, [optional] onlyModificators: bool )	Wendet das ausgewählte Profil zur Bildoptimierung auf ein Bild an. Siehe Ein Optimierungsprofil anwenden.
ApplyShadowsHighlightsFilter()	Wendet eine lokal adaptive Verbesserung des Bildkontrasts an. Kann nur auf Graustufen- und Farbbilder angewendet werden.
ApplySigmaFilter()	Wendet einen Sigma-Filter an, um digitales Rauschen aus Bildern zu entfernen. Kann nur auf Graustufen- und Farbbilder angewendet werden.
AutoCrop( [optional] type: string )	Sucht in einem Bild automatisch nach Seitenrändern, schneidet den Bereich mit den zu extrahierenden Daten zu und korrigiert Schieflagen und Verzerrungen. Mögliche Werte für den optionalen Parameter `type` sind `Photo`, `Scan` und `Generic`.
BackToSourceImage()	Kehrt zum Quellbild zurück.
ChangeResolution( int )	Ändert die Bildauflösung auf einer Seite (oder allen Seiten) eines Dokuments oder eines Batchs auf den angegebenen Wert.
ConvertToBW()	Konvertiert eine Seite (oder alle Seiten) eines Dokuments oder eines Batchs in Schwarzweiß.
Copy( target: IWorkspaceItem, [optional] inside: bool ): IWorkspaceItem	Kopiert ein Dokument oder eine Seite hinter das Zielelement oder in dieses hinein. Das Ziel kann ein Batch, ein Dokument oder eine Seite sein. Setzen Sie `inside` auf `false`, um hinter dem Ziel auf derselben Ebene einzufügen. Setzen Sie den Parameter auf `true`, um innerhalb des Ziels am Anfang der Liste einzufügen.
CorrectBrightness( brightness: int )	Korrigiert die Helligkeit eines Bildes. Mögliche Werte reichen von `-100` bis `100`. Kann nur auf Graustufen- und Farbbilder angewendet werden.
CorrectContrast( contrast: int )	Korrigiert den Kontrast eines Bildes. Mögliche Werte reichen von `-100` bis `100`. Kann nur auf Graustufen- und Farbbilder angewendet werden.
Crop( rect: IPageRect )	Schneidet einen Bereich auf einer Seite (oder allen Seiten) eines Dokuments oder eines Batchs zu.
Deskew( [optional] byLines: bool, [optional] byBlackSquares: bool, [optional] byText: bool )	Begradigt eine Seite (oder alle Seiten) eines Dokuments oder eines Batchs. Standardmäßig sind die Parameter `byLines` und `byBlackSquares` auf `false` gesetzt, während der Parameter `byText` auf `true` gesetzt ist.
Despeckle( [optional] garbageSize: VARIANT )	Entfernt Bildstörungen auf einer Seite (oder allen Seiten) eines Dokuments oder eines Batchs.
Erase( rect: IPageRect, [optional] rColor: int, [optional] gColor: int, [optional] bColor: int )	Löscht einen Bereich auf einer Seite (oder allen Seiten) eines Dokuments oder eines Batchs.
FlipHorizontal()	Spiegelt eine Seite (oder alle Seiten) eines Dokuments oder eines Batchs horizontal.
FlipVertical()	Spiegelt eine Seite (oder alle Seiten) eines Dokuments oder eines Batchs vertikal.
FreeScale( newWidth: int, newHeight: int, newResolution: int )	Skaliert eine Seite (oder alle Seiten) eines Dokuments oder eines Batchs entsprechend den angegebenen Werten.
Invert( [optional] rect: IPageRect )	Invertiert eine Seite (oder alle Seiten) eines Dokuments oder eines Batchs.
IsPhoto: bool	Zeigt an, ob ein Bild ein Foto ist.
IsSuitableForOcr: bool	Zeigt an, ob ein Bild für OCR geeignet ist.
Move( target: IWorkspaceItem, [optional] inside: bool )	Verschiebt ein Dokument oder eine Seite hinter das Zielelement oder in dieses hinein. Das Ziel kann ein Batch, ein Dokument oder eine Seite sein. Setzen Sie `inside` auf `false`, um hinter dem Ziel auf derselben Ebene einzufügen. Setzen Sie den Parameter auf `true`, um innerhalb des Ziels am Anfang der Liste einzufügen.
RemoveGeometricalDistortions()	Korrigiert geometrische Verzerrungen wie Trapezformen und schiefe Linien in einem Bild.
RemoveMotionBlur()	Erkennt und entfernt Unschärfen, die durch die Bewegung eines Dokuments oder einer Kamera bzw. eines Scanners verursacht werden. Kann nur auf Graustufen- und Farbbilder angewendet werden.
RemoveScannerShadowFromImage()	Entfernt Scannerschatten aus einem Bild (zum Beispiel im Bereich der Buchfalz).
RemoveStamps( colorToFilter: string, [optional] rect: IPageRect )	Entfernt Stempel aus Bildern. Kann nur auf Farbbilder angewendet werden. `colorToFilter` ist die Farbe der zu entfernenden Stempel. Der Parameter akzeptiert `Red`, `Green`, `Blue` und `Yellow`; die Groß-/Kleinschreibung wird nicht berücksichtigt. `rect` ist der Bereich, aus dem Stempel entfernt werden sollen. Wenn `rect` weggelassen wird, werden Stempel aus dem gesamten Bild entfernt. Weitere Informationen finden Sie unter Stempel aus einem Teil eines Bildes entfernen.
RemoveStampsExt( colorsToFilter: string )	Entfernt Stempel aus Bildern. Kann nur auf Farbbilder angewendet werden. `colorsToFilter` ist die Farbe der zu entfernenden Stempel. Der Parameter akzeptiert `Red`, `Green`, `Blue`, `Yellow`, `Orange`, `LightBlue` und `Purple`; die Groß-/Kleinschreibung wird nicht berücksichtigt. Trennen Sie mehrere Werte durch ein Komma, zum Beispiel `Red, Green`. Übergeben Sie einen leeren String, um die Farben automatisch auswählen zu lassen. Dann wird jede zulässige Farbe entfernt, die im Bild gefunden wird. Weitere Informationen finden Sie unter Stempel bestimmter Farben entfernen.
ResetPageProfile()	Setzt das Profil zur Bildoptimierung zurück und verwirft alle Änderungen.
Rotate( angle: int )	Dreht eine Seite (oder alle Seiten) eines Dokuments oder eines Batchs.
SaveAs( fileName: string, [optional] options: IImageSavingOptions )	Speichert Seiten, ein Seitenbild oder einen Batch in einer Datei. Beim Speichern eines mehrseitigen Dokuments (oder eines Batchs) in einem einseitigen Format wird eine Ausnahme zurückgegeben.
Scale( ratio: int )	Skaliert eine Seite (oder alle Seiten) eines Dokuments oder eines Batch relativ zum Basiswert von 100.
SplitHorizontal( pos: int )	Teilt eine Seite (oder alle Seiten) eines Dokuments oder eines Batch horizontal auf.
SplitVertical( pos: int )	Teilt eine Seite (oder alle Seiten) eines Dokuments oder eines Batch vertikal auf.
SuitabilityForOCR: float	Zeigt, wie gut ein Bild für OCR geeignet ist. Mögliche Werte reichen von 0.0 bis 1.0.

Eigenschaften

Name	Typ	Zugriff	Beschreibung
Attachments	IAttachments	Schreibgeschützt	Anhänge.
BatchInfo (DocumentInfo or PageInfo)	IBatchInfo / IDocumentInfo / IExportPageInfo	Schreibgeschützt	Eigenschaften des Elements. Wenn die angeforderte Eigenschaft nicht zum Elementtyp passt, wird `IsBatch` (`IsDocument` oder `IsPage`) geprüft.
Children	IWorkspaceItems	Schreibgeschützt	Untergeordnete Elemente.
IsBatch (IsDocument or IsPage)	bool	Schreibgeschützt	Gibt an, ob das Element ein Batch, ein Document oder eine Seite ist.
IsExported	bool	Lesen/Schreiben	Gibt an, ob das Element exportiert ist. Kann nur für Batch-Elemente in Pre-Export-Skripten geändert werden.
IsSelected	bool	Lesen/Schreiben	Gibt an, ob das Element ausgewählt ist. Das Ändern des Werts dieser Eigenschaft für ein bestimmtes Element wirkt sich nicht auf andere Elemente aus. Funktioniert nicht, wenn die aktuelle Auswahl aus Elementen eines anderen Typs besteht.
Index	int	Schreibgeschützt	Der Index des Elements in der übergeordneten Sammlung.
Name	string	Lesen/Schreiben	Der Name des Elements. Wenn `IWorkspaceItem` eine Seite darstellt, ist diese Eigenschaft schreibgeschützt.
Next	IWorkspaceItem	Schreibgeschützt	Das nächste Element.
Parent	IWorkspaceItem	Schreibgeschützt	Das übergeordnete Element.
Prev	IWorkspaceItem	Schreibgeschützt	Das vorherige Element.
ScriptProperties	IScriptProperties	Schreibgeschützt	Skripteigenschaften.

Beispiele

Ein Bildverbesserungsprofil anwenden

Ein Beispiel für ein Skript, das das Bildverbesserungsprofil Photo auf alle Bilder des Typs photo anwendet:

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

Stempel aus einem Bildbereich entfernen

Ein Event-Handler, der blaue Stempel aus der linken Hälfte aller Bilder in der Auswahl entfernt:

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

Stempel bestimmter Farben entfernen

Ein Skript, das rote und grüne Stempel und Markierungen von allen Dokumentseiten entfernt:

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