#ifndef SEEN_INKSCAPE_SELECTION_H #define SEEN_INKSCAPE_SELECTION_H /* * Authors: * Lauris Kaplinski * MenTaLguY * bulia byak * Adrian Boguszewski * * Copyright (C) 2016 Adrian Boguszewski * Copyright (C) 2004-2005 MenTaLguY * Copyright (C) 1999-2002 Lauris Kaplinski * Copyright (C) 2001-2002 Ximian, Inc. * * Released under GNU GPL, read the file 'COPYING' for more information */ #include #include #include #include #include "inkgc/gc-managed.h" #include "gc-finalized.h" #include "gc-anchored.h" #include "sp-item.h" #include "object-set.h" class SPItem; namespace Inkscape { class LayerModel; namespace XML { class Node; } } namespace Inkscape { /** * The set of selected SPObjects for a given document and layer model. * * This class represents the set of selected SPItems for a given * document (referenced in LayerModel). * * An SPObject and its parent cannot be simultaneously selected; * selecting an SPObjects has the side-effect of unselecting any of * its children which might have been selected. * * This is a per-desktop object that keeps the list of selected objects * at the given desktop. Both SPItem and SPRepr lists can be retrieved * from the selection. Many actions operate on the selection, so it is * widely used throughout the code. * It also implements its own asynchronous notification signals that * UI elements can listen to. */ class Selection : public Inkscape::GC::Managed<>, public Inkscape::GC::Finalized, public Inkscape::GC::Anchored, public ObjectSet { friend class ObjectSet; public: /** * Constructs an selection object, bound to a particular * layer model * * @param layers the layer model (for the SPDesktop, if GUI) * @param desktop the desktop associated with the layer model, or NULL if in console mode */ Selection(LayerModel *layers, SPDesktop *desktop); ~Selection(); /** * Returns the layer model the selection is bound to (works in console or GUI mode) * * @return the layer model the selection is bound to, which is the same as the desktop * layer model for GUI mode */ LayerModel *layers() { return _layers; } /** * Returns active layer for selection (currentLayer or its parent). * * @return layer item the selection is bound to */ SPObject *activeContext(); using ObjectSet::add; /** * Add an XML node's SPObject to the set of selected objects. * * @param the xml node of the item to add */ void add(XML::Node *repr) { add(_objectForXMLNode(repr)); } using ObjectSet::set; /** * Set the selection to an XML node's SPObject. * * @param repr the xml node of the item to select */ void set(XML::Node *repr) { set(_objectForXMLNode(repr)); } using ObjectSet::remove; /** * Removes an item from the set of selected objects. * * It is ok to call this method for an unselected item. * * @param repr the xml node of the item to remove */ void remove(XML::Node *repr) { remove(_objectForXMLNode(repr)); } using ObjectSet::includes; /** * Returns true if the given item is selected. */ bool includes(XML::Node *repr) { return includes(_objectForXMLNode(repr)); } /** Returns the number of layers in which there are selected objects. */ size_t numberOfLayers(); /** Returns the number of parents to which the selected objects belong. */ size_t numberOfParents(); /** * Compute the list of points in the selection that are to be considered for snapping from. * * @return Selection's snap points */ std::vector getSnapPoints(SnapPreferences const *snapprefs) const; /** * Connects a slot to be notified of selection changes. * * This method connects the given slot such that it will * be called upon any change in the set of selected objects. * * @param slot the slot to connect * * @return the resulting connection */ void emitModified(){ _emitModified(this->_flags); }; sigc::connection connectChanged(sigc::slot const &slot) { return _changed_signal.connect(slot); } sigc::connection connectChangedFirst(sigc::slot const &slot) { return _changed_signal.slots().insert(_changed_signal.slots().begin(), slot); } /** * Connects a slot to be notified of selected object modifications. * * This method connects the given slot such that it will * receive notifications whenever any selected item is * modified. * * @param slot the slot to connect * * @return the resulting connection * */ sigc::connection connectModified(sigc::slot const &slot) { return _modified_signal.connect(slot); } sigc::connection connectModifiedFirst(sigc::slot const &slot) { return _modified_signal.slots().insert(_modified_signal.slots().begin(), slot); } protected: void _emitSignals(); void _connectSignals(SPObject* object); void _releaseSignals(SPObject* object); private: /** no copy. */ Selection(Selection const &); /** no assign. */ void operator=(Selection const &); /** Issues modification notification signals. */ static int _emit_modified(Selection *selection); /** Schedules an item modification signal to be sent. */ void _schedule_modified(SPObject *obj, unsigned int flags); /** Issues modified selection signal. */ void _emitModified(unsigned int flags); /** Issues changed selection signal. */ void _emitChanged(bool persist_selection_context = false); /** returns the SPObject corresponding to an xml node (if any). */ SPObject *_objectForXMLNode(XML::Node *repr) const; /** Releases an active layer object that is being removed. */ void _releaseContext(SPObject *obj); LayerModel *_layers; SPObject* _selection_context; unsigned int _flags; unsigned int _idle; std::map _modified_connections; sigc::connection _context_release_connection; sigc::signal _changed_signal; sigc::signal _modified_signal; }; } #endif /* Local Variables: mode:c++ c-file-style:"stroustrup" c-file-offsets:((innamespace . 0)(inline-open . 0)(case-label . +)) indent-tabs-mode:nil fill-column:99 End: */ // vim: filetype=cpp:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:fileencoding=utf-8:textwidth=99 :