LibreOffice » svl
View module in: git
Contains non-graphical helper code for office applications.
Specifically this module does not depend on or use includes from module vcl. Originally all code in svtools that did not depend on vcl was split off into this svl (“svtools light”) module.
In particular the
SfxItemSet is a property-bag like container that
stores arbitrary sets of properties for everything from text run
formats, to Chart regression line properties.
There are lots of other useful helpers in here for various office
tasks; much of this code was originally moved from
A small reference counted piece of data. Many subclasses, each with a
unique integer to identify its type (
WhichId). Can be compared for equality
Clone()d, and converted to/from
A pool item may have value semantics (“poolable”), meaning that
there will generally be only one instance that compares equal per item pool,
or not, in which case the item will be
Clone()d quite a bit.
Usually there is one item pool per document, with a range of valid
that is specific to the type of document.
The item pool owns all instances of
SfxPoolItem or its subclasses that have
ever been added to an item set. It also contains a default item for
every WhichId, which will be (depending on parameters) returned from item
sets if the set does not contain an item at this
The item set can be created with a user-supplied range of
SfxPoolItems with matching
WhichIds and ignore attempts to
insert items with non-matching
Items that are successfully inserted into the set will be stored in the
SfxItemPool, and for poolable items only a single instance that
compares equal under the predicate
operator== will be stored in the pool,
regardless of how many sets contain it, thus conserving memory.
There are members
m_pWhichRanges for the valid ranges (as pairs of
m_nCount for the number of items contained, and
m_pItems for the pointers to
the actual items.