PropertyHandle :: IsDirty - Is property handle dirty
The function checks, whether the selection or instance in a property handle has been changed. This happens in client/server mode, when the selection or instance in a property handle on the server side differs from the selection or instance on the client side.
Usually, the client automatically submits a refresh, when the instance is dirty after a client server action, e.g. after executing an action. The application can avoid the refresh by resetting the dirty flag (ResetDirty()).
Return value: Return value ( logical )
The function returns YES when the question was answered positively. Otherwise it returns NO.