Picture Property

Retrieves a Microsoft Visual Basic picture object.

Syntax

[ pvResult = ] Vector.Picture( [Width] [, Height])

Possible Values

> > > > > > > > > > >
Width Optional. Long value.
0 Default. If the Vector of bytes contains an image file, then Width and Height are ignored. Otherwise, a Vector of bytes must be RGB data and a Vector of Long values must be ARGB data.
HeightOptional. Long value. > > > > > > > >
0Default. If the Vector of bytes contains an image file, then Width and Height are ignored. Otherwise, a Vector of bytes must be RGB data and a Vector of Long values must be ARGB data.
pvResultReturns a Visual Basic picture object on success.
> > The property is read-only. The property has no default value.

Remarks

Because vectors can contain an ImageFile, this property provides an easy way to access the image as a Visual Basic picture object. Like the ImageFile (Vector) property, the Picture property supports three different types of image vectors. For more information about the three types of image vectors, see the ImageFile (Vector) property.

For example code, see Create an ImageFile Object that Contains a Blank Page in Shared Samples.

Although the previous example uses the ImageFile (Vector) property instead of the Picture property to access the image contained in the Vector, it does demonstrate creating a new image Vector.

For more information about raw ARGB Bitmap Data, see the Remarks section of the ImageFile object's ARGBData property. Since raw ARGB Bitmap Data does not contain any information about the height or width, you need to provide these values so that the Microsoft Windows Image Acquisition (WIA) Automation Library can successfully create the Picture object.

For additional example code, see Download New Items as They are Created in Shared Samples.

Property Information

Minimum operating systems Windows XP SP1