DicomObjects.NET8 Documentation
DicomObjects Namespace / DicomDataSet Class / FunctionalGroupOrRootLevelAttribute Method / FunctionalGroupOrRootLevelAttribute(Keyword,Int32,Keyword) Method
The keyword of the requested dataset
The frame number to which the dataset should apply
The keyword of the requested attribute within the dataset



In This Topic
    FunctionalGroupOrRootLevelAttribute(Keyword,Int32,Keyword) Method
    In This Topic
    Return the required DicomAttribute within a specified functional group within a DicomDataSet If DicomAttribute is not present in the specified DicomDataSet, it searches amongst the root level attributes
    Syntax
    'Declaration
     
    
    Public Overloads Function FunctionalGroupOrRootLevelAttribute( _
       ByVal FunctionalAttribute As Keyword, _
       ByVal Frame As Integer, _
       ByVal keyword As Keyword _
    ) As DicomAttribute
    'Usage
     
    
    Dim instance As DicomDataSet
    Dim FunctionalAttribute As Keyword
    Dim Frame As Integer
    Dim keyword As Keyword
    Dim value As DicomAttribute
     
    value = instance.FunctionalGroupOrRootLevelAttribute(FunctionalAttribute, Frame, keyword)
    public DicomAttribute FunctionalGroupOrRootLevelAttribute( 
       Keyword FunctionalAttribute,
       int Frame,
       Keyword keyword
    )
    public:
    DicomAttribute^ FunctionalGroupOrRootLevelAttribute( 
       Keyword FunctionalAttribute,
       int Frame,
       Keyword keyword
    ) 

    Parameters

    FunctionalAttribute
    The keyword of the requested dataset
    Frame
    The frame number to which the dataset should apply
    keyword
    The keyword of the requested attribute within the dataset

    Return Value

    The requested DicomAttribute
    Remarks
    The enhanced DICOM multi-frame objects (e.g. enhanced CT and MRI) allow many attributes to be held in functional group macros, which may be either:
    • The same for all frames - in the "Shared Functional Groups Sequence" (5200,9229)
    • Different for different frames - in the "Per-frame Functional Groups Sequence" (5200,9230)
    This method allows an attribute to be retrieved from the chosen dataset, irrespective of which sequence it is in. Note that the DicomObjects.Enums.Keyword used to identify the functional group is independent of the DicomObjects.Enums.Keyword of individual attributes within that DataSet.
    Requirements

    Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

    See Also