AccessibleRole Wyliczenie

Definicja

Określa wartości reprezentujące możliwe role dla obiektu dostępnego.

public enum class AccessibleRole
public enum AccessibleRole
type AccessibleRole = 
Public Enum AccessibleRole
Dziedziczenie
AccessibleRole

Pola

Alert 8

Alert lub warunek, o którym można powiadomić użytkownika. Tej roli należy używać tylko w przypadku obiektów, które ucieleśniają alert, ale nie są skojarzone z innym elementem interfejsu użytkownika, takim jak pole komunikatu, grafika, tekst lub dźwięk.

Animation 54

Kontrolka animacji, która zawiera zawartość, która zmienia się wraz z upływem czasu, na przykład kontrolka, która wyświetla serię ramek mapy bitowej, na przykład filmtrip. Kontrolki animacji są zwykle wyświetlane podczas kopiowania plików lub wykonywania innego czasochłonnego zadania.

Application 14

Główne okno aplikacji.

Border 19

Obramowanie okna. Całe obramowanie jest reprezentowane przez pojedynczy obiekt, a nie przez oddzielne obiekty dla każdej strony.

ButtonDropDown 56

Przycisk, który rozwija listę elementów.

ButtonDropDownGrid 58

Przycisk, który rozwija siatkę.

ButtonMenu 57

Przycisk, który rozwija menu.

Caret 7

Daszek, który jest migającą linią, blokiem lub mapą bitową, która oznacza lokalizację punktu wstawiania w obszarze klienta okna.

Cell 29

Komórka w tabeli.

Character 32

Obiekt graficzny przypominający kreskówkę, taki jak Microsoft Asystent pakietu Office, który jest zwykle wyświetlany w celu zapewnienia pomocy użytkownikom aplikacji.

Chart 17

Obraz graficzny używany do reprezentowania danych.

CheckButton 44

Kontrolka pola wyboru, która jest opcją, która może być włączona lub wyłączona niezależnie od innych opcji.

Client 10

Obszar użytkownika okna.

Clock 61

Kontrolka, która wyświetla czas.

Column 27

Kolumna komórek w tabeli.

ColumnHeader 25

Nagłówek kolumny, który udostępnia etykietę wizualizacji dla kolumny w tabeli.

ComboBox 46

Pole kombi, które jest kontrolką edycji ze skojarzonym polem listy, które udostępnia zestaw wstępnie zdefiniowanych opcji.

Cursor 6

Wskaźnik myszy.

Default -1

Rola zapewniana przez system.

Diagram 53

Obraz graficzny używany do tworzenia diagramów danych.

Dial 49

Pokrętło lub pokrętło. Może to być również obiekt tylko do odczytu, taki jak prędkościomierz.

Dialog 18

Okno dialogowe lub okno dialogowe.

Document 15

Okno dokumentu, które jest zawsze zawarte w oknie aplikacji. Ta rola ma zastosowanie tylko do okien interfejsu MDI (multiple-document interface) i odwołuje się do obiektu, który zawiera pasek tytułu MDI.

DropList 47

Pole listy rozwijanej. Ta kontrolka pokazuje jeden element i umożliwia użytkownikowi wyświetlanie i wybieranie innego z listy alternatywnych opcji.

Equation 55

Równanie matematyczne.

Graphic 40

Obraz.

Grip 4

Specjalny wskaźnik myszy, który umożliwia użytkownikowi manipulowanie elementami interfejsu użytkownika, takimi jak okno. Na przykład użytkownik może kliknąć i przeciągnąć uchwyt rozmiaru w prawym dolnym rogu okna, aby zmienić jego rozmiar.

Grouping 20

Obiekty pogrupowane w logiczny sposób. Między obiektem grupowania i obiektami, które zawiera, może istnieć relacja nadrzędny-podrzędna.

HelpBalloon 31

Pomoc wyświetlana w formie dymka Etykietka narzędzia lub Pomoc zawierająca przyciski i etykiety, które użytkownicy mogą kliknąć, aby otworzyć niestandardowe tematy Pomocy.

HotkeyField 50

Pole hot-key, które umożliwia użytkownikowi wprowadzanie kombinacji lub sekwencji naciśnięć klawiszy do użycia jako klucz gorący, co umożliwia użytkownikom szybkie wykonywanie akcji. Kontrolka hot-key wyświetla naciśnięcia klawiszy wprowadzone przez użytkownika i zapewnia, że użytkownik wybierze prawidłową kombinację klawiszy.

