Unity 6.3
0 онлайн 72 гостей 3 в системе
Вход

PointerEventBase<T0>

класс в UnityEngine.UIElements

Наследуется от:UIElements.EventBase_1

Выполнено в:UnityEngine.UIElementsModule


Интерфейсы приспособлений:IPointerEvent

Описание

Базовый класс для всех событий, связанных с указателем.

События указателя отправляются, когда пользователь взаимодействует с мышью, сенсорным экраном или цифровой ручкой.

По умолчанию события указателя просачиваются вниз по иерархии визуальных элементов, а затем возвращаются в корень.

Цикл событий указателя происходит следующим образом:

  • Пользователь нажимает кнопку мыши, касается экрана или иным образом вызывает отправку PointerDownEvent.
  • Если пользователь меняет состояние указателя, отправляется событие PointerMoveEvent. Несколько событий PointerMove отправляются, если изменяются несколько свойств указателя.
  • Если пользователь отменяет цикл, то отправляется PointerCancelEvent.
  • Если пользователь не отменяет цикл, и либо отпускает последнюю нажатую кнопку, либо отпускает последнее прикосновение, отправляется PointerUpEvent.
  • Если начальные PointerDownEvent и PointerUpEvent встречаются на одном и том же визуальном элементе, отправляется ClickEvent.

См. События указателя для получения дополнительной информации и примеров см. страницу руководства.

Свойства

Свойство Описание
actionKeyПолучает логическое значение, указывающее, нажата ли клавиша действия для конкретной платформы.
altitudeAngleПолучает угол наклона стилуса относительно поверхности в радианах
altKeyПолучает логическое значение, указывающее, нажата ли клавиша Alt.
azimuthAngleПолучает угол наклона стилуса относительно оси x в радианах.
buttonВозвращает значение, указывающее, какая кнопка мыши была нажата или отпущена (если таковая была нажата или отпущена), чтобы вызвать это событие: 0 — левая кнопка, 1 — правая кнопка, 2 — средняя кнопка. Отрицательное значение означает, что во время этого события ни одна кнопка мыши не меняла своего состояния.
clickCountПолучает число последовательных последовательностей вниз-вверх, выполненных за короткое время с одним и тем же указателем ID и кнопкой.
commandKeyПолучает логическое значение, указывающее, нажата ли клавиша Windows/Cmd.
ctrlKeyПолучает логическое значение, указывающее, нажата ли клавиша Ctrl.
currentTargetПолучает текущий конечный объект события.
deltaPositionПолучает разницу между положением указателя во время предыдущего события указателя и его положением во время текущего события указателя.
deltaTimeПолучает время, прошедшее с момента последнего записанного изменения значений указателя, в секундах.
isPrimaryПолучает логическое значение, указывающее, является ли указатель основным указателем. True означает, что указатель является основным указателем. False означает, что это не так.
localPositionПолучает позицию указателя в системе координат текущего объекта.
modifiersПолучает флаги, указывающие, нажаты ли клавиши модификаторов (Alt, Ctrl, Shift, Windows/Cmd).
penStatusУказывает состояние пера. Например, касается ли перо экрана или планшета, перевёрнуто ли оно и нажаты ли кнопки. На macOS penStatus не отражает изменения в назначении кнопок.
pointerIdПолучает идентификатор указателя, который отправил событие.
pointerTypeПолучает тип указателя, создавшего событие.
positionПолучает позицию указателя в системе координат панели.
pressedButtonsПолучает битмаску, описывающую кнопки, которые в данный момент нажаты.
pressureПолучает величину давления, которое в настоящее время применяется при прикосновении.
radiusПолучает оценку радиуса касания.
radiusVarianceПолучает точность радиуса касания.
shiftKeyПолучает логическое значение, указывающее, нажата ли клавиша Shift.
tangentialPressureПолучает давление, приложенное к дополнительному чувствительному к давлению элементу управления на стилусе.
tiltУказывает угол ручки относительно осей X и Y соответственно, в радианах.
twistПолучает поворот стилуса вокруг своей оси в радианах.

Защищенные методы

Метод Описание
InitСброс членов события до их исходных значений.

Статические методы

Метод Описание
GetPooledПолучает событие из пула событий и инициализирует его с указанными значениями. Используйте эту функцию вместо создания новых событий. События, полученные с помощью этого метода, должны быть выпущены обратно в пул. Вы можете использовать Dispose() для их выпуска.
Унаследованные члены 4

Свойства

СвойствоОписание
bubblesВозвращает информацию о том, появляется ли этот тип события в пути распространения событий во время фазы BubbleUp.
currentTargetТекущий объект события. Это VisualElement в пути распространения, для которого в настоящее время выполняются обработчики событий.
dispatchПоказывает, отправляется ли событие в визуальный элемент. Событие не может быть переадресовано в процессе отправки. Если необходимо рекурсивно отправить событие, рекомендуется использовать копию события.
ignoreDisabledElementsЕсли это свойство установлено на true, обратные вызова для этого события не вызываются при отключении текущей цели, если только эти обратные вызова не зарегистрированы с помощью параметра CallbackOptions.IncludeDisabled.
imguiEventIMGUIEvent в источнике этого события. Источник может быть нулевым, поскольку не все события генерируются IMGUI.
isImmediatePropagationStoppedУказывает, был ли вызван StopImmediatePropagation для этого события.
isPropagationStoppedВозвращает true, если StopPropagation или StopImmediatePropagation были вызваны для этого события.
originalMousePositionПервоначальное положение мыши в событии IMGUI до его преобразования в текущие целевые локальные координаты.
pooledВыделяется ли событие из пула событий.
propagationPhaseТекущая фаза распространения этого события.
targetКонечный визуальный элемент, получивший это событие. В отличие от currentTarget, этот конечный элемент не изменяется, когда событие отправляется другим элементам по пути распространения.
timestampВремя отправки события в миллисекундах.
tricklesDownВозвращает информацию о том, отправляется ли это событие по пути распространения событий в фазе TrickleDown.
eventTypeIdСм. EventBase.eventTypeId.

Открытые методы

МетодОписание
StopImmediatePropagationОстановка распространения события на другие конечные объекты и предотвращение получения события другими подписчиками события на этом конечном объекте.
StopPropagationПрекращает распространение события на другие конечные объекты. Все подписчики на событие на этом конечном объекте по-прежнему получают событие.
DisposeОсуществление IDispose.

Защищенные методы

МетодОписание
PostDispatchПозволяет подклассам выполнять настраиваемую логику после отправки события.
PreDispatchПозволяет подклассам выполнять настраиваемую логику до отправки события.

Статические методы

МетодОписание
RegisterEventType Регистрирует класс события в системе типов событий.
GetPooledПолучает событие из пула событий. Используйте эту функцию вместо создания новых событий. События, полученные с помощью этого метода, должны быть выпущены обратно в пул. Вы можете использовать Dispose() для их выпуска.
SetCreateFunctionПозволяет предоставить функцию для создания экземпляра события без зависимости от Activator.CreateInstance.
TypeIdПолучает тип ID для этого экземпляра события.