This document is archived and information here might be outdated.  Recommended version.

IPictureElement Interface (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Carto > ESRI.ArcGIS.Carto > Interfaces > IP > IPictureElement Interface
ArcGIS Developer Help

IPictureElement Interface

Provides access to members that control the Picture element. Note: the IPictureElement interface has been superseded by IPictureElement3. 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.


Name Description
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.

Classes that implement IPictureElement

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.
ImgPictureElement Graphic Element to display IMG Pictures. This coclass is deprecated. It will not be available in a future release.
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.
SidPictureElement Graphic Element to display SID Pictures. This coclass is deprecated. It will not be available in a future release.
TifPictureElement Graphic Element to display TIF Pictures.