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

# PDFPictures Object (IPDFPicures Interface)

This object represents a collection of user-defined pictures added to a PDF document (PDFPicture objects). It contains methods for getting the number of pictures in the collection, accessing a single element of the collection and iterating through the collection. The collection is accessible via the [PDFExportParams](/fine-reader/engine/api-reference/parameter-objects/export-parameters/pdfexportparams) object.

<Warning>
  When exporting to PDF, ABBYY FineReader Engine does not preserve the picture transparency.
</Warning>

* The indexing of ABBYY FineReader Engine collections starts with 0.
* The foreach statement in C# (for each in Visual Basic .NET) can be used to manipulate the collection.

## Properties

| Name                                                                                                                  | Type                                                                                                                                                                                                                             | Description                                            |
| --------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
| Application                                                                                                           | [Engine](/fine-reader/engine/api-reference/engine-object-iengine-interface), [read-only](/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties)                    | Returns the Engine object.                             |
| Count                                                                                                                 | [int](/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), read-only                                                                                                                | Stores the number of elements in the collection.       |
| [Element](/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/element-property) | [PDFPicture](/fine-reader/engine/api-reference/parameter-objects/export-parameters/pdfpicture), [read-only](/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties) | Provides access to a single element of the collection. |

## Methods

| Name                                                                                                                    | Description                                                      |
| ----------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| [AddNew](/fine-reader/engine/api-reference/supplementary-objects-and-methods/addnew-method)                             | Creates a new PDFPicture object and adds it into the collection. |
| [DeleteAll](/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/deleteall-method) | Removes all the elements from the collection.                    |
| [DeleteAt](/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/deleteat-method)   | Removes an element from the collection.                          |
| [Item](/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/item-method)           | Provides access to a single element of the collection.           |

## Related objects

<img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/pdfpictures.gif?s=32f1b6b9e7e4c94b6588feb967ebbf85" alt="PDFPictures" width="151" height="96" data-path="images/fine-reader/engine/pdfpictures.gif" />[](/fine-reader/engine/api-reference/parameter-objects/export-parameters/pdfexportparams#pdfpictures)[](/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/element-property)[](/fine-reader/engine/api-reference/parameter-objects/export-parameters/pdfpicture)[](/fine-reader/engine/api-reference/parameter-objects/export-parameters/pdfexportparams)

[Object Diagram](/fine-reader/engine/api-reference/object-diagram)

## Samples

This sample illustrates how to export pictures to PDF format.

<Accordion title="C++ code">
  ```cpp theme={null}
  // Create the PDF export parameters
  CSafePtr<IPDFExportParams> pdfExportParams;
  CheckResult( FREngine->CreatePDFExportParams( &pdfExportParams ) );
  // Get the PDF pictures collection
  CSafePtr<IPDFPictures> pictures;
  CheckResult( pdfExportParams->get_PDFPictures( &pictures ) );
  // Add a PDF picture to existing collection
  CSafePtr<IPDFPicture> picture;
  CheckResult( pictures->AddNew( &picture ) );
  // Set the offset
  CSafePtr<IPoint> offset;
  CheckResult( FREngine->CreatePoint( 10, 10, &offset ) );
  CheckResult( picture->SetLocation( offset, 0 ) );
  // Get an image document from the picture
  CSafePtr<IFRDocument> pictureDocument;
  CheckResult( FREngine->CreateFRDocument( &pictureDocument ) );
  CheckResult( pictureDocument->AddImageFile( pictureFilePath ) );
  CSafePtr<IFRPages> frPages;
  CheckResult( pictureDocument->get_Pages( &frPages ) );
  CSafePtr<IFRPage> frPage;
  CheckResult( frPages->get_Element( 0, &frPage ) );
  CSafePtr<IImageDocument> imageDocument;
  CheckResult( frPage->get_ImageDocument( &imageDocument ) );
  // Set the image document
  CheckResult( picture->put_Image( imageDocument ) );
  // Export to PDF
  CheckResult( frDocument->Export( resultFilePath, FEF_PDF, pdfExportParams ) );
  ```
</Accordion>

## See also

[PDFPicture](/fine-reader/engine/api-reference/parameter-objects/export-parameters/pdfpicture)

[Working with Collections](/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-collections)

[Working with Properties](/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)