IComponent

Interface mirroring UnityEngine.Component. Extends IUnityObject with access to Transform, GameObject, component queries (GetComponent, GetComponentInChildren, GetComponentInParent), tagging, and Unity's string-based message broadcasting system.

Definition

Namespace: Paragon Assembly: Paragon.dll

public interface IComponent : IUnityObject

Extends: IUnityObject

Remarks

IComponent is the largest interface in the Unity interface hierarchy, mirroring the full public API of UnityEngine.Component. It covers four categories:

1. Scene graph access — transform, gameObject, tag

2. Component queries — All GetComponent / GetComponentInChildren / GetComponentInParent / GetComponents overloads (generic and non-generic)

3. Tagging — tag property and CompareTag() methods

4. Messaging — SendMessage, SendMessageUpwards, BroadcastMessage with all overloads

This interface is extended by IBehaviour and used by systems that need to access a component's Transform or query sibling components without depending on a concrete class.

Properties

transform

The Transform attached to this component's GameObject.

Transform transform { get; }

gameObject

The GameObject this component is attached to.

GameObject gameObject { get; }

tag

The tag of the GameObject this component is attached to.

string tag { get; set; }

Methods

Component Queries

All standard Unity component query methods are included. The generic variants are most commonly used:

T GetComponent<T>()
bool TryGetComponent<T>(out T component)
T GetComponentInChildren<T>()
T GetComponentInChildren<T>(bool includeInactive)
T[] GetComponentsInChildren<T>()
T[] GetComponentsInChildren<T>(bool includeInactive)
T GetComponentInParent<T>()
T GetComponentInParent<T>(bool includeInactive)
T[] GetComponentsInParent<T>(bool includeInactive)
T[] GetComponents<T>()
int GetComponentIndex()

Non-generic overloads accepting System.Type and string are also included, as well as void overloads that write to a List<T> parameter for allocation-free queries:

void GetComponentsInChildren<T>(bool includeInactive, List<T> result)
void GetComponentsInChildren<T>(List<T> results)
void GetComponentsInParent<T>(bool includeInactive, List<T> results)
void GetComponents(Type type, List<Component> results)
void GetComponents<T>(List<T> results)

Tag Comparison

bool CompareTag(string tag)
bool CompareTag(TagHandle tag)

Parameter	Type	Description
tag	string / TagHandle	Tag to compare against

Returns: true if the GameObject's tag matches.

Messaging

Unity's string-based messaging system. All overloads are included:

// Upward (self + parents)
void SendMessageUpwards(string methodName)
void SendMessageUpwards(string methodName, object value)
void SendMessageUpwards(string methodName, SendMessageOptions options)
void SendMessageUpwards(string methodName, object value, SendMessageOptions options)

// Self only
void SendMessage(string methodName)
void SendMessage(string methodName, object value)
void SendMessage(string methodName, SendMessageOptions options)
void SendMessage(string methodName, object value, SendMessageOptions options)

// Downward (self + children)
void BroadcastMessage(string methodName)
void BroadcastMessage(string methodName, object parameter)
void BroadcastMessage(string methodName, SendMessageOptions options)
void BroadcastMessage(string methodName, object parameter, SendMessageOptions options)

Implementation Requirements

You do not need to implement this interface explicitly. Any class deriving from UnityEngine.Component (which includes all MonoBehaviour subclasses) already has all these members.

See Also

• IUnityObject — parent interface

• IBehaviour — extends this with enable/disable

• Unity Interfaces — hierarchy overview