SftDirectoryFolder.Picture Property
Defines the picture used for the file/folder.
Syntax
Get
| VB.NET | refPictureObj = object.Picture As stdole.IPictureDisp |
| VB | Set refPictureObj = object.Picture As IPictureDisp |
| C#.NET | stdole.IPictureDisp refPictureObj = object.Picture; |
| VC++ | IPictureDisp* refPictureObj = object->GetPicture(); |
| C | HRESULT object->get_Picture(IPictureDisp** refPictureObj); |
Put
| VB.NET | object.let_Picture(ByVal refPictureObj As stdole.IPictureDisp) |
| VB | object.Picture = refPictureObj As IPictureDisp |
| C#.NET | void object.let_Picture(stdole.IPictureDisp refPictureObj); |
| VC++ | void object->PutPicture(IPictureDisp* refPictureObj); |
| C | HRESULT object->put_Picture(IPictureDisp* refPictureObj); |
PutRef
| VB.NET | object.Picture = refPictureObj As stdole.IPictureDisp |
| VB | Set object.Picture = refPictureObj As IPictureDisp |
| C#.NET | stdole.IPictureDisp object.Picture = refPictureObj; |
| VC++ | void object->PutRefPicture(IPictureDisp* refPictureObj); |
| C | HRESULT object->putref_Picture(IPictureDisp* refPictureObj); |
object
A SftDirectoryFolder object.
refPictureObj
Defines the picture used for the file/folder. Nothing (NULL) can be specified to restore the default icon for the folder.
Comments
The Picture property defines the picture used for the file/folder.
The ShowImages property defines whether the folder images are displayed. It is not possible to suppress folder images for certain folders, unless a blank image is provided.
If the Picture object refPictureObj defines a bitmap, the top, left pixel of the bitmap must contain the bitmap's background color. The color found in the top, left pixel will be replaced throughout the bitmap with the actual background.
The UserPicture event occurs each time when a folder is added/refreshed and an application-specific image can be defined. The image defined using the Picture property is lost once a folder is updated or refreshed (particularly when using AutoReload).
Examples
VB.NET
' A picture box is used to hold the bitmap for the Picture property. A suitable
' bitmap has been defined in the picture box using its Image property.
AxSftDirectory1.CurrentFolder.Picture = OLECvt.ToIPictureDisp(PictureBox1.Image)
View Entire Sample Code
VB6
' A picture box is used to hold the bitmap for the Picture property. A suitable
' bitmap has been defined in the picture box using its Picture property.
Set SftDirectory1.CurrentFolder.Picture = Picture1.Picture
View Entire Sample Code
C#
// A picture box is used to hold the bitmap for the Picture property. A suitable
// bitmap has been defined in the picture box using its Image property.
axSftDirectory1.CurrentFolder.Picture = OLECvt.ToIPictureDisp(pictureBox1.Image);
View Entire Sample Code
C++
PICTDESC PictDesc;
PictDesc.cbSizeofstruct = sizeof(PICTDESC);
PictDesc.picType = PICTYPE_BITMAP;
PictDesc.bmp.hbitmap = LoadBitmap(AfxGetInstanceHandle(), MAKEINTRESOURCE(IDB_A_16x16_BITMAP));
ASSERT(PictDesc.bmp.hbitmap);
PictDesc.bmp.hpal = NULL;
HRESULT hr = OleCreatePictureIndirect(&PictDesc, IID_IPictureDisp, TRUE, (void**)&pIPictureDisp);
ASSERT(SUCCEEDED(hr));
vDir1->CurrentFolder->put_Picture(pIPictureDisp);
View Entire Sample Code
See Also SftDirectoryFolder Object | Object Hierarchy
On
Off