WinEvent azonosítók kiosztása
Minden WinEvent csak meghatározott célra használható. A WinEvent nem szándékos használata ütközéseket okozhat más alkalmazásokkal vagy operációs rendszerekkel, ami miatt az alkalmazások vagy az operációs rendszer instabillá válhatnak.
A Microsoft a WinEvents több különböző kategóriáját definiálta, és minden kategóriához egy vagy több értéktartományt határozott meg WinEvent-azonosítóként való használatra. A közösségi fenntartott tartomány (0xA000 –0xAFFF) olyan alkalmazások számára érhető el, amelyek új WinEvent-eket kell meghatározniuk. Az ebből a tartományból származó értékek használata segít csökkenteni az ütközések kockázatát; Az új WinEvents-eket létrehozó fejlesztőknek azonban továbbra is együtt kell működniük, hogy elkerülhessék az alkalmazások közötti ütközéseket.
Az alábbi táblázat a WinEvent-kategóriákat és az egyes kategóriákhoz definiált értéktartományokat mutatja be.
| Kategória | Tartomány | Jelenleg használatban | Megjegyzések |
|---|---|---|---|
| Microsoft Active Accessibility-események (fenntartott rendszer) | 0x0001-0x00FF | 0x0001-0x0020 | EVENT_SYSTEM_* eseményazonosítók |
| Microsoft Active Accessibility-események (fenntartott rendszer) | 0x4001-0x40FF | 0x4001-0x4007 | EVENT_CONSOLE_* eseményazonosítók |
| Felhasználói felület automatizálási eseményei (fenntartott rendszer) | 0x4E00-0x4EFF | 0x4E20-0x4E33 | UI Automation-eseményazonosítók |
| Felhasználói felület automatizálási eseményei (fenntartott rendszer) | 0x7500-0x75FF | 0x7530-0x759B | UI Automation tulajdonság által módosított eseményazonosítók |
| Microsoft Active Accessibility-események (fenntartott rendszer) | 0x8000-0x80FF | 0x8000-0x8015 | EVENT_OBJECT_* eseményazonosítók |
| FENNTARTOTT OEM | 0x0101-0x01FF | 0x0101-0x0122 | IAccessible2 eseményazonosítók |
| Közösségi fenntartott | 0xA000-0xAFFF | Egyik sem | Az Accessibility Interoperability Alliance (AIA) specifikációi által meghatározott új események számára fenntartott |
| ATOM | 0xC000-0xFFFF | 0xC000-0xFFFF | A futtatókörnyezetben lefoglalt egyéni eseményekhez van fenntartva |
Az alábbi témakörök részletesebben ismertetik a WinEvent-tartományokat.
Microsoft Active Accessibility and UI Automation Events
A WinEvent-azonosítók öt tartományát a Microsoft Active Accessibility és a Microsoft UI Automation használja. Az első tartomány (0x0001 –0x00FF) rendszerszintű eseményekhez van fenntartva, amelyek általában a rendszer összes alkalmazását érintő helyzetek leírására szolgálnak. A második tartomány (0x4001 –0x40FF) a Windows konzolspecifikus eseményeihez van fenntartva. A harmadik (0x4E00 –0x4EFF) és negyedik tartomány (0x7500 –0x75FF) a felhasználói felület automation eseményeinek tükröződését tükrözik. Végül az ötödik tartomány (0x8000 –0x80FF) olyan objektumszintű eseményekre vonatkozik, amelyek egy alkalmazáson belüli objektumokra jellemző helyzetekre vonatkoznak.
A Microsoft Active Accessibility és a UI Automation összes eseménye a WinUser.h és a UIAutomationClient.h fejlécfájlban van definiálva.
Fenntartott OEM-események
A fenntartott OEM-tartomány mindenki számára nyitva áll, akinek kommunikációs mechanizmusként kell használnia a WinEvents-t. A fejlesztőknek az eseményfeldolgozáshoz meg kell határozniuk és közzé kell tenniük az eseménydefiníciókat a paramétereikkel (vagy a társított objektumtípusokkal) együtt, hogy elkerülhetők legyenek az eseményazonosítók véletlen ütközései. Az IAccessible2 specifikáció az OEM fenntartott tartományának egy részét használja.
Fenntartott közösségi események
A közösségi fenntartott tartomány az Akadálymentességi Együttműködési Szövetség (AIA) által meghatározott WinEvents számára készült, az iparág egészére kiterjedő használatra. A fejlesztőknek határozottan javasoljuk, hogy a tartomány értékeinek használata előtt határozzanak meg és tegyenek közzé egy hivatalos specifikációt.
ATOM-események
Az ATOM-tartomány olyan eseményazonosítókhoz van fenntartva, amelyek futásidőben vannak lefoglalva a UI Automation bővíthetőségi API-ján keresztül. Ne használja az ATOM-tartomány értékeit semmilyen más célra. A WinEvents atomtartományból való kiosztásának ajánlott módszere a GlobalAddAtom függvény sztring GUID azonosítóval történő használata.
Fenntartott tartomány értékeinek használata
A WinEvent specifikációja szerint a fenntartott rendszertartományból vagy bármely más nem definiált tartományból származó értékek nem használhatók az SDK módosítása nélkül. Új WinEvents esetén az alkalmazásoknak az OEM fenntartott vagy közösségi fenntartott tartományok értékeit kell használniuk. Az új WinEvent használata előtt a fejlesztőknek kifejezetten ajánlott nyíltan és széles körben megosztaniuk specifikációikat, és a WinEvent specifikációinak meghatározásához együtt kell működniük az Akadálymentesség Együttműködési Szövetséggel.
Kapcsolódó témakörök