AccessibleEvents Výčet

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

AccessibleEvents.cs

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

Object

ValueType

Enum

AccessibleEvents

Pole

Name	Hodnota	Description
SystemSound	1	Byl přehrával zvuk. Systém odešle tuto událost, když se přehraje systémový zvuk, například pro menu, i když žádný zvuk není slyšet. 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í vygeneruje zvuk.
SystemAlert	2	Vygenerovala se výstraha. Serverové aplikace odesílají tuto událost vždy, když došlo ke změně důležitého 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.
SystemForeground	3	Okno popředí se změnilo. Systém odešle tuto událost, i když je okno popředí změněno na jiné okno ve stejném vlákně. Serverové aplikace nikdy neodesílají tuto událost.
SystemMenuStart	4	Byla vybrána položka nabídky na řádku nabídek. Systém odešle 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.
SystemMenuEnd	5	Nabídka z řádku nabídek byla uzavřena. Systém odešle tuto událost pro standardní nabídky. Servery odesílají tuto událost pro vlastní nabídky.
SystemMenuPopupStart	6	Zobrazila se místní nabídka. Systém odešle tuto událost pro standardní nabídky. Servery odesílají tuto událost pro vlastní nabídky. Systém událost neodesílá konzistentně. V případě volání TrackPopupMenu()se klient zobrazí EVENT_SYSTEM_MENUSTART téměř okamžitě a zobrazí EVENT_SYSTEM_MENUPOPUPSTART se automaticky otevírané okno.
SystemMenuPopupEnd	7	Místní nabídka se zavřela. Systém odešle tuto událost pro standardní nabídky. Servery odesílají tuto událost pro vlastní nabídky. Když je místní nabídka zavřená, klient obdrží tuto zprávu téměř okamžitě za událostí SystemMenuEnd . Systém událost neodesílá konzistentně. V případě volání TrackPopupMenu()se klient zobrazí EVENT_SYSTEM_MENUSTART téměř okamžitě a zobrazí EVENT_SYSTEM_MENUPOPUPSTART se automaticky otevírané okno.
SystemCaptureStart	8	Okno se přesouvá nebo mění jeho velikost. Systém odešle událost; servery nikdy neodesílají tuto událost.
SystemCaptureEnd	9	Okno ztratilo zachycení myši. Systém odešle událost; servery nikdy neodesílají tuto událost.
SystemMoveSizeStart	10	Okno se přesouvá nebo mění jeho velikost. Systém odešle událost; servery nikdy neodesílají tuto událost.
SystemMoveSizeEnd	11	Přesun nebo změna velikosti okna je dokončena. Systém odešle událost; servery nikdy neodesílají tuto událost.
SystemContextHelpStart	12	V okně byl zadán kontextový režim nápovědy. Systém událost neodesílá konzistentně.
SystemContextHelpEnd	13	Režim nápovědy, který je citlivý na kontext, zavřel okno. Systém událost neodesílá konzistentně.
SystemDragDropStart	14	Aplikace se chystá přejít do režimu přetažení. Aplikace, které podporují operace přetažení myší, musí tuto událost odeslat; systém ne.
SystemDragDropEnd	15	Aplikace se chystá ukončit režim přetažení. Aplikace, které podporují operace přetažení myší, musí tuto událost odeslat; systém ne.
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 událost neodesílá 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 událost neodesílá konzistentně.
SystemScrollingStart	18	Posouvání se spustilo na posuvníku. 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.
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.
SystemSwitchStart	20	Uživatel stiskl kombinaci kláves ALT+TAB, který aktivuje okno přepínače. Pokud je spuštěná pouze jedna aplikace, když uživatel stiskne kombinaci kláves ALT+TAB, systém vyvolá SwitchEnd událost bez odpovídající SwitchStart události.
SystemSwitchEnd	21	Uživatel vydal ALT+TAB. Systém událost odešle SwitchEnd . Servery tuto událost nikdy neodesílají. Pokud je spuštěná jenom jedna aplikace, když uživatel stiskne kombinaci kláves ALT+TAB, odešle systém SwitchEnd událost bez odpovídající SwitchStart události.
SystemMinimizeStart	22	Objekt okna se chystá minimalizovat nebo maximalizovat. Systém odešle událost; servery nikdy neodesílají tuto událost.
SystemMinimizeEnd	23	Objekt okna byl minimalizován nebo maximalizován. Systém odešle událost; servery nikdy neodesílají tuto událost.
Create	32768	Byl vytvořen objekt. Operační systém odešle událost pro následující prvky uživatelského rozhraní: stříška, ovládací prvek záhlaví, ovládací prvek zobrazení seznamu, ovládací prvek karty, 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 byly všechny podřízené objekty plně vytvořeny a připraveny přijímat volání od klientů, když nadřazený objekt odešle událost.
Destroy	32769	Objekt byl zničen. Systém odešle tuto událost pro následující prvky uživatelského rozhraní: stříška, ovládací prvek záhlaví, ovládací prvek zobrazení seznamu, ovládací prvek karty, 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.
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. Serverové aplikace proto nemusí odesílat tuto událost pro podřízené 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 jejich přístupné objekty. Když je událost vygenerována pro nadřazený objekt, všechny podřízené objekty již byly skryty. Serverové aplikace proto nemusí odesílat událost podřízených objektů. Systém událost neodesílá konzistentně.
Reorder	32772	Objekt kontejneru přidal, odebral nebo změnil pořadí podřízených položek. Systém odešle tuto událost pro následující prvky uživatelského rozhraní: header control, list view control, toolbar control, window object. Serverové aplikace odesílají tuto událost podle potřeby pro jejich přístupné objekty. Tato událost se odešle také nadřazeným oknem, když se změní pořadí vykreslování podřízených oken.
Focus	32773	Objekt obdržel fokus klávesnice. Systém odešle tuto událost pro následující prvky uživatelského rozhraní: list view control, menu bar, shortcut menu, switch window, tab control, tree view control, and window object. Serverové aplikace odesílají tuto událost pro své přístupné objekty.
Selection	32774	Byl vybrán přístupný objekt v rámci objektu kontejneru. Tato událost signalizuje jeden výběr. V kontejneru, který dříve neobsahoval žádné vybrané podřízené položky, byla vybrána podřízená položka nebo se výběr změnil z jednoho podřízeného objektu na druhý.
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, že podřízená položka byla přidána do existujícího výběru.
SelectionRemove	32776	Z výběru byla odebrá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, že podřízená položka byla odebrána 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 seznamová pole. Serverové aplikace odesílají tuto událost pro své přístupné objekty. Tuto událost lze odeslat, když 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ší pro odesílání několika SelectionAdd nebo SelectionRemove událostí.
StateChange	32778	Změnil se stav objektu. 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 push, 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 jejich přístupné objekty. Ke změně stavu může dojít například v případě, že byl objekt tlačítka stisknut nebo uvolněn nebo když je objekt povolený nebo zakázaný. Systém událost neodesílá konzistentně.
LocationChange	32779	Objekt změnil umístění, obrazec nebo velikost. Systém odešle tuto událost pro následující prvky uživatelského rozhraní: stříšku a objekt okna. Serverové aplikace odesílají tuto událost pro své přístupné objekty. Tato událost se vygeneruje v reakci na objekt nejvyšší úrovně v hierarchii objektů, který se změnil, ne pro žádné podřízené objekty, které by mohly obsahovat. Pokud například uživatel změní velikost okna, systém odešle toto oznámení pro 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é ne plovoucí podřízené okno, když se nadřazený objekt přesune. Pokud ale aplikace v důsledku změny velikosti explicitně změní velikost podřízených oken, systém odešle více událostí pro změněné podřízené položky. Pokud je vlastnost objektu State nastavena na Floating, servery by měly odeslat událost změny umístění pokaždé, když objekt změní umístění. Pokud objekt tento stav nemá, servery by tuto událost měly vyvolat, když se objekt přesune vzhledem k nadřazené objektu.
NameChange	32780	Vlastnost objektu Name se změnila. Systém odešle 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 push, 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.
DescriptionChange	32781	Vlastnost objektu Description se změnila. Serverové aplikace odesílají tuto událost pro své přístupné objekty.
ValueChange	32782	Vlastnost objektu Value se změnila. Systém vyvolá ValueChange událost pro následující prvky uživatelského rozhraní: edit control, header control, hot key control, progress bar control, scroll bar, slider control, and up-down control. 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.
HelpChange	32784	Vlastnost objektu Help se změnila. Serverové aplikace odesílají tuto událost pro své přístupné objekty.
DefaultActionChange	32785	Vlastnost objektu DefaultAction se změnila. Systém odešle tuto událost pro dialogová okna. Serverové aplikace odesílají tuto událost pro své přístupné objekty. Serverové aplikace proto 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 je nastavený stav Invisible . Servery proto nemusí v tomto případě odesílat AccessibleEvents.StateChange událost.
AcceleratorChange	32786	Vlastnost objektu KeyboardShortcut se změnila. Serverové aplikace odesílají událost pro jejich přístupné objekty.

