DSRTextTreeNode Class Reference

Class for content item TEXT. More...

Inheritance diagram for DSRTextTreeNode:

DSRDocumentTreeNode DSRStringValue DSRTreeNode DSRTypes List of all members.

Public Member Functions

 DSRTextTreeNode (const E_RelationshipType relationshipType)
 constructor
 DSRTextTreeNode (const E_RelationshipType relationshipType, const OFString &stringValue)
 constructor
virtual ~DSRTextTreeNode ()
 destructor
virtual void clear ()
 clear all member variables.
virtual OFBool isValid () const
 check whether the content item is valid.
virtual OFBool isShort (const size_t flags) const
 check whether the content is short.
virtual OFCondition print (ostream &stream, const size_t flags) const
 print content item.
virtual OFCondition writeXML (ostream &stream, const size_t flags, OFConsole *logStream) const
 write content item in XML format
virtual OFBool containsExtendedCharacters () const
 check if this tree node contains non-ASCII characters in one of the strings affected by SpecificCharacterSet in DICOM

Protected Member Functions

virtual OFCondition readContentItem (DcmItem &dataset, OFConsole *logStream)
 read content item (value) from dataset
virtual OFCondition writeContentItem (DcmItem &dataset, OFConsole *logStream) const
 write content item (value) to dataset
virtual OFCondition readXMLContentItem (const DSRXMLDocument &doc, DSRXMLCursor cursor)
 read content item specific XML data
virtual OFCondition renderHTMLContentItem (ostream &docStream, ostream &annexStream, const size_t nestingLevel, size_t &annexNumber, const size_t flags, OFConsole *logStream) const
 render content item (value) in HTML format

Private Member Functions

 DSRTextTreeNode (const DSRTextTreeNode &)
DSRTextTreeNodeoperator= (const DSRTextTreeNode &)

Detailed Description

Class for content item TEXT.

Definition at line 50 of file dsrtextn.h.


Constructor & Destructor Documentation

DSRTextTreeNode::DSRTextTreeNode const E_RelationshipType  relationshipType  ) 
 

constructor

Parameters:
relationshipType type of relationship to the parent tree node. Should not be RT_invalid or RT_isRoot.

DSRTextTreeNode::DSRTextTreeNode const E_RelationshipType  relationshipType,
const OFString stringValue
 

constructor

Parameters:
relationshipType type of relationship to the parent tree node. Should not be RT_invalid or RT_isRoot.
stringValue initial string value to be set


Member Function Documentation

virtual void DSRTextTreeNode::clear  )  [virtual]
 

clear all member variables.

Please note that the content item might become invalid afterwards.

Reimplemented from DSRDocumentTreeNode.

virtual OFBool DSRTextTreeNode::containsExtendedCharacters  )  const [virtual]
 

check if this tree node contains non-ASCII characters in one of the strings affected by SpecificCharacterSet in DICOM

Returns:
true if node contains non-ASCII characters, false otherwise

Reimplemented from DSRDocumentTreeNode.

virtual OFBool DSRTextTreeNode::isShort const size_t  flags  )  const [virtual]
 

check whether the content is short.

A text is short if the length is <= 40 characters.

Parameters:
flags flag used to customize the output (see DSRTypes::HF_xxx)
Returns:
OFTrue if the content is short, OFFalse otherwise

Reimplemented from DSRDocumentTreeNode.

virtual OFBool DSRTextTreeNode::isValid  )  const [virtual]
 

check whether the content item is valid.

The content item is valid if the two base classes and the concept name are valid.

Returns:
OFTrue if tree node is valid, OFFalse otherwise

Reimplemented from DSRDocumentTreeNode.

virtual OFCondition DSRTextTreeNode::print ostream &  stream,
const size_t  flags
const [virtual]
 

print content item.

A typical output looks like this: contains TEXT:(,,"Text Code")="This is a Text." If the 'flag' PF_shortenLongItemValues is set the text is limited to 40 characters (incl. trailing "...").

Parameters:
stream output stream to which the content item should be printed
flags flag used to customize the output (see DSRTypes::PF_xxx)
Returns:
status, EC_Normal if successful, an error code otherwise

Reimplemented from DSRDocumentTreeNode.

virtual OFCondition DSRTextTreeNode::readContentItem DcmItem dataset,
OFConsole logStream
[protected, virtual]
 

read content item (value) from dataset

Parameters:
dataset DICOM dataset from which the content item should be read
logStream pointer to error/warning output stream (output disabled if NULL)
Returns:
status, EC_Normal if successful, an error code otherwise

Reimplemented from DSRDocumentTreeNode.

virtual OFCondition DSRTextTreeNode::readXMLContentItem const DSRXMLDocument doc,
DSRXMLCursor  cursor
[protected, virtual]
 

read content item specific XML data

Parameters:
doc document containing the XML file content
cursor cursor pointing to the starting node
Returns:
status, EC_Normal if successful, an error code otherwise

Reimplemented from DSRDocumentTreeNode.

virtual OFCondition DSRTextTreeNode::renderHTMLContentItem ostream &  docStream,
ostream &  annexStream,
const size_t  nestingLevel,
size_t &  annexNumber,
const size_t  flags,
OFConsole logStream
const [protected, virtual]
 

render content item (value) in HTML format

Parameters:
docStream output stream to which the main HTML document is written
annexStream output stream to which the HTML document annex is written
nestingLevel current nesting level. Used to render section headings.
annexNumber reference to the variable where the current annex number is stored. Value is increased automatically by 1 after a new entry has been added.
flags flag used to customize the output (see DSRTypes::HF_xxx)
logStream pointer to error/warning output stream (output disabled if NULL)
Returns:
status, EC_Normal if successful, an error code otherwise

Reimplemented from DSRDocumentTreeNode.

virtual OFCondition DSRTextTreeNode::writeContentItem DcmItem dataset,
OFConsole logStream
const [protected, virtual]
 

write content item (value) to dataset

Parameters:
dataset DICOM dataset to which the content item should be written
logStream pointer to error/warning output stream (output disabled if NULL)
Returns:
status, EC_Normal if successful, an error code otherwise

Reimplemented from DSRDocumentTreeNode.

virtual OFCondition DSRTextTreeNode::writeXML ostream &  stream,
const size_t  flags,
OFConsole logStream
const [virtual]
 

write content item in XML format

Parameters:
stream output stream to which the XML document is written
flags flag used to customize the output (see DSRTypes::XF_xxx)
logStream pointer to error/warning output stream (output disabled if NULL)
Returns:
status, EC_Normal if successful, an error code otherwise

Reimplemented from DSRDocumentTreeNode.


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