SftDirectory 2.5

SftDirectory.AutoInitialLoad Property

Softel vdm, Inc.

Defines whether the control's contents are automatically loaded when the control is initially created.

Syntax       

Get

VB.NET

Boolean = object.AutoInitialLoad  As Boolean

VB

Boolean = object.AutoInitialLoad  As Boolean

C#.NET

bool Boolean = object.AutoInitialLoad;

VC++

VARIANT_BOOL Boolean = object->AutoInitialLoad;
VARIANT_BOOL Boolean = object->GetAutoInitialLoad();

C

HRESULT object->get_AutoInitialLoad(VARIANT_BOOL* Boolean);

Delphi

Boolean := object.AutoInitialLoad   : WordBool;

Put

VB.NET

object.AutoInitialLoad = Boolean  As Boolean

VB

object.AutoInitialLoad = Boolean  As Boolean

C#.NET

bool object.AutoInitialLoad = Boolean;

VC++

VARIANT_BOOL object->AutoInitialLoad = Boolean;
void object->PutAutoInitialLoad(VARIANT_BOOL Boolean);

C

HRESULT object->put_AutoInitialLoad(VARIANT_BOOL Boolean);

Delphi

object.AutoInitialLoad := Boolean   : WordBool;

object

A SftDirectory object.

Boolean

Defines whether the control's contents are automatically loaded when the control is initially created.

Boolean

Description

True

The control's contents are automatically loaded when the control is initially created.

False

The control's contents are not automatically loaded when the control is initially created.

Comments

The AutoInitialLoad property defines whether the control's contents are automatically loaded when the control is initially created.

If set to False, the control will not load its contents immediately. This may be necessary if user-defined contents are added in certain columns or if filtering using the Filtering event is desired. The UserContents, UserPicture or Filtering events may not occur when the control is initially created, due to certain environment restrictions. For example, in Visual Basic, the UserContents, UserPicture and Filtering events are not generated until the Form_Load event has occurred. The control however is created before the Form_Load event occurs, preventing the UserContents, UserPicture and Filtering events from being handled by the application. This in effect prevents any filtering or user-defined contents from being added to the control. The solution is to set AutoInitialLoad to False and use the control's Reload method in the Form_Load event. Setting AutoInitialLoad to False isn't absolutely necessary, but it may save processing time as the control contents are only loaded once, in response to the Reload method.


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