WireLess Studio Widgets Developer's Guide

SetLoadMode

This method changes the way the data displayed by a WS_LIST_CTRL widget is processed and transferred to the mobile unit.

Parameters

sObjectName

The name of the target widget.

usObjectId

The id of the target widget.

bLoadMode

The new load mode.

Return Value

On success, SetLoadMode returns TRUE, FALSE otherwise. To get extended information, call WStError::GetLastErrorCode.

Remarks

The available load modes are:

• WS_LIST_CTRL_LOAD_FROM_MEM: Rows can be added, deleted and modified using all the methods available for the WS_LIST_CTRL widget. When the parent form is serialized the rows of the widget affected by this mode will be also serialized.
• WS_LIST_CTRL_LOAD_FROM_FILE: To add, remove and modify rows on this load mode, the user must modify the data file instead of calling the methods AddRow, DeleteRow and SetRowText. SetRowIcon can be called to modified the row icons. When the parent form is serialized the rows of the widget affected by this mode won't be serialized.

The available load modes can be found on the WSTWidgetConstants enumeration.

Example

using WirelessStudioOleWidgets;
WStWidget oWidget = new WStWidget();
RFFile oFile = new RFFile();
short sListCtrlId= 4;
oFactory.CreateWidgetById((short)WSTFactoryConstants.WS_LIST_CTRL, sListCtrlId, "", 0,0, 50, 50, "");
oWidget.AddColumById(sListCtrlId, 40, "Product Id");
oFile.RFTransferFile("../SamplesWidgets\Exe\Resources\data.txt", oFile.GetRemoteTempFolder() + "\data.txt", True);
oWidget.ReadRowsFromFileById(sListCtrlId, "../SamplesWidgets\Exe\Resources\data.txt", sRemoteTempFolder + "\data.txt");

Public wsWidget As New WStWidget
...
Case "loadRowsFromDataBtn"
	'Fulfills the WS_LISTCTRL widget using the data.txt file
	wsWidget.SetLoadModeByName "myListCtrl", WS_LIST_CTRL_LOAD_FROM_FILE
	wsWidget.ReadRowsFromFileByName "myListCtrl", "../SamplesWidgets\Exe\Resources\data.txt", _
	sRemoteTempFolder + "\data.txt"
...

See also

ReadRowsFromFile | SetRowText | DeleteRow | SetRowIcon | AddRow | ClearRows | AddColumn | ClearColumns | GetSelectedItem

WStWiget class reference | WStForm class reference | WStFactory class reference | WStError class reference