IPictureDisp
The 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.
The following
table describes the dispIDs for the various picture properties.
|
Symbol |
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.
|
|
|
Access
Allowed |
|
|
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 below). |
|
Width |
OLE_XSIZE_HIMETRIC
(long) |
R |
The width
of the picture. |
|
Height |
OLE_YSIZE_HIMETRIC
(long) |
R |
The height
of the picture. |
When to Use
Use this
interface to change or retrieve the properties of a picture object.
Methods in Vtable Order
|
IUnknown
Methods |
Description |
|
QueryInterface |
Returns
pointers to supported interfaces. |
|
AddRef |
Increments
reference count. |
|
Release |
Decrements
reference count. |
See Also