AccessibleEvents Výčet
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Určuje události, které jsou hlášeny aplikacemi s podporou přístupnosti.
public enum class AccessibleEventspublic enum AccessibleEventstype AccessibleEvents = Public Enum AccessibleEvents- Dědičnost
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 |
| 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 |
| 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 V případě volání se klientovi |
| 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 |
| 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 |
| 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. |
| 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á |
| ValueChange | 32782 | Vlastnost objektu se změnila Value . Systém vyvolá |
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.
