X# Runtime and VO SDK Reference
X# Runtime and VO SDK Reference
VO Namespace
DataWindow Class
DataWindow Methods
DataWindow.Activate Method
DataWindow.Append Method
DataWindow.ButtonClick Method
DataWindow.Cancel Method
DataWindow.CanvasErase Method
DataWindow.ChangeFont Method
DataWindow.CheckStatus Method
DataWindow.Clear Method
DataWindow.ClearRelations Method
DataWindow.Close Method
DataWindow.Commit Method
DataWindow.ControlFocusChange Method
DataWindow.Copy Method
DataWindow.Cut Method
DataWindow.DeActivate Method
DataWindow.DeactivateAllOLEObjects Method
DataWindow.Delete Method
DataWindow.DeleteValidated Method
DataWindow.Destroy Method
DataWindow.DisableConditionalControls Method
DataWindow.Dispatch Method
DataWindow.Draw Method
DataWindow.EditChange Method
DataWindow.EnableConditionalControls Method
DataWindow.EnableDragDropClient Method
DataWindow.EnableStatusBar Method
DataWindow.EnableToolTips Method
DataWindow.Error Method
DataWindow.Expose Method
DataWindow.FIELDGET Method
DataWindow.FIELDPUT Method
DataWindow.FocusChange Method
DataWindow.GetAllChildren Method
DataWindow.GoBottom Method
DataWindow.GoTo Method
DataWindow.GoTop Method
DataWindow.HelpRequest Method
DataWindow.Hide Method
DataWindow.HorizontalScroll Method
DataWindow.HorizontalSlide Method
DataWindow.HorizontalSpin Method
DataWindow.InsertObject Method
DataWindow.LineTo Method
DataWindow.ListBoxClick Method
DataWindow.ListBoxSelect Method
DataWindow.MouseButtonDown Method
DataWindow.MoveTo Method
DataWindow.Notify Method
DataWindow.OK Method
DataWindow.OLEInPlaceActivate Method
DataWindow.OLEInPlaceDeactivate Method
DataWindow.PaintBoundingBox Method
DataWindow.Paste Method
DataWindow.PasteSpecial Method
DataWindow.PreValidate Method
DataWindow.QueryClose Method
DataWindow.RegisterConditionalControls Method
DataWindow.RePaint Method
DataWindow.RepaintBoundingBox Method
DataWindow.Resize Method
DataWindow.Seek Method
DataWindow.SetAlignStartSize Method
DataWindow.SetRelation Method
DataWindow.SetSelectiveRelation Method
DataWindow.Show Method
DataWindow.Skip Method
DataWindow.SkipNext Method
DataWindow.SkipPrevious Method
DataWindow.StatusOK Method
DataWindow.TextPrint Method
DataWindow.ToolBarHeightChanged Method
DataWindow.Undo Method
DataWindow.UndoAll Method
DataWindow.UpdateActiveObject Method
DataWindow.Use Method
DataWindow.VerticalScroll Method
DataWindow.VerticalSlide Method
DataWindow.VerticalSpin Method
DataWindow.ViewAs Method
DataWindow.ViewForm Method
DataWindow.ViewTable Method
Click or drag to resize

DataWindow.Cancel Method

X#
Discard all information entered in this data window and close the window.

Namespace:  VO
Assembly:  VOGUIClasses (in VOGUIClasses.dll) Version: 2.19
Syntax
Copy
 VIRTUAL METHOD Cancel() AS USUAL
Request Example View Source

Return Value

Type: Usual
TRUE if successful; otherwise, FALSE.
Remarks
The "cancel" operation is very clear and easily understood and might be profitably used on data windows when they are created as MDI children (unconventional or not). Note that a user might be unclear on exactly what transactions are discarded. For example, if several records have been modified, the default implementation of DataWindow:Cancel() discards changes only to the current record. You might want to label the button or menu command something else or provide a more comprehensive implementation.
Tip Tip
DataWindow:Cancel() disconnects itself from the data server using DataServer:UnregisterClient() and tells the server that it can close itself if it has no other registered clients. Explicitly forcing the server to close from a window is not recommended, since this can create future problems. Modifications to the application can attach other clients to the server, and any one window should not disable other windows.
See Also