From 3547b1082098934d583f2c483c8eb5a59e9c2bbb Mon Sep 17 00:00:00 2001 From: Krzysztof Kosi??ski Date: Tue, 23 Sep 2008 23:34:58 +0000 Subject: * Lots of documentation for the Inkscape::XML namespace * Doxygen fixes for a few files * Garbage-collected allocator for STL containers (bzr r6877) --- src/xml/node-event-vector.h | 31 +++++++++++++++++++++++-------- 1 file changed, 23 insertions(+), 8 deletions(-) (limited to 'src/xml/node-event-vector.h') diff --git a/src/xml/node-event-vector.h b/src/xml/node-event-vector.h index 920e28475..0c291c230 100644 --- a/src/xml/node-event-vector.h +++ b/src/xml/node-event-vector.h @@ -1,10 +1,7 @@ -#ifndef SEEN_INKSCAPE_XML_SP_REPR_EVENT_VECTOR -#define SEEN_INKSCAPE_XML_SP_REPR_EVENT_VECTOR - -/* - * Fuzzy DOM-like tree implementation - * - * Authors: +/** @file + * @brief Deprecated structure for a set of callbacks for node state changes + */ +/* Authors: * Lauris Kaplinski * Frank Felfe * @@ -14,6 +11,9 @@ * Released under GNU GPL, read the file 'COPYING' for more information */ +#ifndef SEEN_INKSCAPE_XML_SP_REPR_EVENT_VECTOR +#define SEEN_INKSCAPE_XML_SP_REPR_EVENT_VECTOR + #include #include "xml/node.h" @@ -21,6 +21,10 @@ namespace Inkscape { namespace XML { +/** + * @brief Structure holding callbacks for node state changes + * @deprecated Derive an observer object from the NodeObserver class instead + */ struct NodeEventVector { /* Immediate signals */ void (* child_added) (Node *repr, Node *child, Node *ref, void * data); @@ -33,13 +37,24 @@ struct NodeEventVector { } } +/** + * @brief Generate events corresponding to the node's state + * @deprecated Use Node::synthesizeEvents(NodeObserver &) instead + */ inline void sp_repr_synthesize_events (Inkscape::XML::Node *repr, const Inkscape::XML::NodeEventVector *vector, void * data) { repr->synthesizeEvents(vector, data); } - +/** + * @brief Add a set of callbacks for node state changes and its associated data + * @deprecated Use Node::addObserver() instead + */ inline void sp_repr_add_listener (Inkscape::XML::Node *repr, const Inkscape::XML::NodeEventVector *vector, void * data) { repr->addListener(vector, data); } +/** + * @brief Remove a set of callbacks based on associated data + * @deprecated Use Node::removeObserver() instead + */ inline void sp_repr_remove_listener_by_data (Inkscape::XML::Node *repr, void * data) { repr->removeListenerByData(data); } -- cgit v1.2.3