SftDirectory.AutoInitialLoad Property
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); |
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); |
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.
See Also SftDirectory Object | Object Hierarchy
On
Off