Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 |