Sdílet prostřednictvím


AccessibleEvents Výčet

Definice

Určuje události, které jsou hlášeny aplikacemi s podporou přístupnosti.

public enum class AccessibleEvents
public enum AccessibleEvents
type AccessibleEvents = 
Public Enum AccessibleEvents
Dědičnost
AccessibleEvents

Pole

AcceleratorChange 32786

Vlastnost objektu se změnila KeyboardShortcut . Serverové aplikace odesílají událost pro své přístupné objekty.

Create 32768

Objekt byl vytvořen. Operační systém odesílá událost pro následující prvky uživatelského rozhraní: kurzor, ovládací prvek záhlaví, ovládací prvek zobrazení seznamu, ovládací prvek tabulátoru, ovládací prvek panelu nástrojů, ovládací prvek stromového zobrazení a objekt okna. Serverové aplikace odesílají tuto událost pro své přístupné objekty. Servery musí tuto událost odeslat pro všechny podřízené objekty objektu před odesláním události nadřazeného objektu. Servery musí zajistit, aby všechny podřízené objekty byly plně vytvořeny a připraveny přijímat volání od klientů, když nadřazený objekt odešle událost.

DefaultActionChange 32785

Vlastnost objektu se změnila DefaultAction . Systém odešle tuto událost pro dialogová okna. Serverové aplikace odesílají tuto událost pro své přístupné objekty. Proto serverové aplikace nemusí odesílat tuto událost pro podřízené objekty. Skryté objekty mají stav Invisiblea zobrazené objekty ne. Události typu AccessibleEvents.Hide označují, že Invisible byl stav nastaven. Proto servery nemusí v tomto případě odesílat AccessibleEvents.StateChange událost.

DescriptionChange 32781

Vlastnost objektu se změnila Description . Serverové aplikace odesílají tuto událost pro své přístupné objekty.

Destroy 32769

Objekt byl zničen. Systém odesílá tuto událost pro následující prvky uživatelského rozhraní: kurzor, ovládací prvek záhlaví, ovládací prvek zobrazení seznamu, ovládací prvek tabulátoru, ovládací prvek panelu nástrojů, ovládací prvek stromového zobrazení a objekt okna. Serverové aplikace odesílají tuto událost pro své přístupné objekty. Tato událost může nebo nemusí být odeslána pro podřízené objekty. Klienti však mohou dojít k závěru, že všechny podřízené objekty byly zničeny, když nadřazený objekt odešle tuto událost.

Focus 32773

Objekt obdržel fokus klávesnice. Systém odesílá tuto událost pro následující prvky uživatelského rozhraní: ovládací prvek zobrazení seznamu, řádek nabídek, místní nabídka, okno přepínače, ovládací prvek tabulátoru, ovládací prvek stromového zobrazení a objekt okna. Serverové aplikace odesílají tuto událost pro své přístupné objekty.

HelpChange 32784

Vlastnost objektu se změnila Help . Serverové aplikace odesílají tuto událost pro své přístupné objekty.

Hide 32771

Objekt je skrytý. Systém odešle událost pro následující prvky uživatelského rozhraní: kurzor a kurzor. Serverové aplikace odesílají událost pro své přístupné objekty. Při generování události pro nadřazený objekt jsou již všechny podřízené objekty skryté. Serverové aplikace proto nemusí odesílat událost pro podřízené objekty. Systém neodesílá událost konzistentně.

LocationChange 32779

