PanelSettings
класс в UnityEngine.UIElements
Наследуется от:ScriptableObject
Выполнено в:UnityEngine.UIElementsModule
Описание
Определяет ассет Panel Settings, который создает экземпляр панели во время выполнения. Панель позволяет Unity для отображения UXML-файл основанный UI в 2000 году Game вид.
Компонент UIDocument содержит ссылку на объект PanelSettings. Компонент PanelSettings содержит настройки отображения для объекта UI, включая режим масштабирования и порядок сортировки. Несколько компонентов UIDocument могут указывать на один и тот же объект PanelSettings, что оптимизирует производительность при использовании нескольких экранов UI в одной сцене.
Дополнительную информацию о различных свойствах объекта PanelSettings см. в разделе Справочная информация о свойствах панели «Параметры».
Свойства
| Свойство | Описание |
|---|---|
| bindingLogLevel | Устанавливает уровень журнала для привязок в панелях, использующих этот ресурс PanelSettings. |
| clearColor | Определяет, очищается ли цветовой буфер перед рендерингом панели. |
| clearDepthStencil | Определяет, очищается ли буфер глубины/шаблона перед рендерингом панели. |
| colorClearValue | Цвет, используемый для очистки цветового буфера. |
| depthClearValue | Глубина, используемая для очистки буфера глубины/шаблона. |
| dynamicAtlasSettings | Настройки динамического атласа. |
| fallbackDpi | Значение DPI, которое Unity использует, когда не может определить экран DPI. |
| forceGammaRendering | Принуждает шейдер UI выводить цвета в гамма цветовом пространстве. |
| match | Определяет, использует ли Unity ширину, высоту или сочетание этих параметров в качестве ссылки при масштабировании области панели. |
| referenceDpi | DPI, для которого разработан UI. |
| referenceResolution | Разрешение, для которого разработан UI. |
| referenceSpritePixelsPerUnit | У спрайтов есть значение Pixels Per Unit, которое контролирует плотность пикселей спрайта. Для спрайтов, которые имеют то же значение Pixels Per Unit, что и значение Reference Pixels Per Unit в ассете PanelSettings, плотность пикселей будет один к одному. |
| renderMode | Определяет, как отображается панель. По умолчанию PanelRenderMode.ScreenSpaceOverlay. |
| scale | Единообразный коэффициент масштабирования, который Unity применяет к элементам панели до преобразования панели. |
| scaleMode | Определяет масштаб элементов панели при изменении размера экрана. |
| screenMatchMode | Указывает, как масштабировать область панели, когда соотношение сторон текущего разрешения не соответствует исходному разрешению. |
| sortingOrder | Когда Scene использует более одной панели, это значение определяет, где эта панель появляется в порядке сортировки относительно других панелей. |
| targetDisplay | Установите дисплей, предназначенный для панели. |
| targetTexture | Указывает текстуру рендеринга для рендеринга UI панели. |
| textSettings | Указывает PanelTextSettings, который будет использоваться каждым UI Документом, присоединенным к панели. |
| textureSlotCount | Максимальное количество текстур, которые UI Toolkit может привязать к шейдеру одновременно. |
| themeStyleSheet | Указывает таблицу стилей, которую Unity применяет к каждому UI Документу, присоединенному к панели. |
| vertexBudget | Ожидаемое число вершин, которые будут использоваться в этой панели. |
Открытые методы
| Метод | Описание |
|---|---|
| SetPanelChangeReceiver | Устанавливает пользовательский IPanelChangeReceiver в настройке panelChangeReceiver для получения каждого события изменения. Этот метод доступен только в сборках для разработчиков и редакторе, так как это отладочный метод для профилирования приложения. |
| SetScreenToPanelSpaceFunction | Задает функцию, которая обрабатывает преобразование экранного пространства в пространство панели. Для накладных панелей эта функция возвращает входное значение. |
| SetScreenToPanelSpaceFunction3D | Задает функцию, которая обрабатывает преобразование экранного пространства в пространство панели. Для накладных панелей эта функция возвращает входное значение. |
Унаследованные члены 5
Свойства
| Свойство | Описание |
|---|---|
| hideFlags | Должен ли объект быть скрытым, сохраняться с Scene или изменяться пользователем? |
| name | Имя объекта. |
Открытые методы
| Метод | Описание |
|---|---|
| GetInstanceID | Получает экземпляр ID объекта. |
| ToString | Возвращает имя объекта. |
Статические методы
| Метод | Описание |
|---|---|
| Destroy | Удаляет GameObject, компонент или ресурс. |
| DestroyImmediate | Немедленно уничтожает указанный объект. Используйте с осторожностью и только в режиме редактирования. |
| DontDestroyOnLoad | Не уничтожать целевой Объект при загрузке нового Scene. |
| FindAnyObjectByType | Получает любой активный загруженный объект типа Type. |
| FindFirstObjectByType | Получает первый активный загруженный объект типа Type. |
| FindObjectsByType | Получает список всех загруженных объектов типа Type. |
| Instantiate | Клонирует исходный объект и возвращает клон. |
| InstantiateAsync | Захватывает моментальный снимок первоначального объекта (который должен быть связан с каким-либо GameObject) и возвращает AsyncInstantiateOperation. |
| CreateInstance | Создает экземпляр скриптового объекта. |
Операторы
| Оператор | Описание |
|---|---|
| bool | Существует ли объект? |
| оператор!= | Сравнивает, если два объекта ссылаются на разные объекты. |
| оператор == | Сравнение двух ссылок на объекты для определения того, относятся ли они к одному и тому же объекту. |
Сообщения
| Сообщение | Описание |
|---|---|
| Awake | Вызывается при создании экземпляра ScriptableObject. |
| OnDestroy | Эта функция вызывается, когда скриптовый объект будет уничтожен. |
| OnDisable | Эта функция вызывается, когда скриптовый объект выходит за пределы области действия. |
| OnEnable | Эта функция вызывается при загрузке объекта. |
| OnValidate | Функция только для редактора, которую вызывает Unity при загрузке скрипта или изменении значения в Inspector. |
| Reset | Сброс значений по умолчанию. |