Edit

Share via

IPictureDisp interface (ocidl.h)

  • Article

Exposes the picture object's properties through Automation. It provides a subset of the functionality available through IPicture methods.

Inheritance

The IPictureDisp interface inherits from the IDispatch interface.

Remarks

The following table describes the dispIDs for the various picture properties.

Constant Value
DISPID_PICT_HANDLE 0
DISPID_PICT_HPAL 2
DISPID_PICT_TYPE 3
DISPID_PICT_WIDTH 4
DISPID_PICT_HEIGHT 5
DISPID_PICT_RENDER 6
 

Each property in the IPictureDisp interface includes a get_PropertyName method if the property supports read access and a put_PropertyName method if the property supports write access. Most of the properties support read access only with the exception of the hPal property.

Property Type Access Description
Handle OLE_HANDLE (int) R The Windows GDI handle of the picture
hPal OLE_HANDLE (int) RW The Windows handle of the palette used by the picture.
Type short R The type of picture (see PICTYPE).
Width OLE_XSIZE_HIMETRIC (long) R The width of the picture.
Height OLE_YSIZE_HIMETRIC (long) R The height of the picture.
 

OLE Implementation

Picture objects provide a language-neutral abstraction for bitmaps, icons, and metafiles. As with the standard font object, the system provides a standard implementation of the picture object. Its primary interfaces are IPicture and IPictureDisp. A picture object is created with OleCreatePictureIndirect and supports both the IPicture and the IPictureDisp interfaces.

The OLE-provided picture object implements the complete semantics of the IPicture and IPictureDisp interfaces.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header ocidl.h

See also

IPicture