IPictureDisp interface (ocidl.h)
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 |