Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.
Close Submission failedFor some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.
Close Your name Your email Suggestion* Switch to ManualDeclarationpublic static T FindFirstObjectByType();
Declarationpublic static Object FindFirstObjectByType(Type type); Declaration
public static Object
FindFirstObjectByType(Type
type,
FindObjectsInactive findObjectsInactive);
Parameters Parameter Description type The type of object to find. findObjectsInactive Whether to include components attached to inactive GameObjects. If you don't specify this parameter, this function doesn't include inactive objects in the results. ReturnsT Returns the first active loaded object that matches the specified type. If no object matches the specified type, returns null.
DescriptionRetrieves the first active loaded object of Type type.
Object.FindFirstObjectByType doesn't return Assets (for example meshes, textures, or prefabs), or inactive objects. It also doesn't return objects that have HideFlags.DontSave set.
Note: This function is very resource intensive. It's best practice to not use this function every frame and instead, in most cases, use the singleton pattern. Alternatively if you only need any instance of a matching object rather than the first one you can use the faster Object.FindAnyObjectByType
See Also: Object.FindAnyObjectByType, Object.FindObjectsByType.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4