AccessibleRole 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 hodnoty představující možné role pro přístupný objekt.
public enum class AccessibleRolepublic enum AccessibleRoletype AccessibleRole = Public Enum AccessibleRole- Dědičnost
Pole
| Name | Hodnota | Description |
|---|---|---|
| Default | -1 | Role poskytovaná systémem. |
| None | 0 | Žádná role. |
| TitleBar | 1 | Záhlaví nebo záhlaví okna |
| MenuBar | 2 | Řádek nabídek, obvykle pod záhlavím okna, ze kterého můžou uživatelé vybírat nabídky. |
| ScrollBar | 3 | Svislý nebo vodorovný posuvník, který může být součástí klientské oblasti nebo použit v ovládacím prvku. |
| Grip | 4 | Speciální ukazatel myši, který uživateli umožňuje manipulovat s prvky uživatelského rozhraní, jako je okno. Uživatel může například kliknout a přetáhnout úchyt pro změnu velikosti v pravém dolním rohu okna a změnit jeho velikost. |
| Sound | 5 | Systémový zvuk, který je spojený s různými systémovými událostmi. |
| Cursor | 6 | Ukazatel myši. |
| Caret | 7 | Kurzor, což je blikající čára, blok nebo rastrový obrázek, který označuje umístění kurzoru v klientské oblasti okna. |
| Alert | 8 | Výstraha nebo podmínka, o které můžete uživatele upozornit. Tuto roli použijte pouze pro objekty, které ztělesňují výstrahu, ale nejsou přidruženy k jinému prvku uživatelského rozhraní, jako je například pole se zprávou, grafika, text nebo zvuk. |
| Window | 9 | Rámeček okna, který obvykle obsahuje podřízené objekty, jako je záhlaví, klient a další objekty obvykle obsažené v okně. |
| Client | 10 | Uživatelská oblast okna. |
| MenuPopup | 11 | Nabídka, která zobrazuje seznam možností, ze kterých může uživatel provést nějakou akci. Všechny typy nabídek musí mít tuto roli, včetně rozevíracích nabídek zobrazených výběrem z řádku nabídek a místních nabídek, které se zobrazí po kliknutí pravým tlačítkem myši. |
| MenuItem | 12 | Položka nabídky, což je položka v nabídce, kterou může uživatel zvolit k provedení příkazu, výběru možnosti nebo zobrazení jiné nabídky. Položka nabídky může být funkčně ekvivalentní tlačítku, přepínači, zaškrtávacímu políčku nebo nabídce. |
| ToolTip | 13 | Popis tlačítka, což je malé obdélníkové automaticky otevírané okno s stručným popisem účelu tlačítka. |
| Application | 14 | Hlavní okno aplikace. |
| Document | 15 | Okno dokumentu, které je vždy obsaženo v okně aplikace. Tato role se vztahuje pouze na okna rozhraní MDI (multiple-document interface) a odkazuje na objekt, který obsahuje záhlaví MDI. |
| Pane | 16 | Samostatná oblast v rámci, rozdělené okno dokumentu nebo obdélníková oblast stavového řádku, která se dá použít k zobrazení informací. Uživatelé můžou přecházet mezi podokny a obsahem aktuálního podokna, ale nemůžou přecházet mezi položkami v různých podoknech. Podokna tedy představují úroveň seskupení nižší než okna rámečku nebo dokumentů, ale nad jednotlivými ovládacími prvky. Uživatel obvykle prochází mezi podokny stisknutím kláves TAB, F6 nebo CTRL+TAB v závislosti na kontextu. |
| Chart | 17 | Grafický obrázek, který se používá k reprezentaci dat. |
| Dialog | 18 | Dialogové okno nebo okno se zprávou |
| Border | 19 | Ohraničení okna. Celé ohraničení je reprezentováno jedním objektem, nikoli samostatnými objekty pro každou stranu. |
| Grouping | 20 | Objekty seskupené logickým způsobem. Mezi objektem seskupení a objekty, které obsahuje, může existovat vztah nadřazený-podřízený. |
| Separator | 21 | Prostor rozdělený vizuálně do dvou oblastí, jako je například položka nabídky oddělovače nebo oddělovač rozdělující příčky v okně. |
| ToolBar | 22 | Panel nástrojů, což je seskupení ovládacích prvků, které poskytují snadný přístup k často používaným funkcím. |
| StatusBar | 23 | Stavový řádek, což je oblast obvykle v dolní části okna aplikace, která zobrazuje informace o aktuální operaci, stavu aplikace nebo vybraném objektu. Stavový řádek může mít více polí, která zobrazují různé druhy informací, například vysvětlení aktuálně vybraného příkazu nabídky na stavovém řádku. |
| Table | 24 | Tabulka obsahující řádky a sloupce buněk a volitelně záhlaví řádků a záhlaví sloupců. |
| ColumnHeader | 25 | Záhlaví sloupce, které poskytuje vizuální popisek pro sloupec v tabulce. |
| RowHeader | 26 | Záhlaví řádku, které poskytuje vizuální popisek pro řádek tabulky. |
| Column | 27 | Sloupec buněk v tabulce |
| Row | 28 | Řádek buněk v tabulce |
| Cell | 29 | Buňka v tabulce |
| Link | 30 | Odkaz, což je propojení mezi zdrojovým dokumentem a cílovým dokumentem. Tento objekt může vypadat jako text nebo grafika, ale funguje jako tlačítko. |
| HelpBalloon | 31 | Zobrazení nápovědy ve formě bubliny popisku nebo nápovědy, která obsahuje tlačítka a popisky, na které můžou uživatelé kliknout a otevřít vlastní témata nápovědy. |
| Character | 32 | Kreslený grafický objekt, například Pomocník microsoft Office, který se obvykle zobrazuje, aby uživatelům aplikace pomohl. |
| List | 33 | Seznam, který uživateli umožňuje vybrat jednu nebo více položek. |
| ListItem | 34 | Položka v seznamu nebo části seznamu pole se seznamem, rozevíracího seznamu nebo rozevíracího seznamu. |
| Outline | 35 | Struktura osnovy nebo stromu, například ovládací prvek stromového zobrazení, který zobrazuje hierarchický seznam a obvykle umožňuje uživateli rozbalit a sbalit větve. |
| OutlineItem | 36 | Položka ve struktuře osnovy nebo stromu |
| PageTab | 37 | Stránka vlastností, která uživateli umožňuje zobrazit atributy stránky, jako je název stránky, ať už se jedná o domovskou stránku nebo jestli byla stránka změněna. Za normálních okolností je jediným podřízeným objektem tohoto ovládacího prvku seskupený objekt, který obsahuje obsah přidružené stránky. |
| PropertyPage | 38 | Stránka vlastností, což je dialogové okno, které řídí vzhled a chování objektu, například soubor nebo prostředek. Vzhled stránky vlastností se liší podle jeho účelu. |
| Indicator | 39 | Ukazatel, například obrázek ukazatele, který odkazuje na aktuální položku. |
| Graphic | 40 | Obrázek. |
| StaticText | 41 | Text jen pro čtení, například v popisku, pro jiné ovládací prvky nebo pokyny v dialogovém okně. Statický text nelze změnit ani vybrat. |
| Text | 42 | Vybratelný text, který lze upravit nebo jen pro čtení. |
| PushButton | 43 | Ovládací prvek stisknutým tlačítkem, což je malý obdélníkový ovládací prvek, který může uživatel zapnout nebo vypnout. Tlačítko stiskem, označované také jako příkazové tlačítko, má při zapnutém zapnutí vzhled ve výchozím vypnutém stavu a vzhled osvícené části. |
| CheckButton | 44 | Ovládací prvek zaškrtávacího políčka, což je možnost, která se dá zapnout nebo vypnout nezávisle na jiných možnostech. |
| RadioButton | 45 | Přepínač, označovaný také jako přepínač. Všechny objekty sdílející jeden nadřazený objekt, který má tento atribut, se předpokládá, že jsou součástí jedné vzájemně se vylučující skupiny. Seskupené objekty můžete použít k rozdělení přepínačů do samostatných skupin v případě potřeby. |
| ComboBox | 46 | Pole se seznamem, což je ovládací prvek pro úpravy s přidruženým seznamem, který poskytuje sadu předdefinovaných voleb. |
| DropList | 47 | Rozevírací seznam Tento ovládací prvek zobrazuje jednu položku a umožňuje uživateli zobrazit a vybrat jinou položku ze seznamu alternativních voleb. |
| ProgressBar | 48 | Indikátor průběhu, který označuje průběh zdlouhavé operace zobrazením barevných čar uvnitř vodorovného obdélníku. Délka čar vzhledem k délce obdélníku odpovídá procentu dokončené operace. Tento ovládací prvek nepřebírají uživatelský vstup. |
| Dial | 49 | Číselník nebo knoflík. Může se jednat také o objekt jen pro čtení, jako je rychloměr. |
| HotkeyField | 50 | Pole s klávesovou zkratkou, které uživateli umožňuje zadat kombinaci nebo posloupnost klávesových úhorů, které se mají použít jako klávesová zkratka, což uživatelům umožňuje rychle provést akci. Ovládací prvek klávesové zkratky zobrazí stisknutí kláves zadané uživatelem a zajistí, aby uživatel vybral platnou kombinaci kláves. |
| Slider | 51 | Ovládací prvek, který se někdy označuje jako trackbar, umožňuje uživateli upravit nastavení v zadaných přírůstcích mezi minimálními a maximálními hodnotami přesunutím posuvníku. Ovládací prvky hlasitosti v operačním systému Windows jsou ovládací prvky posuvníku. |
| SpinButton | 52 | Číselník, označovaný také jako ovládací prvek nahoru a dolů, který obsahuje dvojici tlačítek se šipkami. Uživatel klikne na tlačítka se šipkami myší a zvýší nebo sníží hodnotu. Ovládací prvek číselníku se nejčastěji používá u doprovodného ovládacího prvku označovaného jako okno kamaráda, kde se zobrazuje aktuální hodnota. |
| Diagram | 53 | Grafický obrázek, který se používá k diagramu dat. |
| Animation | 54 | Ovládací prvek animace, který obsahuje obsah, který se mění v průběhu času, například ovládací prvek, který zobrazuje řadu rastrových snímků, jako je film. Ovládací prvky animace se obvykle zobrazují při kopírování souborů nebo při provádění nějaké jiné časově náročné úlohy. |
| Equation | 55 | Matematická rovnice. |
| ButtonDropDown | 56 | Tlačítko, které rozbalí seznam položek. |
| ButtonMenu | 57 | Tlačítko, které rozbalí nabídku. |
| ButtonDropDownGrid | 58 | Tlačítko, které zahodí mřížku. |
| WhiteSpace | 59 | Prázdné místo mezi jinými objekty. |
| PageTabList | 60 | Kontejner ovládacích prvků karty stránky |
| Clock | 61 | Ovládací prvek, který zobrazuje čas. |
| SplitButton | 62 | Tlačítko panelu nástrojů s ikonou rozevíracího seznamu přímo vedle tlačítka |
| IpAddress | 63 | Ovládací prvek určený pro zadávání IP adres (Internet Protocol). |
| OutlineButton | 64 | Ovládací prvek, který prochází jako položka osnovy. |
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átilaCurveLegendAccessibleObject, která představuje přístupné informace pro každou část legendy.GetChild 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 AccessibleRoleRole s vlastností. Kompletní příklad kódu najdete v přehledu AccessibleObject třídy.
// Inner class ChartControlAccessibleObject represents accessible information associated with the ChartControl.
// The ChartControlAccessibleObject is returned in the ChartControl::CreateAccessibilityInstance .
ref class ChartControlAccessibleObject: public ControlAccessibleObject
{
private:
ChartControl^ chartControl;
public:
ChartControlAccessibleObject( ChartControl^ ctrl )
: ControlAccessibleObject( ctrl )
{
chartControl = ctrl;
}
property System::Windows::Forms::AccessibleRole Role
{
// Gets the role for the Chart. This is used by accessibility programs.
virtual System::Windows::Forms::AccessibleRole get() override
{
return ::AccessibleRole::Chart;
}
}
property AccessibleStates State
{
// Gets the state for the Chart. This is used by accessibility programs.
virtual AccessibleStates get() override
{
return AccessibleStates::ReadOnly;
}
}
// The CurveLegend objects are "child" controls in terms of accessibility so
// return the number of ChartLengend objects.
virtual int GetChildCount() override
{
return chartControl->Legends->Length;
}
// Gets the Accessibility object of the child CurveLegend idetified by index.
virtual AccessibleObject^ GetChild( int index ) override
{
if ( index >= 0 && index < chartControl->Legends->Length )
{
return chartControl->Legends[ index ]->AccessibilityObject;
}
return nullptr;
}
internal:
// Helper function that is used by the CurveLegend's accessibility object
// to navigate between sibiling controls. Specifically, this function is used in
// the CurveLegend::CurveLegendAccessibleObject.Navigate function.
AccessibleObject^ NavigateFromChild( CurveLegend::CurveLegendAccessibleObject^ child, AccessibleNavigation navdir )
{
switch ( navdir )
{
case AccessibleNavigation::Down:
case AccessibleNavigation::Next:
return GetChild( child->ID + 1 );
case AccessibleNavigation::Up:
case AccessibleNavigation::Previous:
return GetChild( child->ID - 1 );
}
return nullptr;
}
// Helper function that is used by the CurveLegend's accessibility object
// to select a specific CurveLegend control. Specifically, this function is used
// in the CurveLegend::CurveLegendAccessibleObject.Select function.
void SelectChild( CurveLegend::CurveLegendAccessibleObject^ child, AccessibleSelection selection )
{
int childID = child->ID;
// Determine which selection action should occur, based on the
// AccessibleSelection value.
if ( (selection & AccessibleSelection::TakeSelection) != (AccessibleSelection)0 )
{
for ( int i = 0; i < chartControl->Legends->Length; i++ )
{
if ( i == childID )
{
chartControl->Legends[ i ]->Selected = true;
}
else
{
chartControl->Legends[ i ]->Selected = false;
}
}
// AccessibleSelection->AddSelection means that the CurveLegend will be selected.
if ( (selection & AccessibleSelection::AddSelection) != (AccessibleSelection)0 )
{
chartControl->Legends[ childID ]->Selected = true;
}
// AccessibleSelection->AddSelection means that the CurveLegend will be unselected.
if ( (selection & AccessibleSelection::RemoveSelection) != (AccessibleSelection)0 )
{
chartControl->Legends[ childID ]->Selected = false;
}
}
}
};
// class ChartControlAccessibleObject
// Inner class ChartControlAccessibleObject represents accessible information associated with the ChartControl.
// The ChartControlAccessibleObject is returned in the ChartControl.CreateAccessibilityInstance override.
public class ChartControlAccessibleObject : ControlAccessibleObject
{
ChartControl chartControl;
public ChartControlAccessibleObject(ChartControl ctrl) : base(ctrl)
{
chartControl = ctrl;
}
// Gets the role for the Chart. This is used by accessibility programs.
public override AccessibleRole Role
{
get {
return AccessibleRole.Chart;
}
}
// Gets the state for the Chart. This is used by accessibility programs.
public override AccessibleStates State
{
get {
return AccessibleStates.ReadOnly;
}
}
// The CurveLegend objects are "child" controls in terms of accessibility so
// return the number of ChartLengend objects.
public override int GetChildCount()
{
return chartControl.Legends.Length;
}
// Gets the Accessibility object of the child CurveLegend idetified by index.
public override AccessibleObject GetChild(int index)
{
if (index >= 0 && index < chartControl.Legends.Length) {
return chartControl.Legends[index].AccessibilityObject;
}
return null;
}
// Helper function that is used by the CurveLegend's accessibility object
// to navigate between sibiling controls. Specifically, this function is used in
// the CurveLegend.CurveLegendAccessibleObject.Navigate function.
internal AccessibleObject NavigateFromChild(CurveLegend.CurveLegendAccessibleObject child,
AccessibleNavigation navdir)
{
switch(navdir) {
case AccessibleNavigation.Down:
case AccessibleNavigation.Next:
return GetChild(child.ID + 1);
case AccessibleNavigation.Up:
case AccessibleNavigation.Previous:
return GetChild(child.ID - 1);
}
return null;
}
// Helper function that is used by the CurveLegend's accessibility object
// to select a specific CurveLegend control. Specifically, this function is used
// in the CurveLegend.CurveLegendAccessibleObject.Select function.
internal void SelectChild(CurveLegend.CurveLegendAccessibleObject child, AccessibleSelection selection)
{
int childID = child.ID;
// Determine which selection action should occur, based on the
// AccessibleSelection value.
if ((selection & AccessibleSelection.TakeSelection) != 0) {
for(int i = 0; i < chartControl.Legends.Length; i++) {
if (i == childID) {
chartControl.Legends[i].Selected = true;
} else {
chartControl.Legends[i].Selected = false;
}
}
// AccessibleSelection.AddSelection means that the CurveLegend will be selected.
if ((selection & AccessibleSelection.AddSelection) != 0) {
chartControl.Legends[childID].Selected = true;
}
// AccessibleSelection.AddSelection means that the CurveLegend will be unselected.
if ((selection & AccessibleSelection.RemoveSelection) != 0) {
chartControl.Legends[childID].Selected = false;
}
}
}
}
' Inner Class ChartControlAccessibleObject represents accessible information
' associated with the ChartControl.
' The ChartControlAccessibleObject is returned in the ' ChartControl.CreateAccessibilityInstance override.
Public Class ChartControlAccessibleObject
Inherits Control.ControlAccessibleObject
Private chartControl As ChartControl
Public Sub New(ctrl As ChartControl)
MyBase.New(ctrl)
chartControl = ctrl
End Sub
' Get the role for the Chart. This is used by accessibility programs.
Public Overrides ReadOnly Property Role() As AccessibleRole
Get
Return System.Windows.Forms.AccessibleRole.Chart
End Get
End Property
' Get the state for the Chart. This is used by accessibility programs.
Public Overrides ReadOnly Property State() As AccessibleStates
Get
Return AccessibleStates.ReadOnly
End Get
End Property
' The CurveLegend objects are "child" controls in terms of accessibility so
' return the number of ChartLengend objects.
Public Overrides Function GetChildCount() As Integer
Return chartControl.Legends.Length
End Function
' Get the Accessibility object of the child CurveLegend idetified by index.
Public Overrides Function GetChild(index As Integer) As AccessibleObject
If index >= 0 And index < chartControl.Legends.Length Then
Return chartControl.Legends(index).AccessibilityObject
End If
Return Nothing
End Function
' Helper function that is used by the CurveLegend's accessibility object
' to navigate between sibiling controls. Specifically, this function is used in
' the CurveLegend.CurveLegendAccessibleObject.Navigate function.
Friend Function NavigateFromChild(child As CurveLegend.CurveLegendAccessibleObject, _
navdir As AccessibleNavigation) As AccessibleObject
Select Case navdir
Case AccessibleNavigation.Down, AccessibleNavigation.Next
Return GetChild(child.ID + 1)
Case AccessibleNavigation.Up, AccessibleNavigation.Previous
Return GetChild(child.ID - 1)
End Select
Return Nothing
End Function
' Helper function that is used by the CurveLegend's accessibility object
' to select a specific CurveLegend control. Specifically, this function is used
' in the CurveLegend.CurveLegendAccessibleObject.Select function.
Friend Sub SelectChild(child As CurveLegend.CurveLegendAccessibleObject, selection As AccessibleSelection)
Dim childID As Integer = child.ID
' Determine which selection action should occur, based on the
' AccessibleSelection value.
If (selection And AccessibleSelection.TakeSelection) <> 0 Then
Dim i As Integer
For i = 0 To chartControl.Legends.Length - 1
If i = childID Then
chartControl.Legends(i).Selected = True
Else
chartControl.Legends(i).Selected = False
End If
Next i
' AccessibleSelection.AddSelection means that the CurveLegend will be selected.
If (selection And AccessibleSelection.AddSelection) <> 0 Then
chartControl.Legends(childID).Selected = True
End If
' AccessibleSelection.AddSelection means that the CurveLegend will be unselected.
If (selection And AccessibleSelection.RemoveSelection) <> 0 Then
chartControl.Legends(childID).Selected = False
End If
End If
End Sub
End Class
Poznámky
Role objektu popisuje funkci objektu a používá ji aplikace pro usnadnění přístupu.
Tento výčet používá AccessibleObject a Control.AccessibleRole
Další informace o aplikaci pro usnadnění přístupu najdete v knihovně Microsoft Developer Network (MSDN) "Microsoft Active Accessibility".
