Requests a later automatic call to collectOrphan().

This method requests that collectOrphan() be called during the document update cycle, deleting the object if it is no longer used.

If the current collection policy is COLLECT_WITH_PARENT, this function has no effect.

See also:

SPObject::collectOrphan

Todo:

This is a temporary hack added to make fill&stroke rebuild its gradient list when the defs are vacuumed. gradient-vector.cpp listens to the modified signal on defs, and now we give it that signal. Mental says that this should be made automatic by merging SPObjectGroup with SPObject; SPObjectGroup would issue this signal automatically. Or maybe just derive SPDefs from SPObjectGroup?

Definition at line 505 of file sp-object.cpp.

References SPDocument::queueForOrphanCollection(), and SPObject::requestModified().

Referenced by SPObject::_updateTotalHRefCount().

                                  {
    g_return_if_fail(document != NULL);
    document->queueForOrphanCollection(this);

    /** \todo
     * This is a temporary hack added to make fill&stroke rebuild its
     * gradient list when the defs are vacuumed.  gradient-vector.cpp
     * listens to the modified signal on defs, and now we give it that
     * signal.  Mental says that this should be made automatic by
     * merging SPObjectGroup with SPObject; SPObjectGroup would issue
     * this signal automatically. Or maybe just derive SPDefs from
     * SPObjectGroup?
     */

    this->requestModified(SP_OBJECT_CHILD_MODIFIED_FLAG);
}