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



In This Topic
    FunctionalGroupOrRootLevelAttribute(Int32,Int32,Int32,Int32,Int32) Method
    In This Topic
    Return the required DicomAttribute within a specified functional group within a DicomDataSet
    Syntax
    'Declaration
     
    
    Public Overloads Function FunctionalGroupOrRootLevelAttribute( _
       ByVal FunctionalGroup As Integer, _
       ByVal FunctionalElement As Integer, _
       ByVal Frame As Integer, _
       ByVal Group As Integer, _
       ByVal Element As Integer _
    ) As DicomAttribute
    'Usage
     
    
    Dim instance As DicomDataSet
    Dim FunctionalGroup As Integer
    Dim FunctionalElement As Integer
    Dim Frame As Integer
    Dim Group As Integer
    Dim Element As Integer
    Dim value As DicomAttribute
     
    value = instance.FunctionalGroupOrRootLevelAttribute(FunctionalGroup, FunctionalElement, Frame, Group, Element)
    public DicomAttribute FunctionalGroupOrRootLevelAttribute( 
       int FunctionalGroup,
       int FunctionalElement,
       int Frame,
       int Group,
       int Element
    )
    public:
    DicomAttribute^ FunctionalGroupOrRootLevelAttribute( 
       int FunctionalGroup,
       int FunctionalElement,
       int Frame,
       int Group,
       int Element
    ) 

    Parameters

    FunctionalGroup
    The Group of the requested dataset
    FunctionalElement
    The Element of the requested dataset
    Frame
    The frame number to which the dataset should apply
    Group
    The Group number of the requested attribute within the dataset
    Element
    The Element number 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 Group and Element used to identify the functional group are independent of the Group and Element 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