U objektu se změnilo umístění, tvar nebo velikost. Systém odešle tuto událost pro následující prvky uživatelského rozhraní: kurzor a objekt okna. Serverové aplikace odesílají tuto událost pro své přístupné objekty. Tato událost je generována v reakci na objekt nejvyšší úrovně v hierarchii objektů, který se změnil, ne pro podřízené položky, které by mohly obsahovat. Pokud například uživatel změní velikost okna, systém odešle toto oznámení pro toto okno, ale ne pro řádek nabídek, záhlaví, posuvníky nebo jiné objekty, které se také změnily. Systém tuto událost neodesílá pro každé podřízené okno, které není plovoucí, když se nadřazené okno přesune. Pokud však aplikace explicitně změní velikost podřízených oken v důsledku změny velikosti, systém odešle více událostí pro podřízené objekty se změněnou velikostí. Pokud je vlastnost objektu State nastavená na Floating, servery by měly při každé změně umístění objektu odeslat událost změny umístění. Pokud objekt nemá tento stav, měly by servery vyvolat tuto událost, když se objekt přesune vzhledem k nadřazené hodnotě.

NameChange 32780

Vlastnost objektu se změnila Name . Systém odesílá tuto událost pro následující prvky uživatelského rozhraní: zaškrtávací políčko, kurzor, ovládací prvek zobrazení seznamu, tlačítko, přepínač, ovládací prvek stavového řádku, ovládací prvek stromového zobrazení a objekt okna. Serverové aplikace odesílají tuto událost pro své přístupné objekty.

ParentChange 32783

Objekt má nový nadřazený objekt. Serverové aplikace odesílají tuto událost pro své přístupné objekty.

Reorder 32772

Objekt kontejneru přidal, odebral nebo změnil pořadí svých podřízených položek. Systém odešle tuto událost pro následující prvky uživatelského rozhraní: ovládací prvek záhlaví, ovládací prvek zobrazení seznamu, ovládací prvek panelu nástrojů a objekt okna. Serverové aplikace odesílají tuto událost podle potřeby pro své přístupné objekty. Tato událost je také odeslána nadřazeným oknem, když se změní pořadí z pro podřízená okna.

Selection 32774

Byl vybrán přístupný objekt v rámci objektu kontejneru. Tato událost signalizuje jeden výběr. Buď bylo vybráno podřízené položky v kontejneru, který dříve neobsahoval žádné vybrané podřízené položky, nebo se výběr změnil z jednoho podřízeného objektu na jiný.

SelectionAdd 32775

Do výběru byla přidána položka v rámci objektu kontejneru. Systém odešle tuto událost pro následující prvky uživatelského rozhraní: seznam, ovládací prvek zobrazení seznamu a ovládací prvek stromového zobrazení. Serverové aplikace odesílají tuto událost pro své přístupné objekty. Tato událost signalizuje přidání podřízeného objektu do existujícího výběru.

SelectionRemove 32776

Položka v objektu kontejneru byla z výběru odebrána. Systém odešle tuto událost pro následující prvky uživatelského rozhraní: seznam, ovládací prvek zobrazení seznamu a ovládací prvek stromového zobrazení. Serverové aplikace odesílají tuto událost pro své přístupné objekty. Tato událost signalizuje, že podřízený objekt byl odebrán z existujícího výběru.

SelectionWithin 32777

V objektu kontejneru došlo k mnoha změnám výběru. Systém odešle tuto událost pro seznamy. Serverové aplikace odesílají tuto událost pro své přístupné objekty. Tuto událost lze odeslat, pokud se vybrané položky v ovládacím prvku podstatně změnily. Tato událost informuje klienta, že došlo k mnoha změnám výběru. To je vhodnější než odeslání několika SelectionAdd událostí nebo SelectionRemove událostí.

Show 32770

Zobrazuje se skrytý objekt. Systém odešle tuto událost pro následující prvky uživatelského rozhraní: kurzor, kurzor a objekt okna. Serverové aplikace odesílají tuto událost pro své přístupné objekty. Klienti mohou dojít k závěru, že když je tato událost odeslána nadřazeným objektem, všechny podřízené objekty již byly zobrazeny. Proto serverové aplikace nemusí odesílat tuto událost pro podřízené objekty.

StateChange 32778

