Evia WorkStation 伊維亞工作室

• GetComponent ：取得物件的屬性元件 (單個)
• GetComponentInChildren ：取得物件的子物件的屬性元件 (單個)
• GetComponentInParent ：取得物件的父物件的屬性元件 (單個)
• GetComponents ：取得物件的屬性元件 (多個)
• GetComponentsInChildren ：取得物件的子物件的屬性元件 (多個)
• GetComponentsInParent ：取得物件的父物件的屬性元件 (多個)

• 方法定義： 
• public Component GetComponent(Type type);
• public Component GetComponentInChildren(Type type);
• public Component GetComponentParent(Type type);
• public Component[] GetComponents(Type type);
• public Component[] GetComponentsInChildren(Type type);
• public Component[] GetComponentsParent(Type type);

參數說明：
● type 是泛型類別，可以是官方提供的類別，也可以是自定義的類別，會影響回傳的型態。

• 注意：

GetComponentsInChildren 和 GetComponentsInParent 方法可以多載，由於預設只會取得有包含此 Type 屬性並有啟用的物件並回傳，因此若有物件包含此 Type 的屬性元件，但並未啟用的話就不會取得，若要取得未啟用屬性的物件也可以使用布林參數來實現。

• 多載：

參數說明：
● type 是泛型類別，可以是官方提供的類別，也可以是自定義的類別，會影響回傳的型態。
● includeInactive 為布林值，取元件時是否包含未啟用的元件，預設為 false。

• 用法：(以下三種寫法)

一般來說我們會用 物件.GetComponent<類別>() 的寫法，但也可以用 物件.類別 的方法來實現，取決於物件是否有繼承到這個類別，有繼承的話才能直接用後者，不過如果是要取父物件或是子物件的屬性時，就無法使用後者。

//取得物件的 Transform 屬性
this.transform;
this.GetComponent<Transform>();
this.GetComponent(typeof(Transform));

//取得物件的 Button 屬性
this.button;
this.GetComponent<Button>();
this.GetComponent(typeof(Button));

//取得 canvas 物件底下的所有圖片子物件 (包含沒啟用的)
canvas.GetComponentsInChildren<Image>(true);
canvas.GetComponentsInChildren<Image>(true);
canvas.GetComponentsInChildren(typeof(Image),true);

• 實做 (一)：取得玩家物件的座標

using UnityEngine;
using System.Collections;
public class GetObjectPosition: MonoBehaviour
{    
    public GameObject player;
    void Start()
    {
        Vector3 position = player.GetComponent<Transform>().position;
        Debug.Log(position);
    }}

• 實做 (二)：為按鈕加入點擊事件

using UnityEngine;
using System.Collections;
using UnityEngine.UI;
public class ButtonEvent: MonoBehaviour
{    
    void Start()
    {
        Button button = GetComponent<Button>();
        button.onClick.AddListener(click);
    }
    void click()
    {
        Debug.Log("Button Click ! ");
    }
}

• 實做 (三)：取得自定義類別的屬性及方法

using UnityEngine;
using System.Collections;

//自定義方法
public class Circle
{
    //半徑
    public float radius = 2;
    //取得圓周長
    public float getCircumference()
    {
        return radius * 2 * Mathf.PI;
    }
    //取得圓面積
    public float getArea()
    {
        return redius * redius * Mathf.PI;
    }
}

using UnityEngine;
using System.Collections;
public class ButtonEvent: MonoBehaviour
{    
    public Circle circle;

    void Start()
    {
        Button button = GetComponent<Button>();
        button.onClick.AddListener(ShowInfomation);
    }
    void ShowInfomation()
    {
        var radius = circle.GetComponent<Circle>().radius;
        var circumference = circle.GetComponent<Circle>().getCircumference();
        var area = circle.GetComponent<Circle>().getArea();
        Debug.Log("半徑 = " + radius);
        Debug.Log("週長 = " + circumference );
        Debug.Log("面積 = " + area );
    }
}
//執行結果：
//半徑 = 2
//週長 = 12.56
//面積 = 12.56

• 結語：

• GetComponent 開頭的方法是回傳單一結果，而 GetComponents 開頭的方法會回傳多個結果的陣列，回傳型態依取得的屬性元件類別而定。
• 用 GetComponent 系列方法取得的屬性元件不存在時會回傳 Null。
• 用 GetComponents 系列方法取值，即便只有一個回傳值也會用陣列儲存。
• 取得屬性元件之後，可以使用其類別底下的公開屬性及方法，如實做所示。

Try it and have fun！