Allocazione di ID WinEvent
Ogni Evento WinEvent deve essere usato solo per uno scopo specifico. L'uso di un evento WinEvent per uno scopo imprevisto può causare conflitti con altre applicazioni o con il sistema operativo, che può causare l'instabilità delle applicazioni o del sistema operativo.
Microsoft ha definito diverse categorie di WinEvent e, per ogni categoria, ha definito uno o più intervalli di valori da usare come ID WinEvent. L'intervallo Riservato community (0xA000, 0xAFFF) è disponibile per le applicazioni che devono definire nuovi eventi WinEvent. L'uso dei valori di questo intervallo consente di ridurre il rischio di collisioni; Tuttavia, gli sviluppatori che creano nuovi eventi WinEvent devono comunque collaborare per evitare conflitti tra le applicazioni.
La tabella seguente illustra le categorie WinEvent e gli intervalli di valori definiti per ogni categoria.
| Categoria | Gamma | Attualmente in uso | Commenti |
|---|---|---|---|
| Eventi di Accessibilità attiva Microsoft (sistema riservato) | 0x0001-0x00FF | 0x0001-0x0020 | ID evento EVENT_SYSTEM_* |
| Eventi di Accessibilità attiva Microsoft (sistema riservato) | 0x4001-0x40FF | 0x4001-0x4007 | ID evento EVENT_CONSOLE_* |
| Eventi di automazione interfaccia utente (sistema riservato) | 0x4E00-0x4EFF | 0x4E20-0x4E33 | ID eventi di automazione interfaccia utente |
| Eventi di automazione interfaccia utente (sistema riservato) | 0x7500-0x75FF | 0x7530-0x759B | ID evento di automazione interfaccia utente modificati |
| Eventi di Accessibilità attiva Microsoft (sistema riservato) | 0x8000-0x80FF | 0x8000-0x8015 | ID evento EVENT_OBJECT_* |
| OEM riservato | 0x0101-0x01FF | 0x0101-0x0122 | ID evento IAccessible2 |
| Community Reserved | 0xA000-0xAFFF | Nessuno | Riservato per nuovi eventi definiti dalle specifiche di Accessibility Interoperability Alliance (AIA) |
| ATOMO | 0xC000-0xFFFF | 0xC000-0xFFFF | Riservato per gli eventi personalizzati allocati in fase di esecuzione |
Negli argomenti seguenti vengono descritti in modo più dettagliato gli intervalli WinEvent.
Eventi di automazione interfaccia utente e accessibilità attiva Microsoft
Cinque intervalli di ID WinEvent sono riservati per l'uso da Parte di Microsoft Active Accessibility e Automazione interfaccia utente Microsoft. Il primo intervallo (0x0001, 0x00FF) è riservato agli eventi a livello di sistema, in genere usati per descrivere le situazioni che interessano tutte le applicazioni nel sistema. Il secondo intervallo (0x4001, 0x40FF) è riservato agli eventi specifici della console di Windows. Il terzo (0x4E00, 0x4EFF) e il quarto intervallo (0x7500, 0x75FF) sono destinati alla reflection degli eventi di automazione interfaccia utente. Infine, il quinto intervallo (0x8000, 0x80FF) riguarda gli eventi a livello di oggetto che riguardano situazioni specifiche degli oggetti all'interno di un'applicazione.
Tutti gli eventi di accessibilità e automazione interfaccia utente microsoft vengono definiti nei file di intestazione WinUser.h e UIAutomationClient.h.
Eventi riservati OEM
L'intervallo riservato OEM è aperto a chiunque debba usare WinEvents come meccanismo di comunicazione. Gli sviluppatori devono definire e pubblicare definizioni di eventi insieme ai relativi parametri (o anche ai tipi di oggetto associati) per l'elaborazione degli eventi in modo che sia possibile evitare conflitti accidentali di ID evento. La specifica IAccessible2 usa parte dell'intervallo riservato OEM.
Eventi riservati della community
L'intervallo Community Reserved è destinato a WinEvents specificato da Accessibility Interoperability Alliance (AIA) per l'uso in tutto il settore. Gli sviluppatori sono fortemente invitati a definire e pubblicare una specifica ufficiale prima di usare i valori di questo intervallo.
Eventi ATOM
L'intervallo ATOM è riservato agli ID evento allocati in fase di esecuzione tramite l'API di estendibilità dell'automazione interfaccia utente. Non usare i valori dell'intervallo ATOM per altri scopi. L'uso della funzioneGlobalAddAtom con un GUID stringa è il metodo consigliato per allocare WinEvents dall'intervallo ATOM.
Uso di valori da un intervallo riservato
In base alla specifica WinEvent, i valori dell'intervallo Riservato sistema o qualsiasi altro intervallo non definito non possono essere usati senza rivedere l'SDK. Per i nuovi eventi WinEvent, le applicazioni devono usare i valori degli intervalli oem riservati o riservati della community. Prima di usare un nuovo WinEvent, gli sviluppatori sono fortemente invitati a condividere le proprie specifiche in modo aperto e ampio e dovrebbero collaborare con Accessibility Interoperability Alliance per definire specifiche WinEvent.
Argomenti correlati