Příklady

Následující příklad kódu ukazuje vytvoření ovládacího prvku grafu s podporou přístupnosti pomocí AccessibleObject a Control.ControlAccessibleObject tříd k zveřejnění přístupných informací. Ovládací prvek vykreslují dvě křivky spolu s legendou. Třída ChartControlAccessibleObject , která je odvozena z ControlAccessibleObject, je použita v CreateAccessibilityInstance metodě k poskytnutí vlastních přístupných informací pro ovládací prvek grafu. Vzhledem k tomu, že legenda grafu není skutečný Control ovládací prvek -based, ale je vykreslen ovládacím prvkům grafu, neobsahuje žádné předdefinované přístupné informace. Z tohoto důvodu třída přepíše metodu tak, ChartControlAccessibleObject aby vrátilaGetChild, která představuje přístupné informace pro každou část legendy.CurveLegendAccessibleObject Pokud aplikace s podporou přístupnosti používá tento ovládací prvek, může ovládací prvek poskytnout nezbytné přístupné informace.

Tento příklad ukazuje použití výčtu AccessibleEvents s metodou AccessibilityNotifyClients . Kompletní příklad kódu najdete v přehledu AccessibleObject 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

Serverové aplikace operačního systému a přístupnosti generují události přístupnosti v reakci na změny v uživatelském rozhraní.

Tento výčet je používán AccessibleObject a Control.

Další informace najdete v tématu MSAA (Microsoft Active Accessibility).

Viz také

• AccessibleNavigation
• AccessibleObject
• AccessibleRole
• AccessibleSelection
• AccessibleStates