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

# IPictureObject

> IPictureObject stellt in FlexiCapture-Skripten das Bild einer Seite oder Region dar und bietet Methoden zur Analyse von Objekten, zur Prüfung der OCR-Eignung und zur Erkennung der Orientierung.

<div id="what-it-does">
  ## Beschreibung
</div>

Stellt das Bild einer Seite oder einer Region dar.

Das Objekt implementiert die IPicture-Schnittstelle und ermöglicht über die IDispatch-Schnittstelle den Zugriff auf einige ihrer Eigenschaften.

Weitere Informationen zur IPicture-Schnittstelle finden Sie im entsprechenden Artikel auf [MSDN](https://msdn.microsoft.com/en-us/library/ms680761\(VS.85\).aspx#methods).

<Note>
  Dieses Objekt ist in der Web-Verifizierungsstation nicht verfügbar, um Regeln lokal zu überprüfen.
</Note>

<div id="methods">
  ## Methoden
</div>

<table width="100%"><thead><tr><th style={{textAlign: 'left'}}><p><strong>Definition</strong></p></th><th style={{textAlign: 'left'}}><p><strong>Beschreibung</strong></p></th></tr></thead><tbody><tr><td><p>AnalyzePageObjects( \[optional] reserved: Object ) : <a href="/de/flexi-capture/appendix/scripts/i-picture-objects-info">IPictureObjectsInfo</a></p></td><td><p>Definiert Objekte auf der Seite und gibt die Parameter der Seite zurück, wie sie vom Erkennungsmodul erkannt werden. Dabei kann es zu einer gewissen Verzögerung kommen.</p></td></tr><tr><td><p>CalcSuitabilityForOCR(): float</p></td><td><p>Zeigt, wie gut ein Bild für OCR geeignet ist. Mögliche Werte liegen zwischen 0.0 und 1.0.</p><details><summary>Beispiel</summary><p>Dieses Skript schreibt die Ergebnisse der Methodenausführung für die ausgewählten Dokumente beim Klicken auf eine Benutzerschaltfläche in einen Seitenkommentar:</p><pre><code>foreach( IDocument doc in MainWindow\.Selection.Documents )
\{
MainWindow\.TaskWindow\.OpenDocument( doc );
foreach( IPage page in doc.Pages )
\{
IPictureObject picture = page.Picture;
       double score = (double)picture.CalcSuitabilityForOCR();
       bool verdict = (bool)picture.IsSuitableForOcr();
       page.Comment = score.ToString( "0.0000" ) + " / " + verdict.ToString();
}
}</code></pre></details></td></tr><tr><td><p>CreateEditableCopy() : <a href="/de/flexi-capture/appendix/scripts/ieditablepictureobject">IEditablePictureObject</a></p></td><td><p>Erstellt eine bearbeitbare Kopie des Bildes.</p></td></tr><tr><td><p>DetectPageOrientation( \[optional] language: string ) : int</p></td><td><p>Erkennt die Seitenausrichtung anhand des darauf befindlichen Textes. Der <a href="/de/flexi-capture/appendix/scripts/internal-lang">interne Name</a> der Sprache wird als Eingabeparameter übergeben. Wenn keine Sprache angegeben ist, wird die Sprache des aktuellen Gebietsschemas verwendet. Gibt den Winkel (in Grad) zurück, um den die Seite gedreht werden muss. Die folgenden Werte können zurückgegeben werden: 0, 90, 180 und 270.</p></td></tr><tr><td><p>IsPhoto(): bool</p></td><td><p>Zeigt, ob ein Bild ein Foto ist.</p></td></tr><tr><td><p>IsSuitableForOcr(): bool</p></td><td><p>Zeigt, ob ein Bild für OCR geeignet ist.</p></td></tr><tr><td><p>SaveAs( filename : string, \[optional] options : <a href="/de/flexi-capture/appendix/scripts/iexportimagesavingoptions">IExportImageSavingOptions</a> )</p></td><td><p>Speichert das Bild. Wenn keine Optionen angegeben sind, wird das Bild als \*.tif gespeichert.</p></td></tr></tbody></table>

<div id="properties">
  ## Eigenschaften
</div>

<table width="100%">
  <thead>
    <tr>
      <th style={{ textAlign: "left" }}>
        <p>
          <strong>Name</strong>
        </p>
      </th>

      <th style={{ textAlign: "left" }}>
        <p>
          <strong>Typ</strong>
        </p>
      </th>

      <th style={{ textAlign: "left" }}>
        <p>
          <strong>Zugriff</strong>
        </p>
      </th>

      <th style={{ textAlign: "left" }}>
        <p>
          <strong>Beschreibung</strong>
        </p>
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <p>Handle</p>
      </td>

      <td>
        <p>OLE\_HANDLE</p>
      </td>

      <td>
        <p>Schreibgeschützt</p>
      </td>

      <td>
        <p>Das Windows-GDI-Handle des Bildes.</p>
        <p>In .NET kann diese Eigenschaft in der Methode System.Drawing.Image.FromHbitmap verwendet werden, um das Bildobjekt abzurufen.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Height</p>
      </td>

      <td>
        <p>int</p>
      </td>

      <td>
        <p>Schreibgeschützt</p>
      </td>

      <td>
        <p>Die Höhe des Bildes in Punkten</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>hPal</p>
      </td>

      <td>
        <p>OLE\_HANDLE</p>
      </td>

      <td>
        <p>Lese-/Schreibzugriff, änderbar (kann sogar in Skripten mit Nur-Lese-Berechtigungen geändert werden)</p>
      </td>

      <td>
        <p>Das Windows-Handle der vom Bild verwendeten Palette.</p>
        <p>Diese Eigenschaft kann in System.Drawing.Image.FromHbitmap als zweiter Parameter verwendet werden.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>IsBlackWhite</p>
      </td>

      <td>
        <p>bool</p>
      </td>

      <td>
        <p>Schreibgeschützt</p>
      </td>

      <td>
        <p>Gibt an, ob das Bild schwarz-weiß ist.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>IsColor</p>
      </td>

      <td>
        <p>bool</p>
      </td>

      <td>
        <p>Schreibgeschützt</p>
      </td>

      <td>
        <p>Gibt an, ob das Bild farbig ist.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>IsGrayscale</p>
      </td>

      <td>
        <p>bool</p>
      </td>

      <td>
        <p>Schreibgeschützt</p>
      </td>

      <td>
        <p>Gibt an, ob das Bild in Graustufen vorliegt.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Type</p>
      </td>

      <td>
        <p>SHORT</p>
      </td>

      <td>
        <p>Schreibgeschützt</p>
      </td>

      <td>
        <p>Der Typ des Bildes.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>Width</p>
      </td>

      <td>
        <p>int</p>
      </td>

      <td>
        <p>Schreibgeschützt</p>
      </td>

      <td>
        <p>Die Breite des Bildes in Punkten</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>XResolution</p>
      </td>

      <td>
        <p>int</p>
      </td>

      <td>
        <p>Schreibgeschützt</p>
      </td>

      <td>
        <p>Die horizontale Bildauflösung</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>YResolution</p>
      </td>

      <td>
        <p>int</p>
      </td>

      <td>
        <p>Schreibgeschützt</p>
      </td>

      <td>
        <p>Die vertikale Bildauflösung</p>
      </td>
    </tr>
  </tbody>
</table>