poIResultCtrl CancelResult
Cancels any pending tasks associated with a result definition.
Syntax
poIResultCtrl_handle CancelResult id context notify
Application
HyperView Tcl Modify
Description
This command, valid only in Upfront Data Loading Mode, cancels all future tasks, clears and unloads the specified result definition. Returns Success (0) if cancelling was successful or Warning (2) if there was a problem cancelling.
Inputs
- id
- The ID of the result definition to cancel.
- context
- A string indicating the context of the request. Valid values are: scalar, tensor, vector, and iso.
- notify
- Set to 'true' to trigger an event to update the browser, otherwise 'false'. The default value is true.
Example
To cancel loading the scalar result with ID 4:
hwi OpenStack
hwi GetSessionHandle sess
sess GetProjectHandle proj
proj GetPageHandle page [proj GetActivePage]
page GetWindowHandle win [page GetActiveWindow]
win GetClientHandle client
client GetModelHandle model [client GetActiveModel]
model GetResultCtrlHandle rc
rc CancelResult 4 scalar true
hwi CloseStack
Errors
Returns error code if there was an error in cancelling and sets error condition on the session handle. See session_handle GetError.
Related Topics
See the Upfront Data Loader APIs topic for additional information regarding the various Tcl/Tk commands that have been added for this workflow.