modified

Arguments: window

Returns true if the argument has been modified since the most recent time it was saved to a file. This function is typically used to determine whether an object needs to be saved.

Whether an object has been modified depends on the type of object. A text-edit-pane has been modified if the text has been changed. A form if any control on the form has been changed (resized, moved, or with different property values). A project is modified if any modules, libraries, subprojects, or files have been added or deleted or themselves changed, or the properties of the project have been changed, or the associated .lpr file has been changed. A grid-widget is modified if its delay-write-cell-value property is true and it has any pending user edits. An object-editor is modified if there are any unsaved edits to its currently-displayed instance.

An application could call (setf modified) on a text-edit-pane (or rich-edit-pane) with a value of nil to declare that the window's contents do not currently need to be saved. This would typically be useful immediately after programmatically placing some initial text into the control for the end user to modify. On the other hand, it is generally unnecessary for an application to set the value to true because this is done internally whenever the content changes.

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.