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

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.

Members

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

Classes that implement IPictureElement