The "dirty" status of a document, page, or layer indicates whether the element has been modified. You can request the dirty status of documents, pages, and layers, or you can set it.
To request or set the dirty status of a document, page, or layer:
· Use the IN_GetState and IN_SetState function. Specify a document ID, page ID, or layer ID as the objectID.
The options to set are: clean, modified, deleted, and new. Modified since load (saved locally only, but not saved to the database) can only be returned. For pages, the deleted option is not available. In each case, options can be ORed.
With the IN_GetDirtyPageIDs function, you can also request the number of dirty pages and a list of their identifiers. With the IN_GetDirtyDocumentWindows function, you can request the number of document windows that have been changed and their identifiers.
See also