Stav objektu se změnil. Systém odešle událost pro následující prvky uživatelského rozhraní: zaškrtávací políčko, pole se seznamem, ovládací prvek záhlaví, tlačítko, přepínač, posuvník, ovládací prvek panelu nástrojů, ovládací prvek stromového zobrazení, ovládací prvek nahoru-dolů a objekt okna. Serverové aplikace odesílají událost pro své přístupné objekty. Ke změně stavu může dojít například při stisknutí nebo uvolnění objektu tlačítka nebo při povolení nebo zakázání objektu. Systém neodesílá událost konzistentně.

SystemAlert 2

Vygenerovalo se upozornění. Serverové aplikace tuto událost odesílají vždy, když dojde k důležité změně uživatelského rozhraní, o které může uživatel potřebovat vědět. Systém neodesílá událost konzistentně pro objekty dialogového okna.

SystemCaptureEnd 9

Okno ztratilo zachytávání myší. Systém odešle událost; servery nikdy neodesílají tuto událost.

SystemCaptureStart 8

Přesouvá se nebo mění velikost okna. Systém odešle událost; servery nikdy neodesílají tuto událost.

SystemContextHelpEnd 13

Okno ukončilo režim kontextové nápovědy. Systém neodesílá událost konzistentně.

SystemContextHelpStart 12

Okno přešlo do režimu kontextové nápovědy. Systém neodesílá událost konzistentně.

SystemDialogEnd 17

Dialogové okno bylo zavřené. Systém neodesílá událost pro standardní dialogová okna. Servery odesílají tuto událost pro vlastní dialogová okna. Systém neodesílá událost konzistentně.

SystemDialogStart 16

Zobrazilo se dialogové okno. Systém odešle událost pro standardní dialogová okna. Servery odesílají tuto událost pro vlastní dialogová okna. Systém neodesílá událost konzistentně.

SystemDragDropEnd 15

Aplikace se chystá ukončit režim přetahování. Aplikace, které podporují operace přetažení, musí odeslat tuto událost; systém ne.

SystemDragDropStart 14

Aplikace se chystá přejít do režimu přetahování. Aplikace, které podporují operace přetažení, musí odeslat tuto událost; systém ne.

SystemForeground 3

Okno popředí se změnilo. Systém odešle tuto událost i v případě, že se okno popředí změní na jiné okno ve stejném vlákně. Serverové aplikace nikdy neodesílají tuto událost.

SystemMenuEnd 5

Nabídka z řádku nabídek se zavřela. Systém odesílá tuto událost pro standardní nabídky. Servery odesílají tuto událost pro vlastní nabídky.

SystemMenuPopupEnd 7

Místní nabídka se zavřela. Systém odesílá tuto událost pro standardní nabídky. Servery odesílají tuto událost pro vlastní nabídky. Když se místní nabídka zavře, klient obdrží tuto zprávu, za kterou SystemMenuEnd téměř okamžitě následuje událost. Systém neodesílá událost konzistentně.

V případě volání se klientovi TrackPopupMenu()téměř okamžitě EVENT_SYSTEM_MENUPOPUPSTART zobrazí EVENT_SYSTEM_MENUSTART automaticky otevírané okno.

SystemMenuPopupStart 6

Zobrazila se místní nabídka. Systém odesílá tuto událost pro standardní nabídky. Servery odesílají tuto událost pro vlastní nabídky. Systém neodesílá událost konzistentně.

V případě volání se klientovi TrackPopupMenu()téměř okamžitě EVENT_SYSTEM_MENUPOPUPSTART zobrazí EVENT_SYSTEM_MENUSTART automaticky otevírané okno.

SystemMenuStart 4

Byla vybrána položka nabídky na řádku nabídek. Systém odesílá tuto událost pro standardní nabídky. Servery odesílají tuto událost pro vlastní nabídky. Systém může vyvolat více než jednu MenuStart událost, která může nebo nemusí mít odpovídající MenuEnd událost.

SystemMinimizeEnd 23

