pbOfflineEditing - cWebList

Determines whether the client will make server calls as the user navigates different rows or enters a new row

Type: Property (Web Property)

Access: Read/Write

Data Type: Boolean

Parameters: None

Syntax
 { WebProperty=Client }
 Property Boolean pbOfflineEditing

Web Property Read Access: WebGet pbOfflineEditing to BooleanVariable
Web Property Write Access: WebSet pbOfflineEditing to BooleanVariable/Value

Read Access: Get pbOfflineEditing to BooleanVariable
Write Access: Set pbOfflineEditing to BooleanVariable/Value


Description

Normally, when the application user navigates from one row to the next, the client will send messages and events to the server to notify it of the row change, perform any necessary row save, refresh the row being navigated to or initialize the new row.

When pbOfflineEditing is False, then the above calls will be sent to the server during row navigation. When pbOfflineEditing is True, the above calls are not made to the server.

These operations are important in a cWebGrid object if it is data-aware (pbDataAware = True) to ensure the grid performs the necessary database operations correctly. The default value for pbOfflineEditing for a cWebGrid or cWebList is False, i.e. the notification messages and events will be sent to the server as necessary.

Set pbOfflineEditing to True in a non-data-aware grid if you do not want to support saving when the user navigates out of a row and you do not want to support refreshing the row that the user navigates into. In this case, you may decide to save all grid rows in a single (batch processing) operation. For more information about saving grid data, see cWebGrid.

In a cWebPromptList object, it is not necessary to send these notification messages to the server. The default value for pbOfflineEditing in a cWebPromptList is True, i.e. the notification messages and events are not sent to the server. This is to maximise the performance and user experience for prompt lists.


About Web Properties
Each web property maintains two values: The regular property value is set during object creation and should not be changed during the lifetime of that object. To access that value, use the standard property Get and Set syntax.
The web property value is the local value stored at each client. This is synchronized to the client's local value whenever a server call is being processed. To access the web property value, use the WebGet and WebSet syntax above instead of the standard Get and Set syntax.
See Also

OnSaveRow | OnNewRow