Costanti evento (Winuser.h)
Questo argomento descrive gli eventi generati dal sistema operativo e dalle applicazioni server. Le costanti sono elencate in ordine alfabetico.
Prima di usare questi eventi, le applicazioni client devono usare Event Watcher accessibile per verificare che questi eventi vengano usati dagli elementi dell'interfaccia utente.
Per altre informazioni sugli eventi in generale, vedere What Are WinEvents?and System Level and Object Level Events.For more information about events in general, see What Are WinEvents? and System Level Events.For more information about events in general, see What Are WinEvents? and System Level Events.For more information about events in general, Per altre informazioni sugli eventi inviati dal sistema, vedere Appendice A: Informazioni di riferimento sugli elementi dell'interfaccia utente supportati.
| Costante/valore | Descrizione |
|---|---|
|
Intervallo di valori costanti WinEvent specificati dall'AiA (Accessibility Interoperabil Alliance) per l'uso in tutto il settore. Per altre informazioni, vedere Allocazione degli ID WinEvent. |
|
Valori di evento più bassi e più alti. |
|
La proprietà KeyboardShortcut di un oggetto è stata modificata. L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. |
|
Inviato quando una finestra viene mascherata. Esiste ancora una finestra con mantello, ma è invisibile all'utente. |
|
Lo scorrimento di un oggetto finestra è terminato. A differenza di EVENT_SYSTEM_SCROLLEND, questo evento è associato alla finestra di scorrimento. Se lo scorrimento è orizzontale o verticale, questo evento deve essere inviato ogni volta che viene completata l'azione di scorrimento. Il parametro hwnd della funzione di callback WinEventProc descrive la finestra di scorrimento; il parametro idObject è OBJID_CLIENT e il parametro idChild è CHILDID_SELF. |
|
Un oggetto è stato creato. Il sistema invia questo evento per gli elementi dell'interfaccia utente seguenti: caret, controllo intestazione, controllo visualizzazione elenco, controllotabulazioni, controllo barra degli strumenti, controllo visualizzazione albero e oggetto finestra . L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. Prima di inviare l'evento per l'oggetto padre, i server devono inviarli per tutti gli oggetti figlio di un oggetto. I server devono assicurarsi che tutti gli oggetti figlio siano completamente creati e pronti per accettare chiamate IAccessi dai client prima che l'oggetto padre invii questo evento. Poiché un oggetto padre viene creato dopo gli oggetti figlio, i client devono assicurarsi che l'elemento padre di un oggetto sia stato creato prima di chiamare IAccess::get_accParent, in particolare se vengono usate funzioni di hook nel contesto. |
|
La proprietà DefaultAction di un oggetto è stata modificata. Questo evento viene inviato dal sistema per le finestre di dialogo L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. |
|
La proprietà Description di un oggetto è stata modificata. L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. |
|
Un oggetto è stato eliminato. Il sistema invia questo evento per gli elementi dell'interfaccia utente seguenti: caret, controllo intestazione, controllo visualizzazione elenco, controllo tabulazioni, controllo barra degli strumenti, controllo visualizzazione albero e oggetto finestra. L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. I client presuppongono che tutti gli elementi figlio di un oggetto vengano eliminati quando l'oggetto padre invia questo evento. Dopo aver ricevuto questo evento, i client non chiamano le proprietà o i metodi IAccessi di un oggetto. Tuttavia, il puntatore dell'interfaccia deve rimanere valido fino a quando è presente un conteggio dei riferimenti (a causa di regole COM), ma l'elemento dell'interfaccia utente potrebbe non essere più presente. Ulteriori chiamate sul puntatore dell'interfaccia possono restituire errori di errore; per evitare questo problema, i server creano oggetti proxy e monitorano gli intervalli di vita. |
|
L'utente ha iniziato a trascinare un elemento. I parametri hwnd, idObject e idChild della funzione di callback WinEventProc identificano l'oggetto trascinato. |
|
L'utente ha terminato un'operazione di trascinamento prima di eliminare l'elemento trascinato in una destinazione di rilascio. I parametri hwnd, idObject e idChild della funzione di callback WinEventProc identificano l'oggetto trascinato. |
|
L'utente ha eliminato un elemento in una destinazione di rilascio. I parametri hwnd, idObject e idChild della funzione di callback WinEventProc identificano l'oggetto trascinato. |
|
L'utente ha trascinato un elemento nel limite di una destinazione di rilascio. I parametri hwnd, idObject e idChild della funzione di callback WinEventProc identificano la destinazione di rilascio. |
|
L'utente ha trascinato un elemento fuori dal limite di una destinazione di rilascio. I parametri hwnd, idObject e idChild della funzione di callback WinEventProc identificano la destinazione di rilascio. |
|
L'utente ha eliminato un elemento in una destinazione di rilascio. I parametri hwnd, idObject e idChild della funzione di callback WinEventProc identificano la destinazione di rilascio. |
|
Valore di evento dell'oggetto più alto. |
|
Un oggetto ha ricevuto lo stato attivo. Il sistema invia questo evento per gli elementi dell'interfaccia utente seguenti: controllo visualizzazione elenco, barra dei menu, menu a comparsa, finestra di scelta, controllo scheda, controllo visualizzazione albero e oggetto finestra. L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. Il parametro hwnd della funzione callback WinEventProc identifica la finestra che riceve lo stato attivo della tastiera. |
|
La proprietà Help di un oggetto è stata modificata. L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. |
|
Un oggetto è nascosto. Il sistema invia questo evento per gli elementi dell'interfaccia utente seguenti: caret e cursore. L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. Quando questo evento viene generato per un oggetto padre, tutti gli oggetti figlio sono già nascosti. Le applicazioni server non inviano questo evento per gli oggetti figlio. Gli oggetti nascosti includono il flag di STATE_SYSTEM_INVISIBLE ; gli oggetti visualizzati non includono questo flag. L'evento EVENT_OBJECT_HIDE indica anche che il flag di STATE_SYSTEM_INVISIBLE è impostato. Pertanto, i server non inviano l'evento EVENT_OBJECT_STATECHANGE in questo caso. |
|
Una finestra che ospita altri oggetti accessibili ha modificato gli oggetti ospitati. Un client potrebbe dover eseguire una query sulla finestra host per individuare i nuovi oggetti ospitati, soprattutto se il client ha eseguito il monitoraggio degli eventi dalla finestra. Un oggetto ospitato è un oggetto di un framework di accessibilità (MSAA o Automazione interfaccia utente) diverso da quello dell'host. Le modifiche apportate agli oggetti ospitati provenienti dallo stesso framework dell'host devono essere consegnate con gli eventi di modifica strutturale, ad esempio EVENT_OBJECT_CREATE per MSAA. Per altre informazioni, vedere commenti all'interno di winuser.h. |
|
Una finestra IME è diventata nascosta. |
|
Una finestra IME è diventata visibile. |
|
Le dimensioni o la posizione di una finestra IME sono state modificate. |
|
È stato richiamato un oggetto; ad esempio, l'utente ha fatto clic su un pulsante. Questo evento è supportato dai controlli comuni e viene usato da Automazione interfaccia utente. Per questo evento, i parametri hwnd, ID e idChild della funzione di callback WinEventProc identificano l'elemento richiamato. |
|
Un oggetto che fa parte di un'area dinamica è cambiato. Un'area live è un'area di un'applicazione che cambia spesso e/o in modo asincrono. |
|
È stata modificata la posizione, la forma o la dimensione di un oggetto. Il sistema invia questo evento per gli elementi dell'interfaccia utente seguenti: caret e oggetti finestra. L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. Questo evento viene generato in risposta a una modifica nell'oggetto di primo livello all'interno della gerarchia di oggetti; non viene generato per alcun elemento figlio che l'oggetto potrebbe avere. Ad esempio, se l'utente ridimensiona una finestra, il sistema invia questa notifica per la finestra, ma non per la barra dei menu, la barra del titolo, la barra di scorrimento o altri oggetti che sono stati modificati. Quando si sposta l'oggetto padre, il sistema non invia questo evento per ogni finestra figlio fissa. Tuttavia, se un'applicazione ridimensiona in modo esplicito le finestre figlio in seguito al ridimensionamento della finestra padre, il sistema invia più eventi per gli elementi figlio ridimensionati. Se la proprietà State di un oggetto è impostata su STATE_SYSTEM_FLOATING, il server invia EVENT_OBJECT_LOCATIONCHANGE ogni volta che l'oggetto cambia posizione. Se un oggetto non dispone di questo stato, i server attivano questo evento solo quando l'oggetto viene spostato in relazione al relativo padre. Per questa notifica evento, il parametro idChild della funzione di callback WinEventProc identifica l'oggetto figlio modificato. |
|
La proprietà Name di un oggetto è stata modificata. Il sistema invia questo evento per gli elementi dell'interfaccia utente seguenti: casella di controllo, cursore, controllo visualizzazione elenco, pulsante di scelta, pulsante di opzione, controllo barra di stato, controllo visualizzazione albero e oggetto finestra. L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. |
|
Un oggetto ha un nuovo elemento padre. L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. |
|
Sono stati aggiunti o rimossi gli oggetti figlio di un oggetto contenitore oppure ne è stato modificato l'ordine. Il sistema invia questo evento per gli elementi dell'interfaccia utente seguenti: controllo intestazione, controllo visualizzazione elenco, controllo della barra degli strumenti e oggetto finestra. e dalle applicazioni server per i relativi oggetti accessibili, quando necessario. Ad esempio, questo evento viene generato da un oggetto di visualizzazione elenco quando il numero di elementi figlio o l'ordine degli elementi cambia. Questo evento viene inviato anche da una finestra padre quando cambia l'ordine Z per le finestre figlio. |
|
La selezione in un oggetto contenitore ha subito modifiche. Il sistema invia questo evento per gli elementi dell'interfaccia utente seguenti: controllo elenco, controllo tabulazioni, controllo visualizzazione albero e oggetto finestra. L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. Questo evento segnala una singola selezione: un elemento figlio è selezionato in un contenitore che in precedenza non contiene elementi figlio selezionati o la selezione è cambiata da un elemento figlio a un altro. I parametri hwnd e idObject della funzione di callback WinEventProc descrivono il contenitore; il parametro idChild identifica l'oggetto selezionato. Se l'elemento figlio selezionato è una finestra contenente anche oggetti, il parametro idChild è OBJID_WINDOW. |
|
Un elemento figlio all'interno di un oggetto contenitore è stato aggiunto a una selezione esistente. Il sistema invia questo evento per gli elementi dell'interfaccia utente seguenti: casella di riepilogo, controllo visualizzazione elenco e controllo visualizzazione albero. L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. I parametri hwnd e idObject della funzione di callback WinEventProc descrivono il contenitore. Il parametro idChild è il figlio aggiunto alla selezione. |
|
È stato rimosso dalla selezione un elemento all'interno di un oggetto contenitore. Il sistema invia questo evento per gli elementi dell'interfaccia utente seguenti: casella di riepilogo, controllo visualizzazione elenco e controllo visualizzazione albero. L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. Questo evento segnala che un elemento figlio viene rimosso da una selezione esistente. I parametri hwnd e idObject della funzione di callback WinEventProc descrivono il contenitore; il parametro idChild identifica il figlio rimosso dalla selezione. |
|
La selezione degli oggetti all'interno di un oggetto contenitore è stata modificata più volte. Il sistema invia questo evento per le caselle di riepilogo; le applicazioni server lo inviano per gli oggetti accessibili. Questo evento viene inviato quando gli elementi selezionati all'interno di un controllo sono stati modificati in modo significativo. L'evento informa il client che si sono verificate molte modifiche di selezione e viene inviato anziché diversi eventi EVENT_OBJECT_SELECTIONADD o EVENT_OBJECT_SELECTIONREMOVE . Il client esegue query per gli elementi selezionati chiamando il metodo IAccess::get_accSelection dell'oggetto contenitore ed enumerando gli elementi selezionati. Per questa notifica evento, i parametri hwnd e idObject della funzione di callback WinEventProc descrivono il contenitore in cui si sono verificate le modifiche. |
|
Viene visualizzato un oggetto nascosto. Questo evento viene inviato dal sistema per i seguenti elementi dell'interfaccia utente: punto di inserimento, cursore e oggetto finestra, L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. I client presuppongono che quando questo evento viene inviato da un oggetto padre, tutti gli oggetti figlio sono già visualizzati. Pertanto, le applicazioni server non inviano questo evento per gli oggetti figlio. Gli oggetti nascosti includono il flag di STATE_SYSTEM_INVISIBLE ; gli oggetti visualizzati non includono questo flag. L'evento EVENT_OBJECT_SHOW indica anche che il flag di STATE_SYSTEM_INVISIBLE viene cancellato. Pertanto, i server non inviano l'evento EVENT_OBJECT_STATECHANGE in questo caso. |
|
È stato modificato lo stato di un oggetto. Il sistema invia questo evento per gli elementi dell'interfaccia utente seguenti: casella di controllo, casella di controllo combinata, controllo intestazione, pulsante di opzione, pulsante di opzione, barra di scorrimento, controllo barra degli strumenti, controllo visualizzazione albero, controllo su basso e oggetto finestra. L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. Ad esempio, una modifica dello stato si verifica quando un oggetto pulsante viene fatto clic o rilasciato oppure quando un oggetto è abilitato o disabilitato. Per questa notifica dell'evento, il parametro idChild della funzione di callback WinEventProc identifica l'oggetto figlio il cui stato è stato modificato. |
|
La destinazione di conversione all'interno di una composizione IME è stata modificata. La destinazione di conversione è il subset della composizione IME selezionata attivamente come destinazione per le conversioni avviate dall'utente. |
|
La selezione del testo di un oggetto è stata modificata. Questo evento è supportato dai controlli comuni e viene usato da Automazione interfaccia utente. I parametri hwnd, ID e idChild della funzione di callback WinEventProc descrivono l'elemento contenuto nella selezione di testo aggiornata. |
|
Inviato quando una finestra non viene chiuso. Esiste ancora una finestra con mantello, ma è invisibile all'utente. |
|
La proprietà Value di un oggetto è stata modificata. Il sistema invia questo evento per gli elementi dell'interfaccia utente che includono la barra di scorrimento e i controlli seguenti: modifica, intestazione, tasto di scelta rapida, barra di avanzamento, dispositivo di scorrimento e giù. L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. |
|
Intervallo di valori costanti dell'evento riservati per le macchine virtuali. Per altre informazioni, vedere Allocazione degli ID WinEvent. |
|
È stato generato un avviso. Le applicazioni server non devono inviare questo evento. |
|
Viene visualizzato un rettangolo di anteprima. |
|
Una finestra ha perso il mouse capture. Questo evento viene inviato dal sistema, mai dai server. |
|
Una finestra ha ricevuto l'acquisizione del mouse. Questo evento viene inviato dal sistema, mai dai server. |
|
Una finestra ha chiuso la modalità Guida sensibile al contesto. Questo evento non viene inviato in modo coerente dal sistema. |
|
Una finestra ha immesso la modalità Guida sensibile al contesto. Questo evento non viene inviato in modo coerente dal sistema. |
|
Il desktop attivo è stato modificato. |
|
È stata chiusa una finestra di dialogo. Il sistema invia questo evento per le finestre di dialogo standard; i server lo inviano per le finestre di dialogo personalizzate. Questo evento non viene inviato in modo coerente dal sistema. |
|
Viene visualizzata una finestra di dialogo. Il sistema invia questo evento per le finestre di dialogo standard, create usando i modelli di risorse o le funzioni della finestra di dialogo Win32. I server inviano questo evento per le finestre di dialogo personalizzate, ovvero finestre che funzionano come finestre di dialogo, ma non vengono create nel modo standard. Questo evento non viene inviato in modo coerente dal sistema. |
|
La modalità di trascinamento sta per essere disattivata in un'applicazione. Le applicazioni che supportano operazioni di trascinamento e rilascio devono inviare questo evento; il sistema non invia questo evento. |
|
La modalità di trascinamento sta per essere attivata in un'applicazione. Le applicazioni che supportano operazioni di trascinamento della selezione devono inviare questo evento perché il sistema non lo invia. |
|
Valore dell'evento di sistema più alto. |
|
La finestra in primo piano è stata modificata. Il sistema invia questo evento anche se la finestra di primo piano è stata modificata in un'altra finestra nello stesso thread. Questo evento non viene mai inviato dalle applicazioni server. Per questo evento, il parametro hwnd della funzione callback WinEventProc è l'handle della finestra in primo piano, il parametro idObject è OBJID_WINDOW e il parametro idChild è CHILDID_SELF. |
|
È stato chiuso un menu a comparsa. Il sistema invia questo evento per i menu standard; i server lo inviano per i menu personalizzati. Quando viene chiuso un menu a comparsa, il client riceve questo messaggio e quindi l'evento EVENT_SYSTEM_MENUEND . Questo evento non viene inviato in modo coerente dal sistema. |
|
È stato visualizzato un menu a comparsa. Il sistema invia questo evento per i menu standard, identificati da HMENU e vengono creati usando le risorse del modello di menu o le funzioni di menu Win32. I server inviano questo evento per i menu personalizzati, che sono elementi dell'interfaccia utente che funzionano come menu, ma non vengono creati nel modo standard. Questo evento non viene inviato in modo coerente dal sistema. |
|
È stato chiuso un menu dalla barra dei menu. Il sistema invia questo evento per i menu standard; i server lo inviano per i menu personalizzati. Per questo evento, i parametri di callback di WinEventProc, idObject e idChild fanno riferimento al controllo che contiene la barra dei menu o il controllo che attiva il menu di scelta rapida. Il parametro hwnd è l'handle della finestra correlata all'evento. Il parametro idObject è OBJID_MENU o OBJID_SYSMENUper un menu o OBJID_WINDOW per un menu a comparsa. Il parametro idChild è CHILDID_SELF. |
|
È stata selezionata una voce di menu sulla barra dei menu. Il sistema invia questo evento per i menu standard, identificati da HMENU, creati usando le risorse del modello di menu o gli elementi DELL'API del menu Win32. I server inviano questo evento per i menu personalizzati, che sono elementi dell'interfaccia utente che funzionano come menu, ma non vengono creati nel modo standard. Per questo evento, i parametri di callback di WinEventProc, idObject e idChild fanno riferimento al controllo che contiene la barra dei menu o il controllo che attiva il menu di scelta rapida. Il parametro hwnd è l'handle della finestra correlata all'evento. Il parametro idObject è OBJID_MENU o OBJID_SYSMENUper un menu o OBJID_WINDOW per un menu a comparsa. Il parametro idChild è CHILDID_SELF. Il sistema attiva più di un evento EVENT_SYSTEM_MENUSTART che non corrisponde sempre all'evento EVENT_SYSTEM_MENUEND . |
|
Un oggetto finestra sta per essere ripristinato. Questo evento viene inviato dal sistema, mai dai server. |
|
Un oggetto finestra sta per essere ridotto al minimo. Questo evento viene inviato dal sistema, mai dai server. |
|
Lo spostamento o il ridimensionamento di una finestra è terminato. Questo evento viene inviato dal sistema, mai dai server. |
|
È in corso lo spostamento o il ridimensionamento di una finestra. Questo evento viene inviato dal sistema, mai dai server. |
|
È terminata l'operazione di scorrimento in una barra di scorrimento. Questo evento viene inviato dal sistema per i controlli barra di scorrimento standard e per le barre di scorrimento associate a una finestra. I server inviano questo evento per barre di scorrimento personalizzate, che sono elementi dell'interfaccia utente che funzionano come barre di scorrimento, ma non vengono creati nel modo standard. Il parametro idObject inviato alla funzione di callback WinEventProc è OBJID_HSCROLL per le barre di scorrimento orizzontali e OBJID_VSCROLL per le barre di scorrimento verticali. |
|
È stata avviata l'operazione di scorrimento in una barra di scorrimento. Il sistema invia questo evento per i controlli barra di scorrimento standard e per le barre di scorrimento associate a una finestra. I server inviano questo evento per barre di scorrimento personalizzate, che sono elementi dell'interfaccia utente che funzionano come barre di scorrimento, ma non vengono creati nel modo standard. Il parametro idObject inviato alla funzione di callback WinEventProc è OBJID_HSCROLL per le barre di scorrimento orizzontali e OBJID_VSCROLL per le barre di scorrimento verticale. |
|
È stato riprodotto un suono. Il sistema invia questo evento quando un suono del sistema, ad esempio uno per un menu, viene riprodotto anche se nessun suono è udibile (ad esempio, a causa della mancanza di un file audio o di una scheda audio). I server inviano questo evento ogni volta che un elemento dell'interfaccia utente personalizzato genera un suono. Per questo evento, la funzione callback WinEventProc riceve il valore di OBJID_SOUND come parametro idObject . |
|
L'utente ha rilasciato ALT+TAB. Questo evento viene inviato dal sistema, mai dai server. Il parametro hwnd della funzione di callback WinEventProc identifica la finestra a cui l'utente è cambiato. Se viene eseguita una sola applicazione quando l'utente preme ALT+TAB, il sistema invia questo evento senza un evento EVENT_SYSTEM_SWITCHSTART corrispondente. |
|
L'utente ha premuto ALT+TAB, che attiva la finestra del commutatore. Questo evento viene inviato dal sistema, mai dai server. Il parametro hwnd della funzione di callback WinEventProc identifica la finestra a cui l'utente sta passando. Se un'unica applicazione viene eseguita quando l'utente preme ALT+TAB, il sistema invia un evento EVENT_SYSTEM_SWITCHEND senza un evento EVENT_SYSTEM_SWITCHSTART corrispondente. |
|
Intervallo di valori costanti eventi riservati per gli identificatori di evento Automazione interfaccia utente. Per altre informazioni, vedere Allocazione degli ID WinEvent. |
|
Intervallo di valori costanti dell'evento riservati per gli identificatori di evento Automazione interfaccia utente modificati dalla proprietà. Per altre informazioni, vedere Allocazione degli ID WinEvent. |
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|