DgsGetParent

This function is used to determine the parent of a DGS element.

Syntax

element dgsGetParent( element theElement )  

Required Arguments

• theElement: The child of the parent element you want returned.

Returns

This returns the parent as a DGS element. It returns false if theElement is invalid, or false (You can think of it as the screen or root).

Example

Click to collapse [-]

Client

Consider the following map file:

DGS = exports.dgs
local window = DGS:dgsDxCreateWindow(500, 500, 300, 300, "test window", false) -- create a window
local child = DGS:dgsDxCreateLabel(0, 0, 300, 20, "test label", false, window) -- create a label on the window
local parent = DGS:dgsGetParent(child) -- get the parent of the label
outputChatBox(DGS:dgsGetType(parent)) -- output the type of the parent ( dgs-dxwindow )

See Also

• attachElements
• createElement
• destroyElement
• detachElements
• getAttachedElements
• getElementAlpha
• getElementAttachedOffsets
• getElementAttachedTo
• getElementByIndex
• getElementByID
• getElementChild
• getElementChildren
• getElementChildrenCount
• getElementCollisionsEnabled
• getElementColShape
• getElementData
• getAllElementData
• hasElementData
• getElementDimension
• getElementHealth
• getElementID
• getElementInterior
• getElementMatrix
• getElementModel
• getElementParent
• getElementPosition
• getElementRotation
• getElementsByType
• getElementsWithinColShape
• getElementsWithinRange
• getElementType
• getElementVelocity
• getLowLODElement
• getRootElement
• isElement
• isElementAttached
• isElementCallPropagationEnabled
• isElementDoubleSided
• isElementFrozen
• isElementInWater
• isElementLowLOD
• isElementWithinColShape
• isElementWithinMarker
• setElementAlpha
• setElementAngularVelocity
• getElementAngularVelocity
• setElementAttachedOffsets
• setElementCallPropagationEnabled
• setElementCollisionsEnabled
• setElementData
• setElementDimension
• setElementDoubleSided
• setElementFrozen
• setElementHealth
• setElementID
• setElementInterior
• setElementModel
• setElementParent
• setElementPosition
• setElementRotation
• setElementVelocity
• setLowLODElement
• getPedContactElement
• getResourceDynamicElementRoot
• getResourceRootElement