AccessibleEvents Enumerazione
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Specifica gli eventi forniti dalle applicazioni accessibili.
public enum class AccessibleEventspublic enum AccessibleEventstype AccessibleEvents = Public Enum AccessibleEvents- Ereditarietà
Campi
| AcceleratorChange | 32786 | È stata modificata la proprietà KeyboardShortcut di un oggetto. e dalle applicazioni server per i relativi oggetti accessibili. |
| Create | 32768 | È stato creato un oggetto. L'evento viene inviato dal sistema operativo per i seguenti elementi dell'interfaccia utente: punto di inserimento, controllo intestazione, controllo visualizzazione elenco, controllo struttura a schede, controllo barra degli strumenti, controllo d visualizzazione ad albero e oggetto finestra, L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. I server devono inviare questo evento per tutti gli oggetti figlio di un oggetto prima di inviarlo per l'oggetto padre. Devono inoltre verificare che tutti gli oggetti figlio siano stati creati e possano accettare le chiamate provenienti dai client quando l'oggetto padre invia l'evento. |
| DefaultActionChange | 32785 | È stata modificata la proprietà DefaultAction di un oggetto. Questo evento viene inviato dal sistema per le finestre di dialogo L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. Non è pertanto necessario che le applicazioni server inviino questo evento per gli oggetti figlio. A differenza degli oggetti visibili, gli oggetti nascosti hanno lo stato Invisible. Gli eventi di tipo |
| DescriptionChange | 32781 | È stata modificata la proprietà Description di un oggetto. L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. |
| Destroy | 32769 | È stato eliminato un oggetto. Questo evento viene inviato dal sistema per i seguenti elementi dell'interfaccia utente: punto di inserimento, controllo intestazione, controllo visualizzazione elenco, controllo struttura a schede, controllo barra degli strumenti, controllo di visualizzazione ad albero e oggetto finestra, L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. Questo evento può essere inviato per gli oggetti figlio. Tuttavia, è possibile che l'invio di questo evento da parte dell'oggetto padre venga interpretato dai client come se gli elementi figlio fossero stati eliminati. |
| Focus | 32773 | Un oggetto ha ricevuto lo stato attivo. Questo evento viene inviato dal sistema per i seguenti elementi dell'interfaccia utente: controllo visualizzazione elenco, barra dei menu, menu di scelta rapida, finestra delle applicazioni in esecuzione, controllo struttura a schede, controllo di visualizzazione ad albero e oggetto finestra. L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. |
| HelpChange | 32784 | È stata modificata la proprietà Help di un oggetto. L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. |
| Hide | 32771 | Un oggetto è nascosto. Questo evento viene inviato dal sistema per i seguenti elementi dell'interfaccia utente: punto di inserimento e cursore, e dalle applicazioni server per i relativi oggetti accessibili. Quando viene generato l'evento per un oggetto padre, tutti gli oggetti figlio sono già nascosti. Non è pertanto necessario che le applicazioni server inviino l'evento per gli oggetti figlio. Questo evento non viene inviato dal sistema in modo coerente. |
| LocationChange | 32779 | È stata modificata la posizione, la forma o la dimensione di un oggetto. Questo evento viene inviato dal sistema per i seguenti elementi dell'interfaccia utente: punto di inserimento e oggetto finestra, L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. Questo evento viene generato in seguito alla modifica di un oggetto di livello superiore in una gerarchia di oggetti ma non degli oggetti figlio in esso contenuti. Se, ad esempio, si ridimensiona una finestra, il sistema invia questo evento per notificare il ridimensionamento della finestra, ma non della barra dei menu, della barra del titolo, delle barre di scorrimento o di altri oggetti anch'essi modificati. Quando si sposta l'oggetto padre, il sistema non invia questo evento per ogni finestra figlio fissa. Tuttavia, se in seguito a un'operazione di ridimensionamento vengono modificate in modo esplicito le dimensioni delle finestre figlio in un'applicazione, vengono inviati più eventi di notifica per le finestre figlio ridimensionate. Se la proprietà State di un oggetto è impostata su Floating, i server devono inviare un evento di modifica della posizione ogni volta che l'oggetto viene spostato. Se un oggetto non ha questo stato, i server devono generare l'evento ogni volta che la posizione dell'oggetto viene modificata rispetto a quella dell'oggetto padre. |
| NameChange | 32780 | È stata modificata la proprietà Name di un oggetto. Questo evento viene inviato dal sistema per i seguenti elementi dell'interfaccia utente: casella di controllo, cursore, controllo visualizzazione elenco, pulsante di comando, pulsante di opzione, controllo barra di stato, controllo di visualizzazione ad albero e oggetto finestra, L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. |
| ParentChange | 32783 | Un oggetto ha un nuovo elemento padre. L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. |
| Reorder | 32772 | Sono stati aggiunti o rimossi gli oggetti figlio di un oggetto contenitore oppure ne è stato modificato l'ordine. Questo evento viene inviato dal sistema per i seguenti elementi dell'interfaccia utente: controllo intestazione, controllo visualizzazione elenco, controllo barra degli strumenti e oggetto finestra, e dalle applicazioni server per i relativi oggetti accessibili, quando necessario. Questo evento viene inoltre inviato da una finestra padre quando viene modificato l'ordine Z delle finestre figlio. |
| Selection | 32774 | È stato selezionato un oggetto accessibile all'interno di un oggetto contenitore. Questo evento indica che è stata effettuata una singola selezione, ovvero è stato selezionato un oggetto figlio in un contenitore che in precedenza non includeva oggetti figlio selezionati oppure è stato selezionato un altro oggetto figlio. |
| SelectionAdd | 32775 | È stato aggiunto alla selezione un elemento all'interno di un oggetto contenitore. Questo evento viene inviato dal sistema per i seguenti elementi dell'interfaccia utente: casella di riepilogo, controllo visualizzazione elenco e controllo di visualizzazione ad albero, L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. Questo evento indica che un oggetto figlio è stato aggiunto a una selezione esistente. |
| SelectionRemove | 32776 | È stato rimosso dalla selezione un elemento all'interno di un oggetto contenitore. Questo evento viene inviato dal sistema per i seguenti elementi dell'interfaccia utente: casella di riepilogo, controllo visualizzazione elenco e controllo di visualizzazione ad albero, L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. Questo evento indica che un oggetto figlio è stato rimosso da una selezione esistente. |
| SelectionWithin | 32777 | La selezione degli oggetti all'interno di un oggetto contenitore è stata modificata più volte. Questo evento viene inviato dal sistema per le caselle di riepilogo L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili. Questo evento può essere inviato quando la selezione degli elementi all'interno di un controllo viene modificata in modo determinante. Questo evento indica al client che la selezione degli oggetti è stata modificata in modo determinante. È consigliabile inviare questo evento anziché più eventi |
| Show | 32770 | 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. È possibile che l'invio di questo evento da parte di un oggetto padre venga interpretato dai client come se tutti gli oggetti figlio fossero stati già visualizzati. Non è pertanto necessario che le applicazioni server inviino questo evento per gli oggetti figlio. |
| StateChange | 32778 | È stato modificato lo stato di un oggetto. Questo evento viene inviato dal sistema per i seguenti elementi dell'interfaccia utente: casella di controllo, casella combinata, controllo intestazione, pulsante di comando, pulsante di opzione, barra di scorrimento, controllo barra degli strumenti, controllo di visualizzazione ad albero, controllo di scorrimento e oggetto finestra, e dalle applicazioni server per i relativi oggetti accessibili. Un evento di modifica dello stato viene generato, ad esempio, in seguito alla pressione o al rilascio di un oggetto pulsante oppure all'abilitazione o alla disabilitazione di un oggetto. Questo evento non viene inviato dal sistema in modo coerente. |
| SystemAlert | 2 | È stato generato un avviso. Questo evento viene inviato dalle applicazioni server ogni volta che è stata apportata una modifica significativa all'interfaccia utente, che deve essere notificata all'utente. Questo evento non viene inviato dal sistema in modo coerente per gli oggetti finestra di dialogo. |
| SystemCaptureEnd | 9 | Una finestra ha perso il mouse capture. Questo evento viene inviato dal sistema, ma non dai server. |
| SystemCaptureStart | 8 | È in corso lo spostamento o il ridimensionamento di una finestra. Questo evento viene inviato dal sistema, ma non dai server. |
| SystemContextHelpEnd | 13 | È stata disattivata la modalità della Guida sensibile al contesto per una finestra. Questo evento non viene inviato dal sistema in modo coerente. |
| SystemContextHelpStart | 12 | È stata attivata la modalità della Guida sensibile al contesto per una finestra. Questo evento non viene inviato dal sistema in modo coerente. |
| SystemDialogEnd | 17 | È stata chiusa una finestra di dialogo. Questo evento non viene inviato dal sistema per le finestre di dialogo standard e dai server per le finestre di dialogo personalizzate. Questo evento non viene inviato dal sistema in modo coerente. |
| SystemDialogStart | 16 | È stata visualizzata una finestra di dialogo. Questo evento viene inviato dal sistema per le finestre di dialogo standard e dai server per le finestre di dialogo personalizzate. Questo evento non viene inviato dal sistema in modo coerente. |
| SystemDragDropEnd | 15 | La modalità di trascinamento sta per essere disattivata in un'applicazione. Questo evento deve essere inviato dalle applicazioni che supportano le operazioni di trascinamento, ma non dal sistema. |
| SystemDragDropStart | 14 | La modalità di trascinamento sta per essere attivata in un'applicazione. Questo evento deve essere inviato dalle applicazioni che supportano le operazioni di trascinamento, ma non dal sistema. |
| SystemForeground | 3 | È cambiata la finestra in primo piano. Questo evento viene inviato dal sistema anche se la finestra in primo piano è stata sostituita da un'altra finestra nello stesso thread. Questo evento non viene mai inviato dalle applicazioni server. |
| SystemMenuEnd | 5 | È stato chiuso un menu disponibile nella barra dei menu. Questo evento viene inviato dal sistema per i menu standard e dai server per i menu personalizzati. |
| SystemMenuPopupEnd | 7 | È stato chiuso un menu di scelta rapida. Questo evento viene inviato dal sistema per i menu standard e dai server per i menu personalizzati. Quando si chiude un menu di scelta rapida, al client viene inviata la notifica dell'evento seguita dall'evento Per una chiamata a |
| SystemMenuPopupStart | 6 | È stato visualizzato un menu di scelta rapida. Questo evento viene inviato dal sistema per i menu standard e dai server per i menu personalizzati. Questo evento non viene inviato dal sistema in modo coerente. Per una chiamata a |
| SystemMenuStart | 4 | È stata selezionata una voce di menu disponibile nella barra dei menu. Questo evento viene inviato dal sistema per i menu standard e dai server per i menu personalizzati. È possibile che vengano generati dal sistema più eventi |
| SystemMinimizeEnd | 23 | Un oggetto finestra è stato ridotto a icona o ingrandito. Questo evento viene inviato dal sistema, ma non dai server. |
| SystemMinimizeStart | 22 | Un oggetto finestra sta per essere ridotto a icona o ingrandito. Questo evento viene inviato dal sistema, ma non dai server. |
| SystemMoveSizeEnd | 11 | Lo spostamento o il ridimensionamento di una finestra è terminato. Questo evento viene inviato dal sistema, ma non dai server. |
| SystemMoveSizeStart | 10 | È in corso lo spostamento o il ridimensionamento di una finestra. Questo evento viene inviato dal sistema, ma non dai server. |
| SystemScrollingEnd | 19 | È terminata l'operazione di scorrimento in una barra di scorrimento. Questo evento viene inviato dal sistema per le barre di scorrimento associate a una finestra e per i controlli delle barre di scorrimento standard. Viene inoltre inviato dai server per le barre di scorrimento personalizzate. |
| SystemScrollingStart | 18 | È stata avviata l'operazione di scorrimento in una barra di scorrimento. Questo evento viene inviato dal sistema per le barre di scorrimento associate a una finestra e per i controlli delle barre di scorrimento standard. Viene inoltre inviato dai server per le barre di scorrimento personalizzate. |
| SystemSound | 1 | È stato emesso un segnale acustico. Questo evento viene inviato dal sistema quando viene emesso un segnale acustico, ad esempio per i menu, anche se tale segnale non è udibile. Ciò può essere causato dalla mancanza di un file o di una scheda audio. L'evento viene inviato dai server se un elemento personalizzato dell'interfaccia utente determina l'emissione di un segnale acustico. |
| SystemSwitchEnd | 21 | È stata rilasciata la combinazione di tasti ALT+TAB. L'evento |
| SystemSwitchStart | 20 | È stata premuta la combinazione di tasti ALT+TAB che attiva la finestra delle applicazioni in esecuzione. Se quando si preme la combinazione di tasti ALT+TAB è in esecuzione una singola applicazione, viene generato l'evento |
| ValueChange | 32782 | È stata modificata la proprietà Value di un oggetto. L'evento |
Esempio
Nell'esempio di codice seguente viene illustrata la creazione di un controllo grafico con riconoscimento dell'accessibilità usando le AccessibleObject classi e Control.ControlAccessibleObject per esporre informazioni accessibili. Il controllo traccia due curve insieme a una legenda. La ChartControlAccessibleObject classe, che deriva da ControlAccessibleObject, viene usata nel CreateAccessibilityInstance metodo per fornire informazioni accessibili personalizzate per il controllo grafico. Poiché la legenda del grafico non è un controllo basato effettivo Control , ma viene invece disegnato dal controllo grafico, non contiene informazioni accessibili predefinite. A causa di questo, la ChartControlAccessibleObject classe esegue l'override GetChild del metodo per restituire le CurveLegendAccessibleObject informazioni accessibili per ogni parte della legenda. Quando un'applicazione con riconoscimento accessibile usa questo controllo, il controllo può fornire le informazioni accessibili necessarie.
Questo esempio illustra l'uso dell'enumerazione AccessibleEvents con il AccessibilityNotifyClients metodo . Vedere la panoramica della classe per l'esempio AccessibleObject di codice completo.
// Gets or sets the location for the curve legend.
Point get()
{
return location;
}
void set( Point value )
{
location = value;
chart->Invalidate();
// Notifies the chart of the location change. This is used for
// the accessibility information. AccessibleEvents::LocationChange
// tells the chart the reason for the notification.
chart->AccessibilityNotifyClients( AccessibleEvents::LocationChange, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID );
}
}
property String^ Name
{
// Gets or sets the Name for the curve legend.
String^ get()
{
return name;
}
void set( String^ value )
{
if ( name != value )
{
name = value;
chart->Invalidate();
// Notifies the chart of the name change. This is used for
// the accessibility information. AccessibleEvents::NameChange
// tells the chart the reason for the notification.
chart->AccessibilityNotifyClients( AccessibleEvents::NameChange, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID );
}
}
}
property bool Selected
{
// Gets or sets the Selected state for the curve legend.
bool get()
{
return selected;
}
void set( bool value )
{
if ( selected != value )
{
selected = value;
chart->Invalidate();
// Notifies the chart of the selection value change. This is used for
// the accessibility information. The AccessibleEvents value depends upon
// if the selection is true (AccessibleEvents::SelectionAdd) or
// false (AccessibleEvents::SelectionRemove).
chart->AccessibilityNotifyClients( selected ? AccessibleEvents::SelectionAdd : AccessibleEvents::SelectionRemove, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID );
}
}
// Gets or sets the location for the curve legend.
public Point Location
{
get {
return location;
}
set {
location = value;
chart.Invalidate();
// Notifies the chart of the location change. This is used for
// the accessibility information. AccessibleEvents.LocationChange
// tells the chart the reason for the notification.
chart.AccessibilityNotifyClients(AccessibleEvents.LocationChange,
((CurveLegendAccessibleObject)AccessibilityObject).ID);
}
}
// Gets or sets the Name for the curve legend.
public string Name
{
get {
return name;
}
set {
if (name != value)
{
name = value;
chart.Invalidate();
// Notifies the chart of the name change. This is used for
// the accessibility information. AccessibleEvents.NameChange
// tells the chart the reason for the notification.
chart.AccessibilityNotifyClients(AccessibleEvents.NameChange,
((CurveLegendAccessibleObject)AccessibilityObject).ID);
}
}
}
// Gets or sets the Selected state for the curve legend.
public bool Selected
{
get {
return selected;
}
set {
if (selected != value)
{
selected = value;
chart.Invalidate();
// Notifies the chart of the selection value change. This is used for
// the accessibility information. The AccessibleEvents value depends upon
// if the selection is true (AccessibleEvents.SelectionAdd) or
// false (AccessibleEvents.SelectionRemove).
chart.AccessibilityNotifyClients(
selected ? AccessibleEvents.SelectionAdd : AccessibleEvents.SelectionRemove,
((CurveLegendAccessibleObject)AccessibilityObject).ID);
}
}
}
' Gets or sets the location for the curve legend.
Public Property Location() As Point
Get
Return m_location
End Get
Set
m_location = value
chart.Invalidate()
' Notifies the chart of the location change. This is used for
' the accessibility information. AccessibleEvents.LocationChange
' tells the chart the reason for the notification.
chart.ExposeAccessibilityNotifyClients(AccessibleEvents.LocationChange, _
CType(AccessibilityObject, CurveLegendAccessibleObject).ID)
End Set
End Property
' Gets or sets the Name for the curve legend.
Public Property Name() As String
Get
Return m_name
End Get
Set
If m_name <> value Then
m_name = value
chart.Invalidate()
' Notifies the chart of the name change. This is used for
' the accessibility information. AccessibleEvents.NameChange
' tells the chart the reason for the notification.
chart.ExposeAccessibilityNotifyClients(AccessibleEvents.NameChange, _
CType(AccessibilityObject, CurveLegendAccessibleObject).ID)
End If
End Set
End Property
' Gets or sets the Selected state for the curve legend.
Public Property Selected() As Boolean
Get
Return m_selected
End Get
Set
If m_selected <> value Then
m_selected = value
chart.Invalidate()
' Notifies the chart of the selection value change. This is used for
' the accessibility information. The AccessibleEvents value varies
' on whether the selection is true (AccessibleEvents.SelectionAdd) or
' false (AccessibleEvents.SelectionRemove).
If m_selected Then
chart.ExposeAccessibilityNotifyClients(AccessibleEvents.SelectionAdd, _
CType(AccessibilityObject, CurveLegendAccessibleObject).ID)
Else
chart.ExposeAccessibilityNotifyClients(AccessibleEvents.SelectionRemove, _
CType(AccessibilityObject, CurveLegendAccessibleObject).ID)
End If
End If
End Set
End Property
Commenti
Le applicazioni del sistema operativo e del server di accessibilità generano eventi di accessibilità in risposta alle modifiche apportate all'interfaccia utente.
Questa enumerazione viene usata da AccessibleObject e Control.
Per altre informazioni, vedere Accessibilità attiva Microsoft.