AccessibleRole Wyliczenie
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Określa wartości reprezentujące możliwe role dla obiektu dostępnego.
public enum class AccessibleRolepublic enum AccessibleRoletype AccessibleRole = Public Enum AccessibleRole- Dziedziczenie
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). |
| Link | 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).
