GetComponentInParent
The non-generic version of this method.
Read time 6 minutesLast updated 6 days ago
Definition
- Type: Method
- Namespace: UnityEngine
- Assembly: UnityEngine.CoreModule
GetComponentInParent(Type, bool)
The non-generic version of this method.
public Component GetComponentInParent(Type t, bool includeInactive)
Parameters
Returns
Type | Description |
|---|---|
| Component | A Component of the matching |
Remarks
This version of GetComponentInParent is not as efficient as the Generic version (above), so you should only use it if necessary.
Examples
using UnityEngine;public class GetComponentInParentExample : MonoBehaviour{ void Start() { HingeJoint hinge = GetComponentInParent(typeof(HingeJoint)) as HingeJoint; if (hinge != null) { hinge.useSpring = false; } else { // Try again by including inactive GameObjects. hinge = GetComponentInParent(typeof(HingeJoint), true) as HingeJoint; if (hinge != null) hinge.useSpring = false; } }}
GetComponentInParent(Type)
The non-generic version of this method.
public Component GetComponentInParent(Type t)
Parameters
The type of component to search for.
Returns
Type | Description |
|---|---|
| Component | A Component of the matching |
Remarks
This version of GetComponentInParent is not as efficient as the Generic version (above), so you should only use it if necessary.
Examples
using UnityEngine;public class GetComponentInParentExample : MonoBehaviour{ void Start() { HingeJoint hinge = GetComponentInParent(typeof(HingeJoint)) as HingeJoint; if (hinge != null) { hinge.useSpring = false; } else { // Try again by including inactive GameObjects. hinge = GetComponentInParent(typeof(HingeJoint), true) as HingeJoint; if (hinge != null) hinge.useSpring = false; } }}
GetComponentInParent<T>(bool)
Gets a reference to a component of type on the same GameObject as the component specified, or any parent of the GameObject.
Tpublic T GetComponentInParent<T>(bool includeInactive)
Parameters
Whether to include inactive parent GameObjects in the search.
Returns
Type | Description |
|---|---|
| T | A Component of the matching type |
Remarks
The typical usage for this method is to call it from a MonoBehaviour script (which itself is a type of component), to find references to other Components or MonoBehaviours attached to the same GameObject as that script, or its parent GameObjects. In this case you can call the method with no preceding object specified. For example:
myResults = GetComponentInParent<ComponentType>()You can also call this method on a reference to different component, which might be attached to a different GameObject. In this case, the GameObject to which that component is attached, and its parents, are searched. For example:
myResults = otherComponent.GetComponentInParent<ComponentType>()This method checks the GameObject on which it is called first, then recurses upwards through each parent GameObject, until it finds a matching Component of the type specified.
TOnly active GameObjects are included in the search, unless you call the method with the parameter set to , in which case inactive GameObjects are also included. This applies to the GameObject on which the method is called.
includeInactivetrueNote: GetComponentInParent returns only the first matching component found, and the order that the components are checked on any individual GameObject is not defined. Therefore, if there are more than one of the specified type that could match on any individual GameObject, and you need to find a specific one, you should use Component.GetComponentsInParent and check the list of components returned to identify the one you want.
To find components attached to other GameObjects, you need a reference to that other GameObject (or any component attached to that GameObject). You can then call on that reference.
GetComponentInParentSee the Component and GameObject class reference pages for the other variations of the family of methods.
GetComponentThe following example gets a reference to a hinge joint component on the same GameObject as the script, or any of its parents, and if found, sets a property on that hinge joint component.
using UnityEngine;public class GetComponentInParentExample : MonoBehaviour{ void Start() { HingeJoint hinge = GetComponentInParent<HingeJoint>(); if (hinge != null) { hinge.useSpring = false; } else { // Try again by including inactive GameObjects. hinge = GetComponentInParent<HingeJoint>(true); if (hinge != null) { hinge.useSpring = false; } } }}
Note: If the type you request is a derivative of MonoBehaviour and the associated script can't be loaded then this function will return for that component.
nullGetComponentInParent<T>()
Gets a reference to a component of type on the same GameObject as the component specified, or any parent of the GameObject.
Tpublic T GetComponentInParent<T>()
Returns
Type | Description |
|---|---|
| T | A Component of the matching type |
Remarks
The typical usage for this method is to call it from a MonoBehaviour script (which itself is a type of component), to find references to other Components or MonoBehaviours attached to the same GameObject as that script, or its parent GameObjects. In this case you can call the method with no preceding object specified. For example:
myResults = GetComponentInParent<ComponentType>()You can also call this method on a reference to different component, which might be attached to a different GameObject. In this case, the GameObject to which that component is attached, and its parents, are searched. For example:
myResults = otherComponent.GetComponentInParent<ComponentType>()This method checks the GameObject on which it is called first, then recurses upwards through each parent GameObject, until it finds a matching Component of the type specified.
TOnly active GameObjects are included in the search, unless you call the method with the parameter set to , in which case inactive GameObjects are also included. This applies to the GameObject on which the method is called.
includeInactivetrueNote: GetComponentInParent returns only the first matching component found, and the order that the components are checked on any individual GameObject is not defined. Therefore, if there are more than one of the specified type that could match on any individual GameObject, and you need to find a specific one, you should use Component.GetComponentsInParent and check the list of components returned to identify the one you want.
To find components attached to other GameObjects, you need a reference to that other GameObject (or any component attached to that GameObject). You can then call on that reference.
GetComponentInParentSee the Component and GameObject class reference pages for the other variations of the family of methods.
GetComponentThe following example gets a reference to a hinge joint component on the same GameObject as the script, or any of its parents, and if found, sets a property on that hinge joint component.
using UnityEngine;public class GetComponentInParentExample : MonoBehaviour{ void Start() { HingeJoint hinge = GetComponentInParent<HingeJoint>(); if (hinge != null) { hinge.useSpring = false; } else { // Try again by including inactive GameObjects. hinge = GetComponentInParent<HingeJoint>(true); if (hinge != null) { hinge.useSpring = false; } } }}
Note: If the type you request is a derivative of MonoBehaviour and the associated script can't be loaded then this function will return for that component.
null