ArcObjects Library Reference (Carto)  

IPictureElement Interface

Provides access to members that control the Picture element. Note: the IPictureElement interface has been superseded byIPictureElement3. Please consider using the more recent version.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

When To Use

IPictureElement is the generic interface implemented by all picture elements (BmpPictureElement and EmfPictureElement).  Use this interface when you want to manipulate the properties associated with the picture element.

PictureElements are similar to OleFrame objects, but not quite the same.  The initial difference is that PictureElements are the elements themselves, while OleFrames are the frames around the object.  On a more subtle level, OleFrame objects can contain pictures (bmp files, etc.), but they can also contain other types of OLE objects (word documents, excel spreadsheets, etc.).  PictureElements can only contain pictures (bmp or emf files).

PictureElements can be added to a data frame, but they are normally used within a page layout.


Read-only property Filter Filter used in CFileDialog.
Method ImportPictureFromFile File to be imported.
Read/write property MaintainAspectRatio Indicates if the resize box will maintain the picture's aspect ratio.
Read-only property PictureAspectRatio Filter used in CFileDialog.
Read-only property PictureDescription Description of the Picture Element.
Read/write property SavePictureInDocument Indicates if the Picture will be stored in the Document.

CoClasses that implement IPictureElement

CoClasses and Classes Description
BmpPictureElement The Graphic Element to display BMP Pictures.
EmfPictureElement The Graphic Element to display Emf Pictures.
GifPictureElement Graphic Element to display GIF Pictures.
Jp2PictureElement Graphic Element to display JPEG2000 Pictures.
JpgPictureElement Graphic Element to display JPG Pictures.
PictureElement Picture Graphic Element.
PngPictureElement Graphic Element to display PNG Pictures.
TifPictureElement Graphic Element to display TIF Pictures.