Indicator 39

Wskaźnik, taki jak grafika wskaźnika, wskazujący bieżący element.

IpAddress 63

Kontrolka przeznaczona do wprowadzania adresów IP (Internet Protocol).

30

Link, który jest połączeniem między dokumentem źródłowym a dokumentem docelowym. Ten obiekt może wyglądać jak tekst lub grafika, ale działa jak przycisk.

List 33

Pole listy, które umożliwia użytkownikowi wybranie co najmniej jednego elementu.

ListItem 34

Element w polu listy lub część listy pola kombi, pola listy rozwijanej lub pola kombi.

MenuBar 2

Pasek menu, zazwyczaj pod paskiem tytułu okna, z którego użytkownicy mogą wybierać menu.

MenuItem 12

Element menu, który jest wpisem w menu, które użytkownik może wybrać do wykonania polecenia, wybrać opcję lub wyświetlić inne menu. Funkcjonalnie element menu może być odpowiednikiem przycisku, przycisku radiowego, pola wyboru lub menu.

MenuPopup 11

Menu zawierające listę opcji, z których użytkownik może dokonać wyboru w celu wykonania akcji. Wszystkie typy menu muszą mieć tę rolę, w tym menu rozwijane wyświetlane przez wybór z paska menu, a menu skrótów wyświetlane po kliknięciu prawym przyciskiem myszy.

None 0

Nie odgrywają żadnej roli.

Outline 35

Struktura konspektu lub drzewa, taka jak kontrolka widoku drzewa, która wyświetla listę hierarchiczną i zwykle umożliwia użytkownikowi rozwijanie i zwijanie gałęzi.

OutlineButton 64

Kontrolka, która nawiguje jak element konspektu.

OutlineItem 36

Element w strukturze konspektu lub drzewa.

PageTab 37

Strona właściwości, która umożliwia użytkownikowi wyświetlanie atrybutów strony, takich jak tytuł strony, niezależnie od tego, czy jest to strona główna, czy też czy strona została zmodyfikowana. Zwykle jedynym elementem podrzędnym tej kontrolki jest pogrupowany obiekt, który zawiera zawartość skojarzonej strony.

PageTabList 60

Kontener kontrolek kart strony.

Pane 16

Oddzielny obszar w ramce, w oknie podzielonym dokumentu lub prostokątnym obszarze paska stanu, który może służyć do wyświetlania informacji. Użytkownicy mogą nawigować między okienkami i w obrębie zawartości bieżącego okienka, ale nie mogą nawigować między elementami w różnych okienkach. W związku z tym okienka reprezentują poziom grupowania niższy niż okna ramowe lub dokumenty, ale powyżej poszczególnych kontrolek. Zazwyczaj użytkownik przechodzi między okienkami, naciskając klawisz TAB, F6 lub CTRL+TAB, w zależności od kontekstu.

ProgressBar 48

Pasek postępu, który wskazuje postęp długiej operacji, wyświetlając kolorowe linie wewnątrz poziomego prostokąta. Długość wierszy w odniesieniu do długości prostokąta odpowiada procentowi ukończonej operacji. Ta kontrolka nie pobiera danych wejściowych użytkownika.

PropertyPage 38

Strona właściwości, która jest okno dialogowe, które kontroluje wygląd i zachowanie obiektu, takiego jak plik lub zasób. Wygląd strony właściwości różni się w zależności od przeznaczenia.

PushButton 43

Kontrolka przycisku push, która jest małą prostokątną kontrolką, którą użytkownik może włączyć lub wyłączyć. Przycisk naciśnięcia, znany również jako przycisk polecenia, ma podniesiony wygląd w domyślnym stanie wyłączonym i zatopiony wygląd po włączeniu.

RadioButton 45

Przycisk opcji, znany również jako przycisk radiowy. Wszystkie obiekty współużytkujące pojedynczy element nadrzędny, który ma ten atrybut, są zakładane jako część pojedynczej wzajemnie wykluczanej grupy. W razie potrzeby można użyć pogrupowanych obiektów, aby podzielić przyciski opcji na oddzielne grupy.

Row 28

Wiersz komórek w tabeli.

RowHeader 26

Nagłówek wiersza, który udostępnia etykietę wizualną dla wiersza tabeli.

ScrollBar 3

Pionowy lub poziomy pasek przewijania, który może być częścią obszaru klienta lub używany w kontrolce.

