Unity UGUI的ToggleGroup（选项组）组件的介绍及使用

Unity UGUI的ToggleGroup（选项组）组件的介绍及使用

1. 什么是ToggleGroup组件？

ToggleGroup（选项组）是Unity UGUI中的一个组件，用于管理一组Toggle（选项）的选择状态。ToggleGroup组件可以确保在同一个ToggleGroup中只有一个Toggle被选中，其他Toggle将自动取消选中状态。

2. ToggleGroup组件的工作原理

ToggleGroup组件通过监听Toggle的选择状态来实现管理功能。当一个Toggle被选中时，ToggleGroup会遍历同一组中的其他Toggle，并将它们的选中状态取消。

3. ToggleGroup组件的常用属性

• AllowSwitchOff（允许取消选择）：设置是否允许取消选择。如果设置为true，则可以将所有Toggle都取消选中状态；如果设置为false，则至少有一个Toggle会一直处于选中状态。

4. ToggleGroup组件的常用函数

• NotifyToggleOn(Toggle toggle)：通知ToggleGroup有一个Toggle被选中。该函数会在Toggle的OnValueChanged事件中自动调用，无需手动调用。

5. 完整例子代码

例子1：创建ToggleGroup和Toggle

using UnityEngine;
using UnityEngine.UI;

public class Example1 : MonoBehaviour
{
    public ToggleGroup toggleGroup;
    public Toggle toggle1;
    public Toggle toggle2;

    private void Start()
    {
        toggle1.group = toggleGroup;
        toggle2.group = toggleGroup;
    }
}

操作步骤：

1. 创建一个空物体，并将Example1脚本挂载到该物体上。
2. 在场景中创建两个Toggle，并将它们的Toggle组件分别拖拽到toggle1和toggle2的引用中。
3. 将toggleGroup组件拖拽到toggleGroup的引用中。
4. 运行游戏，点击toggle1或toggle2，观察它们的选中状态。

注意事项：

• toggle1和toggle2的group属性必须设置为toggleGroup。

例子2：动态创建Toggle

using UnityEngine;
using UnityEngine.UI;

public class Example2 : MonoBehaviour
{
    public ToggleGroup toggleGroup;
    public GameObject togglePrefab;
    public Transform toggleParent;

    private void Start()
    {
        for (int i = 0; i < 5; i++)
        {
            GameObject toggleObj = Instantiate(togglePrefab, toggleParent);
            Toggle toggle = toggleObj.GetComponent<Toggle>();
            toggle.group = toggleGroup;
        }
    }
}

操作步骤：

1. 创建一个空物体，并将Example2脚本挂载到该物体上。
2. 创建一个Toggle的预制体togglePrefab，并将其拖拽到togglePrefab的引用中。
3. 创建一个空物体toggleParent，并将其拖拽到toggleParent的引用中。
4. 将toggleGroup组件拖拽到toggleGroup的引用中。
5. 运行游戏，观察toggleParent下的Toggle数量和选中状态。

注意事项：

• togglePrefab必须包含Toggle组件。
• toggleParent必须是一个容器，用于存放动态创建的Toggle。

例子3：取消选择

using UnityEngine;
using UnityEngine.UI;

public class Example3 : MonoBehaviour
{
    public ToggleGroup toggleGroup;
    public Button cancelButton;

    private void Start()
    {
        cancelButton.onClick.AddListener(CancelSelection);
    }

    private void CancelSelection()
    {
        toggleGroup.SetAllTogglesOff();
    }
}

操作步骤：

1. 创建一个空物体，并将Example3脚本挂载到该物体上。
2. 创建一个Button，并将其拖拽到cancelButton的引用中。
3. 将toggleGroup组件拖拽到toggleGroup的引用中。
4. 运行游戏，点击cancelButton，观察toggleGroup中的Toggle是否被取消选择。

注意事项：

• cancelButton必须是一个Button，并且已经添加了OnClick事件。

例子4：获取选中的Toggle

using UnityEngine;
using UnityEngine.UI;

public class Example4 : MonoBehaviour
{
    public ToggleGroup toggleGroup;
    public Button getSelectedButton;

    private void Start()
    {
        getSelectedButton.onClick.AddListener(GetSelectedToggle);
    }

    private void GetSelectedToggle()
    {
        Toggle selectedToggle = toggleGroup.ActiveToggles().FirstOrDefault();
        if (selectedToggle != null)
        {
            Debug.Log("Selected Toggle: " + selectedToggle.name);
        }
        else
        {
            Debug.Log("No Toggle selected.");
        }
    }
}

操作步骤：

1. 创建一个空物体，并将Example4脚本挂载到该物体上。
2. 创建一个Button，并将其拖拽到getSelectedButton的引用中。
3. 将toggleGroup组件拖拽到toggleGroup的引用中。
4. 运行游戏，点击getSelectedButton，观察控制台输出。

注意事项：

• getSelectedButton必须是一个Button，并且已经添加了OnClick事件。

例子5：禁用ToggleGroup

using UnityEngine;
using UnityEngine.UI;

public class Example5 : MonoBehaviour
{
    public ToggleGroup toggleGroup;
    public Button disableButton;

    private void Start()
    {
        disableButton.onClick.AddListener(DisableToggleGroup);
    }

    private void DisableToggleGroup()
    {
        toggleGroup.enabled = false;
    }
}

操作步骤：

1. 创建一个空物体，并将Example5脚本挂载到该物体上。
2. 创建一个Button，并将其拖拽到disableButton的引用中。
3. 将toggleGroup组件拖拽到toggleGroup的引用中。
4. 运行游戏，点击disableButton，观察toggleGroup是否被禁用。

注意事项：

• disableButton必须是一个Button，并且已经添加了OnClick事件。

参考资料

• Unity官方文档：ToggleGroup
• Unity官方教程：Toggle