DtEditorCheckForUnsavedChanges(3) — Subroutines
NAME
DtEditorCheckForUnsavedChanges − report whether text has been edited
???? dear component owner: had to change the wording in the name field to conform to X/Open style. Is this wording ok ????
SYNOPSIS
#include <Dt/Editor.h>
Boolean DtEditorCheckForUnsavedChanges(Widget widget);
DESCRIPTION
The DtEditorCheckForUnsavedChanges() function reports whether the text contained in the edit window of a DtEditor widget has been modified since the last call to DtEditorGetContents(3) or DtEditorSaveContentsToFile(3), including inserting, deleting or moving of text with the keyboard or mouse. For information about retrieving the text without affecting whether DtEditorCheckForUnsavedChanges() reports that all changes have been saved, refer to DtEditorGetContents(3) and DtEditorSaveContentsToFile(3).
The widget argument specifies the DtEditor widget ID.
For a complete definition of the DtEditor widget and its associated resources, see DtEditor(3).
RETURN VALUE
Upon successful completion, the DtEditorCheckForUnsavedChanges() function returns True if changes have been made to the contents of the DtEditor widget since the last call to DtEditorGetContents(3) or DtEditorSaveContentsToFile(3); otherwise, it returns False.
SEE ALSO
DtEditor(5), DtEditor(3), DtEditorGetContents(3), DtEditorSaveContentsToFile(3).
— 3 May 1994