Separator 21

Przestrzeń podzielona wizualnie na dwa regiony, takie jak element menu separatora lub separator dzielący okienka w oknie.

Slider 51

Kontrolka, czasami nazywana paskiem śledzenia, która umożliwia użytkownikowi dostosowanie ustawienia w podanych przyrostach między wartościami minimalnymi i maksymalnymi przez przesunięcie suwaka. Kontrolki głośności w systemie operacyjnym Windows to kontrolki suwaka.

Sound 5

Dźwięk systemowy, który jest skojarzony z różnymi zdarzeniami systemowymi.

SpinButton 52

Pole spin, znane również jako kontrolka w górę w dół, która zawiera parę przycisków strzałek. Użytkownik klika przyciski strzałek za pomocą myszy, aby zwiększać lub dekrementować wartość. Kontrolka przycisku spin jest najczęściej używana z kontrolką towarzysza, nazywaną oknem kumpla, gdzie wyświetlana jest bieżąca wartość.

SplitButton 62

Przycisk paska narzędzi z ikoną listy rozwijanej bezpośrednio sąsiadującą z przyciskiem.

StaticText 41

Tekst tylko do odczytu, taki jak w etykiecie, dla innych kontrolek lub instrukcji w oknie dialogowym. Nie można zmodyfikować ani zaznaczyć tekstu statycznego.

StatusBar 23

Pasek stanu, który jest zazwyczaj obszarem w dolnej części okna aplikacji, który wyświetla informacje o bieżącej operacji, stanie aplikacji lub wybranym obiekcie. Pasek stanu może zawierać wiele pól, które wyświetlają różne rodzaje informacji, takie jak wyjaśnienie aktualnie wybranego polecenia menu na pasku stanu.

Table 24

Tabela zawierająca wiersze i kolumny komórek oraz opcjonalnie nagłówki wierszy i nagłówki kolumn.

Text 42

Zaznaczony tekst, który może być edytowalny lub tylko do odczytu.

TitleBar 1

Pasek tytułu lub podpisu dla okna.

ToolBar 22

Pasek narzędzi, który jest grupowaniem kontrolek, które zapewniają łatwy dostęp do często używanych funkcji.

ToolTip 13

Porada narzędzia, która jest małym prostokątnym wyskakującym oknem, który wyświetla krótki opis przeznaczenia przycisku.

WhiteSpace 59

Puste miejsce między innymi obiektami.

Window 9

Ramka okna, która zwykle zawiera obiekty podrzędne, takie jak pasek tytułu, klient i inne obiekty zwykle zawarte w oknie.

Przykłady

W poniższym przykładzie kodu pokazano tworzenie kontrolki wykresu obsługującego ułatwienia dostępu przy użyciu AccessibleObject klas i Control.ControlAccessibleObject w celu uwidocznienia dostępnych informacji. Kontrolka wykreśli dwie krzywe wraz z legendą. Klasa ChartControlAccessibleObject , która pochodzi z ControlAccessibleObjectklasy , jest używana w metodzie CreateAccessibilityInstance w celu zapewnienia niestandardowych informacji dostępnych dla kontrolki wykresu. Ponieważ legenda wykresu nie jest rzeczywistą Control kontrolką opartą na wykresie, ale zamiast tego jest rysowana przez kontrolkę wykresu, nie zawiera żadnych wbudowanych informacji dostępnych. W związku z tym ChartControlAccessibleObject klasa zastępuje metodę GetChild , aby zwrócić CurveLegendAccessibleObject element reprezentujący dostępne informacje dla każdej części legendy. Gdy ta kontrolka jest używana przez aplikację z ułatwieniami dostępu, kontrolka może dostarczać niezbędne dostępne informacje.

W tym przykładzie pokazano użycie AccessibleRole wyliczenia z właściwością Role . Zobacz omówienie klasy, AccessibleObject aby zapoznać się z kompletnym przykładem kodu.

// 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

Uwagi

Rola obiektu opisuje funkcję obiektu i jest używana przez aplikacje ułatwień dostępu.

To wyliczenie jest używane przez AccessibleObject i Control.AccessibleRole

Aby uzyskać dodatkowe informacje o aplikacji ułatwień dostępu, wyszukaj ciąg "Microsoft aktywne ułatwienia dostępu" w bibliotece Microsoft Developer Network (MSDN).

Dotyczy

Zobacz też