CanvasGroup
класс в UnityEngine
Наследуется от:Behaviour
Выполнено в:UnityEngine.UIModule
Интерфейсы приспособлений:ICanvasRaycastFilter
Описание
Плакабельный элемент Canvas, с помощью которого можно менять состояние дочерних элементов: Alpha, Raycasting, Enabled.
Группу переключателей можно использовать, чтобы менять состояние дочерних элементов.
Примером этого может быть окно, которое со временем исчезает, изменяя значение альфы группы. Результат alpha будет умноженным результатом любых вложенных групп, умноженным на альфу элементов полосок.
Вы можете настроить Canvas Группы так, чтобы не блокировать raycasts. Когда вы настраиваете Canvas Группу так, чтобы не блокировать raycasts, графическое raycasting игнорирует все в группе.
Давайте предположим, что у вас есть Canvas GameObject с компонентом CanvasGroup на нем, и вы устанавливаете альфу компонента CanvasGroup на 0. В этом случае Canvas не отображает ни одного из своих дочерних GameObjects. Теперь предположим, что Canvas также имеет дочерний CanvasGroup GameObject, который вы хотите отобразить. Если вы включите IgnoreParentGroups для CanvasGroup GameObject, родительская Canvas не отображает ни одного из своих дочерних GameObjects, включая CanvasGroup, который вы хотите отобразить. Чтобы получить дочерние CanvasGroup GameObject, выполните одно из двух действий: В родительском Canvas установите альфа компонента CanvasGroup на небольшое, не нулевое значение. Добавьте компонент Canvas к дочернему CanvasGroup GameObject, который вы хотите отобразить.
Свойства
| Свойство | Описание |
|---|---|
| alpha | Устанавливает альфа-значение группы. |
| blocksRaycasts | Запрещает ли эта группа лучевой обмен (разрешение столкновений). |
| ignoreParentGroups | Следует ли группе игнорировать родительские группы? |
| interactable | Взаимодействует ли группа (включены ли элементы под группой). |
Открытые методы
| Метод | Описание |
|---|---|
| IsRaycastLocationValid | Возвращает true, если Группа разрешает raycast. |
Унаследованные члены 4
Свойства
| Свойство | Описание |
|---|---|
| enabled | True, если это Поведение включено, в противном случае false. |
| isActiveAndEnabled | Проверяет, включён ли компонент, прикреплен ли он к GameObject, который активен в иерархии, и вызван ли OnEnable компонента. |
| gameObject | GameObject, к которому прикреплен данный компонент. Компонент всегда прикрепляется к игровому объекту. |
| tag | Тег этого игрового объекта. |
| transform | Transform прикреплен к этому GameObject. |
| transformHandle | TransformHandle этого GameObject. |
| hideFlags | Должен ли объект быть скрытым, сохраняться с Scene или изменяться пользователем? |
| name | Имя объекта. |
Открытые методы
| Метод | Описание |
|---|---|
| BroadcastMessage | Вызывает метод с именем methodName на каждом MonoBehaviour в этом игровом объекте или любом из его дочерей. |
| CompareTag | Проверяет тег GameObject на соответствие определенному тегу. |
| GetComponent | Получает ссылку на компонент типа T на том же GameObject, что и указанный компонент. |
| GetComponentInChildren | Получает ссылку на компонент типа T на том же GameObject, что и указанный компонент, или на любого ребенка GameObject. |
| GetComponentIndex | Получает индекс компонента на его родительском GameObject. |
| GetComponentInParent | Получает ссылку на компонент типа T на том же GameObject, что и указанный компонент, или на любой родитель GameObject. |
| GetComponents | Получает ссылки на все компоненты типа T на том же GameObject, что и указанный компонент. |
| GetComponentsInChildren | Получает ссылки на все компоненты типа T на том же GameObject, что и указанный компонент, и на любого ребенка GameObject. |
| GetComponentsInParent | Получает ссылки на все компоненты типа T на том же GameObject, что и указанный компонент, и любой родитель GameObject. |
| SendMessage | Вызывает метод с именем methodName на каждом MonoBehaviour в этом игровом объекте. |
| SendMessageUpwards | Вызывает метод с именем methodName на каждом MonoBehaviour в этом игровом объекте и на каждом предшественнике поведения. |
| TryGetComponent | Получает компонент указанного типа, если он существует. |
| GetInstanceID | Получает экземпляр ID объекта. |
| ToString | Возвращает имя объекта. |
Статические методы
| Метод | Описание |
|---|---|
| Destroy | Удаляет GameObject, компонент или ресурс. |
| DestroyImmediate | Немедленно уничтожает указанный объект. Используйте с осторожностью и только в режиме редактирования. |
| DontDestroyOnLoad | Не уничтожать целевой Объект при загрузке нового Scene. |
| FindAnyObjectByType | Получает любой активный загруженный объект типа Type. |
| FindFirstObjectByType | Получает первый активный загруженный объект типа Type. |
| FindObjectsByType | Получает список всех загруженных объектов типа Type. |
| Instantiate | Клонирует исходный объект и возвращает клон. |
| InstantiateAsync | Захватывает моментальный снимок первоначального объекта (который должен быть связан с каким-либо GameObject) и возвращает AsyncInstantiateOperation. |
Операторы
| Оператор | Описание |
|---|---|
| bool | Существует ли объект? |
| оператор!= | Сравнивает, если два объекта ссылаются на разные объекты. |
| оператор == | Сравнение двух ссылок на объекты для определения того, относятся ли они к одному и тому же объекту. |