Sdílet prostřednictvím


AccessibleRole Výčet

Definice

Určuje hodnoty představující možné role přístupného objektu.

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

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).

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).

Platí pro

Viz také