IPictureDisp interface
Exposes the picture object's properties through Automation. It provides a subset of the functionality available through IPicture methods.
When to implement
A picture object implements this interface along with IPicture to provide access to the picture's properties through Automation. Typically, it is not necessary to implement this interface on your own object since there is an OLE-provided picture object.
When to use
Use this interface to change or retrieve the properties of a picture object.
Members
The IPictureDisp interface inherits from the IDispatch interface but does not have additional members.
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
|
Minimum supported client |
Windows 2000 Professional [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows 2000 Server [desktop apps only] |
|
Header |
|
|
IDL |
|
|
IID |
IID_IPictureDisp is defined as 7BF80981-BF32-101A-8BBB-00AA00300CAB |
See also