AccessibleEvents Enumerazione

Definizione

Specifica gli eventi forniti dalle applicazioni accessibili.

public enum class AccessibleEvents
public enum AccessibleEvents
type AccessibleEvents = 
Public Enum AccessibleEvents
Ereditarietà
AccessibleEvents

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 AccessibleEvents.Hide indicano che è stato impostato lo stato Invisible. Non è pertanto necessario che i server inviino l'evento AccessibleEvents.StateChange.

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 SelectionAdd o SelectionRemove.

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 SystemMenuEnd. Questo evento non viene inviato dal sistema in modo coerente.

Per una chiamata a TrackPopupMenu(),un client verrà visualizzato seguito quasi immediatamente da EVENT_SYSTEM_MENUSTART per il popup EVENT_SYSTEM_MENUPOPUPSTART visualizzato.

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 TrackPopupMenu(),un client verrà visualizzato seguito quasi immediatamente da EVENT_SYSTEM_MENUSTART per il popup EVENT_SYSTEM_MENUPOPUPSTART visualizzato.

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 MenuStart ai quali possono essere associati o meno uno o più eventi MenuEnd.

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 SwitchEnd viene inviato dal sistema, ma non dai server. Se quando si preme la combinazione di tasti ALT+TAB è in esecuzione una singola applicazione, viene inviato l'evento SwitchEnd ma non l'evento SwitchStart corrispondente.

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 SwitchEnd ma non l'evento SwitchStart corrispondente.

ValueChange 32782

È stata modificata la proprietà Value di un oggetto. L'evento ValueChange viene generato dal sistema per i seguenti elementi dell'interfaccia utente: controllo di modifica, controllo intestazione, controllo tasto di scelta, controllo indicatore di stato, dispositivo di scorrimento e controllo di scorrimento, L'evento viene inviato dalle applicazioni server per i relativi oggetti accessibili.

Esempio

Nell'esempio di codice seguente viene illustrata la creazione di un controllo grafico in grado di riconoscere l'accessibilità, utilizzando le AccessibleObject classi e per esporre informazioni Control.ControlAccessibleObject accessibili. Il controllo traccia due curve insieme a una legenda. La classe , che deriva da , viene utilizzata nel metodo per fornire informazioni ChartControlAccessibleObject accessibili personalizzate per il controllo ControlAccessibleObject CreateAccessibilityInstance grafico. Poiché la legenda del grafico non è un controllo effettivo basato su , ma viene disegnata dal controllo grafico, non contiene informazioni Control accessibili incorporate. Per questo modo, la classe esegue l'override del metodo per restituire l'oggetto che rappresenta le informazioni ChartControlAccessibleObject accessibili per ogni parte della GetChild CurveLegendAccessibleObject legenda. Quando un'applicazione con informazioni accessibili usa questo controllo, il controllo può fornire le informazioni accessibili necessarie.

In questo esempio viene illustrato AccessibleEvents l'utilizzo dell'enumerazione con AccessibilityNotifyClients il metodo . Per AccessibleObject l'esempio di codice completo, vedere la panoramica della classe .

   // 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 nell'interfaccia utente.

Questa enumerazione viene utilizzata da AccessibleObject e Control .

Per altre informazioni, vedere Microsoft Active Accessibility.

Si applica a

Vedi anche