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 přístupného objektu.
public enum class AccessibleRolepublic enum AccessibleRoletype AccessibleRole = Public Enum AccessibleRole- Dědičnost
Pole
| Alert | 8 | Výstraha nebo podmínka, na kterou 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 okno se zprávou, grafika, text nebo zvuk. |
| Animation | 54 | Ovládací prvek animace, který obsahuje obsah, který se v průběhu času mění, například ovládací prvek, který zobrazuje řadu rastrových snímků, jako je filmový pás. Ovládací prvky animace se obvykle zobrazují při kopírování souborů nebo při provádění jiného časově náročného úkolu. |
| Application | 14 | Hlavní okno aplikace. |
| Border | 19 | Ohraničení okna Celé ohraničení je reprezentováno jedním objektem, nikoli samostatnými objekty pro každou stranu. |
| ButtonDropDown | 56 | Tlačítko, které zobrazí seznam položek. |
| ButtonDropDownGrid | 58 | Tlačítko, které přehodí mřížku. |
| ButtonMenu | 57 | Tlačítko, které rozsadí nabídku. |
| Caret | 7 | Stříšku, což je blikající čára, blok nebo rastrový obrázek, který označuje umístění kurzoru v klientské oblasti okna. |
| Cell | 29 | Buňka v tabulce |
| Character | 32 | Kreslený grafický objekt, například Microsoft Pomocník Office, který se obvykle zobrazuje jako pomoc uživatelům aplikace. |
| Chart | 17 | Grafický obrázek, který znázorňuje data. |
| CheckButton | 44 | Ovládací prvek zaškrtávacího políčka, což je možnost, kterou lze zapnout nebo vypnout nezávisle na jiných možnostech. |
| Client | 10 | Uživatelská oblast okna. |
| Clock | 61 | Ovládací prvek, který zobrazuje čas. |
| Column | 27 | Sloupec buněk v tabulce |
| ColumnHeader | 25 | Záhlaví sloupce, které poskytuje vizuální popisek sloupce v tabulce. |
| 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. |
| Cursor | 6 | Ukazatel myši. |
| Default | -1 | Role poskytovaná systémem. |
| Diagram | 53 | Grafický obrázek použitý k diagramu dat. |
| Dial | 49 | Číselník nebo knoflík. Může to být také objekt jen pro čtení, například rychloměr. |
| Dialog | 18 | Dialogové okno nebo okno se zprávou. |
| 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. |
| DropList | 47 | Rozevírací seznam. Tento ovládací prvek zobrazuje jednu položku a umožňuje uživateli zobrazit a vybrat jinou ze seznamu alternativních voleb. |
| Equation | 55 | Matematická rovnice |
| Graphic | 40 | Obrázek. |
| Grip | 4 | Speciální ukazatel myši, který umožňuje uživateli 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. |
| Grouping | 20 | Objekty seskupené logickým způsobem. Mezi objektem seskupení a objekty, které obsahuje, může existovat vztah nadřazený-podřízený. |
| HelpBalloon | 31 | Zobrazení nápovědy ve formě popisu nebo bubliny 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. |
| HotkeyField | 50 | Pole s klávesovou zkratkou, které uživateli umožňuje zadat kombinaci nebo posloupnost stisknutí kláves, které se mají použít jako akční klávesa, což uživatelům umožňuje rychle provést akci. Ovládací prvek akční klávesy zobrazuje stisknutí kláves zadaných uživatelem a zajišťuje, že uživatel vybere platnou kombinaci kláves. |
| Indicator | 39 | Indikátor, například obrázek ukazatele, který odkazuje na aktuální položku. |
| IpAddress | 63 | Ovládací prvek určený pro zadávání IP adres(Internet Protocol). |
| Link | 30 | Propojení, což je propojení mezi zdrojovým a cílovým dokumentem. Tento objekt může vypadat jako text nebo grafika, ale funguje jako tlačítko. |
| List | 33 | Seznam, který uživateli umožňuje vybrat jednu nebo více položek. |
| ListItem | 34 | Položka v seznamu nebo část seznamu v poli se seznamem, rozevírací seznam nebo rozevírací seznam se seznamem. |
| MenuBar | 2 | Řádek nabídek, obvykle pod záhlavím okna, ze kterého můžou uživatelé vybírat nabídky. |
| MenuItem | 12 | Položka nabídky, což je položka v nabídce, kterou uživatel může zvolit k provedení příkazu, výběru možnosti nebo zobrazení jiné nabídky. Funkčně může být položka nabídky ekvivalentní tlačítku, přepínači, zaškrtávacímu políčku nebo nabídce. |
| MenuPopup | 11 | Nabídka, která obsahuje seznam možností, ze kterých může uživatel provést výběr pro provedení akce. Tuto roli musí mít všechny typy nabídek, 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í při kliknutí pravým tlačítkem myši. |
| None | 0 | Žádnou. |
| Outline | 35 | Osnova nebo stromová struktura, například ovládací prvek stromového zobrazení, který zobrazuje hierarchický seznam a obvykle umožňuje uživateli rozbalit a sbalit větve. |
| OutlineButton | 64 | Ovládací prvek, který se pohybuje jako položka osnovy. |
| OutlineItem | 36 | Položka v osnově nebo stromové struktuře. |
| PageTab | 37 | Stránka vlastností, která uživateli umožňuje zobrazit atributy stránky, například název stránky, zda se jedná o domovskou stránku nebo zda 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. |
| PageTabList | 60 | Kontejner ovládacích prvků karta stránky. |
| Pane | 16 | Samostatná oblast v rámečku, 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ámců nebo dokumenty, ale nad jednotlivými ovládacími prvky. V závislosti na kontextu uživatel obvykle přecházení mezi podokny stisknutím kláves TAB, F6 nebo CTRL+TAB. |
| ProgressBar | 48 | Indikátor průběhu, který označuje průběh dlouhé 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í vstup uživatele. |
| PropertyPage | 38 | Stránka vlastností, což je dialogové okno, které řídí vzhled a chování objektu, jako je soubor nebo prostředek. Vzhled stránky vlastností se liší podle jejího účelu. |
| PushButton | 43 | Ovládací prvek spouštěný tlačítkem, což je malý obdélníkový ovládací prvek, který může uživatel zapnout nebo vypnout. Tlačítko, označované také jako příkazové tlačítko, má vyvýšený vzhled ve výchozím vypnutém stavu a propadlý vzhled, když je zapnuté. |
| RadioButton | 45 | Přepínač, označovaný také jako přepínač. Všechny objekty sdílející jeden nadřazený objekt, které mají tento atribut, se považují za součást jedné vzájemně se vylučující skupiny. Seskupené objekty můžete v případě potřeby použít k rozdělení přepínačů do samostatných skupin. |
| Row | 28 | Řádek buněk v tabulce |
| RowHeader | 26 | Záhlaví řádku, které poskytuje vizuální popisek řádku tabulky. |
| ScrollBar | 3 | Svislý nebo vodorovný posuvník, který může být součástí klientské oblasti nebo použít v ovládacím prvku. |
| Separator | 21 | Prostor rozdělený vizuálně na dvě oblasti, jako je například položka nabídky oddělovače nebo oddělovač rozdělující podokna v okně. |
| Slider | 51 | Ovládací prvek, někdy označovaný jako trackbar, který umožňuje uživateli upravit nastavení v daných přírůstcích mezi minimální a maximální hodnotou posunutím posuvníku. Ovládací prvky hlasitosti v operačním systému Windows jsou ovládací prvky posuvníku. |
| Sound | 5 | Systémový zvuk, který je spojený s různými systémovými událostmi. |
| SpinButton | 52 | Číselník, označovaný také jako ovládací prvek nahoru a dolů, který obsahuje dvojici tlačítek se šipkami. Uživatel klikne myší na tlačítka se šipkami, aby hodnotu navýšil nebo zhoršil. Ovládací prvek číselník se nejčastěji používá s doprovodným ovládacím prvku, kterému se říká okno kamaráda, kde se zobrazuje aktuální hodnota. |
| SplitButton | 62 | Tlačítko panelu nástrojů, které má ikonu rozevíracího seznamu přímo vedle tlačítka. |
| StaticText | 41 | Text jen pro čtení, například v popisku, pro další ovládací prvky nebo pokyny v dialogovém okně. Statický text nelze změnit ani vybrat. |
| 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 obsahovat 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ě i záhlaví řádků a sloupců. |
| Text | 42 | Text s možností výběru, který lze upravovat nebo jen pro čtení. |
| TitleBar | 1 | Záhlaví nebo řádek titulků okna. |
| ToolBar | 22 | Panel nástrojů, což je seskupení ovládacích prvků, které poskytují snadný přístup k často používaným funkcím. |
| ToolTip | 13 | Popis tlačítka, což je malé obdélníkové automaticky otevírané okno se stručným popisem účelu tlačítka. |
| WhiteSpace | 59 | Mezera mezi ostatními objekty. |
| 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ě. |
Příklady
Následující příklad kódu demonstruje vytvoření ovládacího prvku grafu s podporou přístupnosti AccessibleObject pomocí tříd a Control.ControlAccessibleObject ke zveřejnění přístupných informací. Ovládací prvek vykreslí 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 je vykreslován ovládacím prvek grafu, neobsahuje žádné předdefinované přístupné informace. Z tohoto důvodu třída přepíše metodu tak, ChartControlAccessibleObject aby vrátila CurveLegendAccessibleObject , která představuje přístupné informace pro každou část legendy.GetChild Když aplikace s podporou přístupnosti používá tento ovládací prvek, může ovládací prvek poskytnout potřebné přístupné informace.
Tento příklad ukazuje použití výčtu AccessibleRoleRole s vlastností . Kompletní příklad kódu najdete v AccessibleObject přehledu 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 je používána aplikacemi pro usnadnění přístupu.
Tento výčet používají AccessibleObject a Control.AccessibleRole
Další informace o aplikaci pro usnadnění přístupu najdete v knihovně MSDN (Microsoft Microsoft Active Accessibility).
