DVPSTextObject_PList Class Reference

the list of text objects contained in a presentation state (internal use only). More...

List of all members.

Public Member Functions

 DVPSTextObject_PList ()
 default constructor
 DVPSTextObject_PList (const DVPSTextObject_PList &copy)
 copy constructor
DVPSTextObject_PList * clone ()
 clone method.
virtual ~DVPSTextObject_PList ()
 destructor
OFCondition read (DcmItem &dset)
 reads a list of text objects from a DICOM dataset.
OFCondition write (DcmItem &dset)
 writes the list of text objects managed by this object to a DICOM dataset.
void clear ()
 reset the object to initial state.
size_t size () const
 get number of text objects in this list.
DVPSTextObject * getTextObject (size_t idx)
 returns a pointer to the text object with the given index or NULL if it does not exist.
void addTextObject (DVPSTextObject *text)
 adds the given text object to the list of text objects managed by this object.
DVPSTextObject * removeTextObject (size_t idx)
 returns a pointer to the text object with the given index (or NULL if it does not exist) and removes it from the list.
void setLog (OFConsole *stream, OFBool verbMode, OFBool dbgMode)
 sets a new log stream

Private Member Functions

DVPSTextObject_PList & operator= (const DVPSTextObject_PList &)
 private undefined assignment operator

Private Attributes

OFList< DVPSTextObject * > list_
 the list maintained by this object
OFConsole * logstream
 output stream for error messages, never NULL
OFBool verboseMode
 flag indicating whether we're operating in verbose mode
OFBool debugMode
 flag indicating whether we're operating in debug mode

Detailed Description

the list of text objects contained in a presentation state (internal use only).

This class manages the data structures comprising one complete Text Object Sequence which is contained in one item of the Graphic Annotation Sequence in a Presentation State object.

Definition at line 50 of file dvpstxl.h.

Member Function Documentation

void DVPSTextObject_PList::addTextObject (  DVPSTextObject *  text  ) 
 

adds the given text object to the list of text objects managed by this object.

Parameters:
text text object to be inserted.

void DVPSTextObject_PList::clear (   ) 
 

reset the object to initial state.

After this call, the object is in the same state as after creation with the default constructor.

DVPSTextObject_PList* DVPSTextObject_PList::clone (   )  [inline]
 

clone method.

Returns:
a pointer to a new DVPSTextObject_PList object containing a deep copy of this object.

Definition at line 63 of file dvpstxl.h.

References DVPSTextObject_PList().

DVPSTextObject* DVPSTextObject_PList::getTextObject (  size_t  idx  ) 
 

returns a pointer to the text object with the given index or NULL if it does not exist.

Parameters:
idx index, must be < size()
Returns:
pointer to text object or NULL

OFCondition DVPSTextObject_PList::read (  DcmItem &  dset  ) 
 

reads a list of text objects from a DICOM dataset.

The DICOM elements of the Text Object Sequence are copied from the dataset to this object. The completeness of the item (presence of all required elements, value multiplicity) is checked. If this method returns an error code, the object is in undefined state afterwards.

Parameters:
dset the dataset from which the TextObjectSequence is to be read
Returns:
EC_Normal if successful, an error code otherwise.

DVPSTextObject* DVPSTextObject_PList::removeTextObject (  size_t  idx  ) 
 

returns a pointer to the text object with the given index (or NULL if it does not exist) and removes it from the list.

Parameters:
idx index, must be < size()
Returns:
pointer to text object or NULL

void DVPSTextObject_PList::setLog (  OFConsole *  stream,
OFBool  verbMode,
OFBool  dbgMode
) 
 

sets a new log stream

Parameters:
stream new log stream, NULL for default logstream
verbMode verbose mode flag
dbgMode debug mode flag

size_t DVPSTextObject_PList::size (   )  const [inline]
 

get number of text objects in this list.

Returns:
the number of text objects.

Definition at line 96 of file dvpstxl.h.

References list_, and OFList< T >::size().

OFCondition DVPSTextObject_PList::write (  DcmItem &  dset  ) 
 

writes the list of text objects managed by this object to a DICOM dataset.

Copies of the DICOM elements managed by this object are inserted into the DICOM dataset.

Parameters:
dset the dataset to which the TextObjectSequence is written
Returns:
EC_Normal if successful, an error code otherwise.

The documentation for this class was generated from the following file:

Generated on 20 Dec 2005 for OFFIS DCMTK Version 3.5.4 by Doxygen 1.4.5