Константы событий (Winuser.h)
В этом разделе описываются события, создаваемые операционной системой и серверными приложениями. Константы перечислены в алфавитном порядке.
Перед использованием этих событий клиентские приложения должны использовать Специальный наблюдатель за событиями , чтобы убедиться, что эти события используются элементами пользовательского интерфейса.
Дополнительные сведения о событиях в целом см. в разделах Что такое события WinEvents? и События уровня системы и уровня объектов. Дополнительные сведения о событиях, отправляемых системой, см. в приложении А. Справочник по поддерживаемым элементам пользовательского интерфейса.
| Констант/значение | Описание |
|---|---|
|
Диапазон значений констант WinEvent, заданных альянсом по взаимодействию со специальными возможностями (AIA) для использования в отрасли. Дополнительные сведения см. в разделе Выделение идентификаторов WinEvent. |
|
Наименьшие и самые высокие возможные значения событий. |
|
Свойство KeyboardShortcut объекта изменилось. Серверные приложения отправляют данное событие для объектов со специальными возможностями. |
|
Отправляется при маскировке окна. Скрытое окно по-прежнему существует, но невидимо для пользователя. |
|
Прокрутка объекта окна завершена. В отличие от EVENT_SYSTEM_SCROLLEND, это событие связано с окном прокрутки. Независимо от того, является ли прокрутка горизонтальной или вертикальной, это событие должно отправляться при каждом завершении действия прокрутки. Параметр hwnd функции обратного вызова WinEventProc описывает окно прокрутки; параметр idObjectOBJID_CLIENT, а параметр idChild — CHILDID_SELF. |
|
Объект был создан. Система отправляет это событие для следующих элементов пользовательского интерфейса: курсор, заголовок, элемент управления представлением списка, элемент управлениявкладкой, элемент управленияпанелью инструментов, элемент управления представлением в виде дерева и объект окна . Серверные приложения отправляют данное событие для объектов со специальными возможностями. Перед отправкой события для родительского объекта серверы должны отправить его для всех дочерних объектов объекта. Серверы должны убедиться, что все дочерние объекты полностью созданы и готовы принять вызовы IAccess от клиентов, прежде чем родительский объект отправит это событие. Так как родительский объект создается после его дочерних объектов, клиенты должны убедиться, что родительский объект объекта создан перед вызовом IAccessible::get_accParent, особенно если используются функции-перехватчики в контексте. |
|
Свойство DefaultAction объекта изменилось. Система отправляет данное событие для диалоговых окон. Серверные приложения отправляют данное событие для объектов со специальными возможностями. |
|
Свойство Description объекта изменилось. Серверные приложения отправляют данное событие для объектов со специальными возможностями. |
|
Объект был удален. Система отправляет это событие для следующих элементов пользовательского интерфейса: курсор, заголовок, элемент управления представлением списка, элемент управления вкладкой, элемент управления панелью инструментов, элемент управления представлением в виде дерева и объект окна. Серверные приложения отправляют данное событие для объектов со специальными возможностями. Клиенты предполагают, что все дочерние элементы объекта уничтожаются, когда родительский объект отправляет это событие. После получения этого события клиенты не вызывают свойства или методы IAccess объекта. Однако указатель интерфейса должен оставаться действительным до тех пор, пока на него есть счетчик ссылок (из-за правил COM), но элемент пользовательского интерфейса может больше не присутствовать. Дальнейшие вызовы указателя интерфейса могут возвращать ошибки сбоя; Чтобы предотвратить это, серверы создают прокси-объекты и отслеживают их срок службы. |
|
Пользователь начал перетаскивать элемент. Параметры hwnd, idObject и idChild функции обратного вызова WinEventProc определяют перетаскиваемый объект. |
|
Пользователь завершил операцию перетаскивания перед удалением перетаскиваемого элемента на целевой объект перетаскивания. Параметры hwnd, idObject и idChild функции обратного вызова WinEventProc определяют перетаскиваемый объект. |
|
Пользователь удалял элемент в целевом объекте удаления. Параметры hwnd, idObject и idChild функции обратного вызова WinEventProc определяют перетаскиваемый объект. |
|
Пользователь перетащил элемент в границу целевого объекта перетаскивания. Параметры hwnd, idObject и idChild функции обратного вызова WinEventProc определяют целевой объект удаления. |
|
Пользователь вытащил элемент из границы целевого объекта удаления. Параметры hwnd, idObject и idChild функции обратного вызова WinEventProc определяют целевой объект удаления. |
|
Пользователь удалял элемент в целевом объекте удаления. Параметры hwnd, idObject и idChild функции обратного вызова WinEventProc определяют целевой объект удаления. |
|
Наибольшее значение события объекта. |
|
Объект получил фокус клавиатуры. Система отправляет это событие для следующих элементов пользовательского интерфейса: элемента управления представлением списка, строки меню, всплывающего меню, переключения окна, вкладки, элемента управления представлением в виде дерева и объекта окна. Серверные приложения отправляют данное событие для объектов со специальными возможностями. Параметр hwnd функции обратного вызова WinEventProc определяет окно, которое получает фокус клавиатуры. |
|
Свойство справки объекта изменилось. Серверные приложения отправляют данное событие для объектов со специальными возможностями. |
|
Объект скрыт. Система отправляет это событие для следующих элементов пользовательского интерфейса: курсора и курсора. Серверные приложения отправляют данное событие для объектов со специальными возможностями. При создании этого события для родительского объекта все дочерние объекты уже скрыты. Серверные приложения не отправляют это событие для дочерних объектов. Скрытые объекты включают флаг STATE_SYSTEM_INVISIBLE ; отображаемые объекты не включают этот флаг. Событие EVENT_OBJECT_HIDE также указывает, что установлен флаг STATE_SYSTEM_INVISIBLE . Таким образом, серверы не отправляют событие EVENT_OBJECT_STATECHANGE в этом случае. |
|
В окне, в котором размещаются другие доступные объекты, были изменены размещенные объекты. Клиенту может потребоваться запросить окно узла для обнаружения новых размещенных объектов, особенно если клиент отслеживает события из окна. Размещенный объект — это объект из платформы специальных возможностей (MSAA или автоматизации пользовательского интерфейса), который отличается от объекта ведущего приложения. Изменения в размещенных объектах, которые относятся к той же платформе, что и узел, должны передаваться вместе с событиями структурных изменений, такими как EVENT_OBJECT_CREATE для MSAA. Дополнительные сведения см. в комментариях в winuser.h. |
|
Окно IME стало скрытым. |
|
Окно IME стало видимым. |
|
Изменился размер или положение окна IME. |
|
Объект был вызван; например, пользователь нажал кнопку. Это событие поддерживается общими элементами управления и используется в модели автоматизации пользовательского интерфейса. Для этого события параметры hwnd, ID и idChild функции обратного вызова WinEventProc определяют вызываемый элемент. |
|
Объект, который является частью динамического региона, изменился. Динамический регион — это область приложения, которая часто и /или асинхронно меняется. |
|
У объекта изменилось расположение, форма или размер. Система отправляет это событие для следующих элементов пользовательского интерфейса: курсора и объектов окна. Серверные приложения отправляют данное событие для объектов со специальными возможностями. Это событие создается в ответ на изменение объекта верхнего уровня в иерархии объектов; Он не создается для дочерних элементов, которые могут быть у объекта. Например, если пользователь изменяет размер окна, система отправляет это уведомление для окна, но не для строки меню, заголовка, полосы прокрутки или других объектов, которые также были изменены. При перемещении родительского окна система не отправляет данное событие для каждого неплавающего дочернего окна. Однако если приложение явно изменяет размер дочерних окон в результате изменения размера родительского окна, система отправляет несколько событий для дочерних элементов с измененным размером. Если свойство State объекта имеет значение STATE_SYSTEM_FLOATING, сервер отправляет EVENT_OBJECT_LOCATIONCHANGE при каждом изменении расположения объекта. Если объект не имеет этого состояния, серверы активируют это событие только при перемещении объекта относительно его родительского объекта. Для этого уведомления о событии параметр idChild функции обратного вызова WinEventProc определяет измененный дочерний объект. |
|
Свойство Name объекта изменилось. Система отправляет это событие для следующих элементов пользовательского интерфейса: проверка box, cursor, list-view, push button, переключатель, элемент управления строки состояния, элемент управления представлением в виде дерева и объект окна. Серверные приложения отправляют данное событие для объектов со специальными возможностями. |
|
У объекта имеется новый родительский объект. Серверные приложения отправляют данное событие для объектов со специальными возможностями. |
|
Объект контейнера добавил, удалил или переупорядочил дочерние объекты. Система отправляет это событие для следующих элементов пользовательского интерфейса: заголовка, элемента управления представлением списка, элемента управления панелью инструментов и объекта окна. Серверные приложения при необходимости отправляют данное событие для объектов со специальными возможностями. Например, это событие создается объектом представления списка при изменении количества дочерних элементов или порядка элементов. Это событие также отправляется родительским окном при изменении Z-порядка для дочерних окон. |
|
Выделение в объекте контейнера изменилось. Система отправляет это событие для следующих элементов пользовательского интерфейса: элемента управления list-view, элемента управления tab, элемента управления представлением в виде дерева и объекта окна. Серверные приложения отправляют данное событие для объектов со специальными возможностями. Это событие сигнализирует об одном выделении: либо дочерний элемент выбран в контейнере, который ранее не содержал выделенных дочерних элементов, либо выделение изменилось с одного дочернего элемента на другой. Параметры hwnd и idObject функции обратного вызова WinEventProc описывают контейнер; параметр idChild определяет выбранный объект. Если выбранным дочерним элементом является окно, которое также содержит объекты, параметр idChildOBJID_WINDOW. |
|
Дочерний элемент в объекте контейнера был добавлен к существующему выделенному фрагменту. Система отправляет это событие для следующих элементов пользовательского интерфейса: list box, list-view и tree view. Серверные приложения отправляют данное событие для объектов со специальными возможностями. Параметры hwnd и idObject функции обратного вызова WinEventProc описывают контейнер. Параметр idChild — это дочерний элемент, который добавляется к выделенному фрагменту. |
|
Из выделения был удален элемент из объекта контейнера. Система отправляет это событие для следующих элементов пользовательского интерфейса: list box, list-view и tree view. Серверные приложения отправляют данное событие для объектов со специальными возможностями. Это событие сигнализирует о том, что дочерний элемент удаляется из существующего выделенного фрагмента. Параметры hwnd и idObject функции обратного вызова WinEventProc описывают контейнер; Параметр idChild определяет дочернего элемента, который был удален из выделенного фрагмента. |
|
В объекте контейнера произошли различные изменения выделения. Система отправляет это событие для списков; серверные приложения отправляют его для своих объектов со специальными возможностями. Это событие отправляется, когда выбранные элементы в элементе управления существенно изменились. Событие информирует клиента о том, что произошло много изменений выбора, и оно отправляется вместо нескольких событий EVENT_OBJECT_SELECTIONADD или EVENT_OBJECT_SELECTIONREMOVE . Клиент запрашивает выбранные элементы, вызывая метод IAccessible::get_accSelection объекта контейнера и перечисляя выбранные элементы. Для этого уведомления о событии параметры hwnd и idObject функции обратного вызова WinEventProc описывают контейнер, в котором произошли изменения. |
|
Отображается скрытый объект. Система отправляет данное событие для следующих элементов пользовательского интерфейса: знак вставки, курсор и объект окна. Серверные приложения отправляют данное событие для объектов со специальными возможностями. Клиенты предполагают, что при отправке этого события родительским объектом все дочерние объекты уже отображаются. Поэтому серверные приложения не отправляют это событие для дочерних объектов. Скрытые объекты включают флаг STATE_SYSTEM_INVISIBLE ; отображаемые объекты не включают этот флаг. Событие EVENT_OBJECT_SHOW также указывает, что флаг STATE_SYSTEM_INVISIBLE снят. Таким образом, серверы не отправляют событие EVENT_OBJECT_STATECHANGE в этом случае. |
|
Состояние объекта изменилось. Система отправляет это событие для следующих элементов пользовательского интерфейса: проверка, поле со списком, заголовок, кнопка нажатия, переключатель, полоса прокрутки, панель инструментов, элемент управления представлением в виде дерева, элемент управления вверх-вниз и объект окна. Серверные приложения отправляют данное событие для объектов со специальными возможностями. Например, изменение состояния происходит при нажатии или освобождении объекта кнопки, а также при включении или отключении объекта. Для этого уведомления о событии параметр idChild функции обратного вызова WinEventProc определяет дочерний объект, состояние которого изменилось. |
|
Целевой объект преобразования в композиции IME изменился. Целевой объект преобразования — это подмножество композиции IME, которое активно выбирается в качестве целевого объекта для преобразований, инициированных пользователем. |
|
Изменено выделение текста объекта. Это событие поддерживается общими элементами управления и используется в модели автоматизации пользовательского интерфейса. Параметры hwnd, ID и idChild функции обратного вызова WinEventProc описывают элемент, содержащийся в обновленном фрагменте текста. |
|
Отправляется, когда окно не закрыто. Скрытое окно по-прежнему существует, но невидимо для пользователя. |
|
Свойство Value объекта изменилось. Система отправляет это событие для элементов пользовательского интерфейса, которые включают полосу прокрутки и следующие элементы управления: правка, заголовок, горячая клавиша, индикатор выполнения, ползунок и вверх-вниз. Серверные приложения отправляют данное событие для объектов со специальными возможностями. |
|
Диапазон значений констант событий, зарезервированных для изготовителей оборудования. Дополнительные сведения см. в разделе Выделение идентификаторов WinEvent. |
|
Создано оповещение. Серверные приложения не должны отправлять это событие. |
|
Отображается прямоугольник предварительного просмотра. |
|
Окно потеряло захват мыши. Это событие отправляется системой, а не серверами. |
|
Окно получило захват мыши. Это событие отправляется системой, а не серверами. |
|
Окно завершило контекстно-зависимый режим справки. Это событие не отправляется системой согласованно. |
|
Окно перешло в контекстно-зависимый режим справки. Это событие не отправляется системой согласованно. |
|
Активный рабочий стол переключен. |
|
Диалоговое окно закрыто. Система отправляет это событие для стандартных диалоговых окон; серверы отправляют его для пользовательских диалоговых окон. Это событие не отправляется системой согласованно. |
|
Откроется диалоговое окно. Система отправляет это событие для стандартных диалоговых окон, созданных с помощью шаблонов ресурсов или функций диалогового окна Win32. Серверы отправляют это событие для пользовательских диалоговых окон, которые функционируют как диалоговые окна, но не создаются стандартным способом. Это событие не отправляется системой согласованно. |
|
Приложение выходит из режима перетаскивания. Приложения, поддерживающие операции перетаскивания, должны отправлять это событие; система не отправляет это событие. |
|
Приложение входит в режим перетаскивания. Приложения, поддерживающие операции перетаскивания, должны отправлять это событие, так как система не отправляет его. |
|
Наибольшее значение системного события. |
|
Окно переднего плана изменилось. Система отправляет это событие, даже если окно переднего плана изменилось на другое окно в том же потоке. Серверные приложения никогда не отправляют данное событие. Для этого события параметр hwnd функции обратного вызова WinEventProc — это дескриптор окна на переднем плане, параметр idObject — OBJID_WINDOW, а параметр idChild — CHILDID_SELF. |
|
Всплывающее меню закрыто. Система отправляет это событие для стандартных меню; серверы отправляют его для пользовательских меню. При закрытии всплывающего меню клиент получает это сообщение, а затем событие EVENT_SYSTEM_MENUEND . Это событие не отправляется системой согласованно. |
|
Отображается всплывающее меню. Система отправляет это событие для стандартных меню, которые определяются HMENU и создаются с помощью ресурсов шаблона меню или функций меню Win32. Серверы отправляют это событие для пользовательских меню, которые являются элементами пользовательского интерфейса, которые функционируют как меню, но не создаются стандартным способом. Это событие не отправляется системой согласованно. |
|
Меню в строке меню закрыто. Система отправляет это событие для стандартных меню; серверы отправляют его для пользовательских меню. Для этого события параметры функции обратного вызова WinEventProchwnd, idObject и idChild ссылаются на элемент управления, содержащий строку меню, или элемент управления, активизующий контекстное меню. Параметр hwnd — это дескриптор окна, связанного с событием . Параметр idObjectOBJID_MENU илиOBJID_SYSMENU для меню или OBJID_WINDOW для всплывающего меню. Параметр idChildимеет значение CHILDID_SELF. |
|
Выбран пункт меню в строке меню. Система отправляет это событие для стандартных меню, которые определяются HMENU, созданные с помощью ресурсов шаблона меню или элементов API меню Win32. Серверы отправляют это событие для пользовательских меню, которые являются элементами пользовательского интерфейса, которые функционируют как меню, но не создаются стандартным способом. Для этого события параметры функции обратного вызова WinEventProchwnd, idObject и idChild ссылаются на элемент управления, содержащий строку меню, или элемент управления, активизующий контекстное меню. Параметр hwnd — это дескриптор окна, связанного с событием . Параметр idObjectOBJID_MENU илиOBJID_SYSMENU для меню или OBJID_WINDOW для всплывающего меню. Параметр idChildимеет значение CHILDID_SELF. Система активирует несколько EVENT_SYSTEM_MENUSTART событий, которые не всегда соответствуют событию EVENT_SYSTEM_MENUEND . |
|
Объект окна будет восстановлен. Это событие отправляется системой, а не серверами. |
|
Объект окна будет свернут. Это событие отправляется системой, а не серверами. |
|
Перемещение или изменение размера окна завершено. Это событие отправляется системой, а не серверами. |
|
Происходит изменение размеров окна или его перемещение. Это событие отправляется системой, а не серверами. |
|
На полосе прокрутки прокрутка закончилась. Это событие отправляется системой для стандартных элементов управления полосой прокрутки и для полос прокрутки, прикрепленных к окну. Серверы отправляют это событие для пользовательских полос прокрутки, которые представляют собой элементы пользовательского интерфейса, которые функционируют как полосы прокрутки, но не создаются стандартным способом. Параметр idObject , отправляемый в функцию обратного вызова WinEventProc , OBJID_HSCROLL для горизонтальных полос прокрутки и OBJID_VSCROLL для вертикальных полос прокрутки. |
|
На полосе прокрутки началась прокрутка. Система отправляет это событие для стандартных элементов управления полосой прокрутки и полос прокрутки, прикрепленных к окну. Серверы отправляют это событие для пользовательских полос прокрутки, которые представляют собой элементы пользовательского интерфейса, которые функционируют как полосы прокрутки, но не создаются стандартным способом. Параметр idObject , отправляемый в функцию обратного вызова WinEventProc , OBJID_HSCROLL для горизонтальных полос прокрутки и OBJID_VSCROLL для вертикальных полос прокрутки. |
|
Звук был воспроизведен. Система отправляет это событие при воспроизведении системного звука, например для меню, даже если звук не слышен (например, из-за отсутствия звукового файла или звукового карта). Серверы отправляют это событие всякий раз, когда пользовательский элемент пользовательского интерфейса создает звук. Для этого события функция обратного вызова WinEventProc получает значение OBJID_SOUND в качестве параметра idObject . |
|
Пользователь выпустил сочетание клавиш ALT+TAB. Это событие отправляется системой, а не серверами. Параметр hwnd функции обратного вызова WinEventProc определяет окно, в которое переключился пользователь. Если при нажатии клавиш ALT+TAB выполняется только одно приложение, система отправляет это событие без соответствующего события EVENT_SYSTEM_SWITCHSTART . |
|
Пользователь нажимает клавиши ALT+TAB, что активирует окно переключения. Это событие отправляется системой, а не серверами. Параметр hwnd функции обратного вызова WinEventProc определяет окно, в которое переключается пользователь. Если при нажатии клавиш ALT+TAB выполняется только одно приложение, система отправляет событие EVENT_SYSTEM_SWITCHEND без соответствующего события EVENT_SYSTEM_SWITCHSTART . |
|
Диапазон значений констант событий, зарезервированных для идентификаторов событий модели автоматизации пользовательского интерфейса. Дополнительные сведения см. в разделе Выделение идентификаторов WinEvent. |
|
Диапазон значений констант событий, зарезервированных для идентификаторов измененных свойств в модели автоматизации пользовательского интерфейса. Дополнительные сведения см. в разделе Выделение идентификаторов WinEvent. |
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по