SftDirectory 2.5

SftDirectoryFolder.Picture Property

Softel vdm, Inc.

Defines the picture used for the file/folder.

Syntax       

Get

VB.NET

refPictureObj = object.Picture  As stdole.IPictureDispLanguage-specific information

VB

Set refPictureObj = object.Picture  As IPictureDisp

C#.NET

stdole.IPictureDispLanguage-specific information refPictureObj = object.Picture;

VC++

IPictureDisp* refPictureObj = object->GetPicture();

C

HRESULT object->get_Picture(IPictureDisp** refPictureObj);

Delphi

refPictureObj := object.Picture  : IPictureDispLanguage-specific information;

Put

VB.NET

object.let_Picture(ByVal refPictureObj As stdole.IPictureDispLanguage-specific information)

VB

object.Picture = refPictureObj  As IPictureDisp

C#.NET

void object.let_Picture(stdole.IPictureDispLanguage-specific information refPictureObj);

VC++

void object->PutPicture(IPictureDisp* refPictureObj);

C

HRESULT object->put_Picture(IPictureDisp* refPictureObj);

Delphi

procedure object._Set_Picture(refPictureObj : IPictureDispLanguage-specific information);

PutRef

VB.NET

object.Picture = refPictureObj  As stdole.IPictureDispLanguage-specific information

VB

Set object.Picture = refPictureObj  As IPictureDisp

C#.NET

stdole.IPictureDispLanguage-specific information object.Picture = refPictureObj;

VC++

void object->PutRefPicture(IPictureDisp* refPictureObj);

C

HRESULT object->putref_Picture(IPictureDisp* refPictureObj);

Delphi

object.Picture := refPictureObj  : IPictureDispLanguage-specific information;

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).


Feedback / comments / error reports for this topic
© 2003, 2008 - Softel vdm, Inc. - www.softelvdm.com