Objekt okna byl minimalizován nebo maximalizován. Systém odešle událost; servery tuto událost nikdy neodesílají.

SystemMinimizeStart 22

Objekt okna se má minimalizovat nebo maximalizovat. Systém odešle událost; servery tuto událost nikdy neodesílají.

SystemMoveSizeEnd 11

Přesunutí nebo změna velikosti okna je dokončena. Systém odešle událost; servery tuto událost nikdy neodesílají.

SystemMoveSizeStart 10

Probíhá přesouvání nebo změna velikosti okna. Systém odešle událost; servery tuto událost nikdy neodesílají.

SystemScrollingEnd 19

Posouvání skončilo na posuvníku. Systém odešle tuto událost pro posuvníky připojené k oknem a pro standardní ovládací prvky posuvníku. Servery odesílají tuto událost pro vlastní posuvníky.

SystemScrollingStart 18

Na posuvníku bylo zahájeno posouvání. Systém odešle událost pro posuvníky připojené k oknem a pro standardní ovládací prvky posuvníku. Servery odesílají tuto událost pro vlastní posuvníky.

SystemSound 1

Přehrál se zvuk. Systém tuto událost odešle, když se přehraje systémový zvuk, například u nabídek, i když zvuk není slyšitelný. Příčinou může být nedostatek zvukového souboru nebo zvukové karty. Servery odesílají tuto událost, pokud vlastní prvek uživatelského rozhraní generuje zvuk.

SystemSwitchEnd 21

Uživatel vydal kombinaci kláves ALT+TAB. Systém odešle událost. SwitchEnd Servery tuto událost nikdy neodesílají. Pokud je při stisknutí kombinace kláves ALT+TAB spuštěna pouze jedna aplikace, systém odešle SwitchEnd událost bez odpovídající SwitchStart události.

SystemSwitchStart 20

Uživatel stiskl kombinaci kláves ALT+TAB, čímž se aktivuje okno přepínače. Pokud je při stisknutí kombinace kláves ALT+TAB spuštěna pouze jedna aplikace, systém vyvolá SwitchEnd událost bez odpovídající SwitchStart události.

ValueChange 32782

Vlastnost objektu se změnila Value . Systém vyvolá ValueChange událost pro následující prvky uživatelského rozhraní: edit control, header control, hot key control, progress bar, scroll bar, slider control, and up-down control. Serverové aplikace odesílají tuto událost pro své přístupné objekty.

Příklady

Následující příklad kódu ukazuje vytvoření ovládacího prvku grafu podporujícího přístupnost pomocí AccessibleObject tříd a Control.ControlAccessibleObject k zveřejnění přístupných informací. Ovládací prvek vykresluje dvě křivky spolu s legendou. Třída ChartControlAccessibleObject , která je odvozena z ControlAccessibleObject, se používá v CreateAccessibilityInstance metodě k poskytování vlastních přístupných informací pro ovládací prvek grafu. Vzhledem k tomu, že legenda grafu není skutečný Control ovládací prvek, ale místo toho je kreslen ovládacím prvek grafu, neobsahuje žádné předdefinované přístupné informace. Z tohoto ChartControlAccessibleObject důvodu třída přepíše metodu GetChild , aby vrátila CurveLegendAccessibleObject informace, které představují přístupné informace pro každou část legendy. Pokud aplikace s podporou přístupnosti používá tento ovládací prvek, může tento ovládací prvek poskytnout potřebné přístupné informace.

Tento příklad ukazuje použití výčtu AccessibleEvents s metodou AccessibilityNotifyClients . Kompletní příklad kódu najdete v AccessibleObject přehledu třídy.

   // 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

Poznámky

Operační systém a serverové aplikace pro usnadnění přístupu generují události přístupnosti v reakci na změny v uživatelském rozhraní.

Tento výčet používají AccessibleObject a Control.

Další informace najdete v tématu Microsoft aktivní přístupnosti.

Platí pro

Viz také