AccessibleStates 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é stavy pro přístupný objekt.
Tento výčet podporuje bitové kombinace hodnot jeho členů.
public enum class AccessibleStates[System.Flags]
public enum AccessibleStates[<System.Flags>]
type AccessibleStates = Public Enum AccessibleStates- Dědičnost
- Atributy
Pole
| Name | Hodnota | Description |
|---|---|---|
| None | 0 | Žádný stav. |
| Unavailable | 1 | Objekt není k dispozici. |
| Selected | 2 | Vybraný objekt. |
| Focused | 4 | Objekt s fokusem klávesnice |
| Pressed | 8 | Stisknutý objekt. |
| Checked | 16 | Objekt s vybraným zaškrtávacím políček. |
| Indeterminate | 32 | Zaškrtávací políčko se třemi stavy nebo tlačítko panelu nástrojů, jehož stav je neurčitý. Zaškrtávací políčko není zaškrtnuté ani nezaškrtnuté a je ve třetím nebo smíšeném stavu. |
| Mixed | 32 | Zaškrtávací políčko se třemi stavy nebo tlačítko panelu nástrojů, jehož stav je neurčitý. Zaškrtávací políčko není zaškrtnuté ani nezaškrtnuté a je ve třetím nebo smíšeném stavu. |
| ReadOnly | 64 | Objekt jen pro čtení. |
| HotTracked | 128 | Objekt, který je sledován myší, je zvýrazněný, což znamená, že je nad ním umístěn ukazatel myši. |
| Default | 256 | Výchozí tlačítko nebo položka nabídky. |
| Expanded | 512 | Zobrazené podřízené položky objektu, které jsou položkami ve struktuře osnovy nebo stromu. |
| Collapsed | 1024 | Skryté podřízené položky objektu, které jsou položkami ve struktuře osnovy nebo stromu. |
| Busy | 2048 | Ovládací prvek, který nemůže přijmout vstup v aktuální podmínce. |
| Floating | 4096 | Objekt, který není pevně nastaven na hranici nadřazeného objektu a který se automaticky nepřesune spolu s nadřazeným objektem. |
| Marqueed | 8192 | Objekt s posouváním nebo přesunutím textu nebo grafiky |
| Animated | 16384 | Objekt, který rychle nebo neustále mění vzhled. Grafika, která jsou příležitostně animované, ale ne vždy, by měla být definována jako Graphic |
| Invisible | 32768 | Objekt bez viditelného uživatelského rozhraní. |
| Offscreen | 65536 | Žádná reprezentace na obrazovce. Zvukový objekt nebo objekt výstrahy by měl tento stav nebo skryté okno, které se nikdy nezviditelnilo. |
| Sizeable | 131072 | Objekt, který lze sizable. |
| Moveable | 262144 | Pohyblivý objekt. |
| SelfVoicing | 524288 | Objekt nebo podřízený objekt můžou k popisu použít převod textu na řeč (TTS). Pomoc s přístupností na základě řeči by neměla oznamovat informace, když má objekt s tímto stavem fokus, protože objekt automaticky oznamuje informace o sobě. |
| Focusable | 1048576 | Objekt v aktivním okně, který může přijímat fokus klávesnice. |
| Selectable | 2097152 | Objekt, který může přijmout výběr. |
| Linked | 4194304 | Propojený objekt, který nebyl dříve vybrán. |
| Traversed | 8388608 | Propojený objekt, který byl dříve vybrán. |
| MultiSelectable | 16777216 | Objekt, který přijímá více vybraných položek. |
| ExtSelectable | 33554432 | Upravený výběr tak, aby všechny objekty mezi ukotvením výběru, což je objekt s fokusem klávesnice, a tento objekt převzal stav výběru objektu ukotvení. Pokud objekt ukotvení není vybraný, odeberou se z výběru objekty. Pokud je vybrán objekt ukotvení, výběr je rozšířen tak, aby zahrnoval tento objekt a všechny objekty mezi. Stav výběru můžete nastavit tak, že ho zkombinujete s AddSelection nebo RemoveSelection. Tento stav nezmění fokus ani ukotvení výběru, pokud není zkombinována s TakeFocus. |
| AlertLow | 67108864 | Informace s nízkou prioritou, které nemusí být pro uživatele důležité. |
| AlertMedium | 134217728 | Důležité informace, které není nutné uživateli sdělit okamžitě. Pokud například indikátor na úrovni baterie začíná dosahovat nízké úrovně, může vygenerovat výstrahu střední úrovně. Nástroje pro nevidomý přístup pak můžou vygenerovat zvuk, který uživateli umožní zjistit, že jsou k dispozici důležité informace, aniž by ve skutečnosti přerušili práci uživatele. Uživatelé se pak můžou kdykoliv dotazovat na informace o upozornění. |
| AlertHigh | 268435456 | Důležité informace, které by se měly uživateli sdělit okamžitě. Například indikátor úrovně baterie, který dosáhne kritické nízké úrovně, přejde do tohoto stavu, v takovém případě by nástroj pro nevidomý přístup oznamoval tyto informace okamžitě uživateli a program pro zvětšení obrazovky se posouvat obrazovku tak, aby byl indikátor baterie v zobrazení. Tento stav je také vhodný pro všechny výzvy nebo operace, které musí být dokončeny, aby uživatel mohl pokračovat. |
| Protected | 536870912 | Ovládací prvek pro úpravy chráněný heslem. |
| Valid | 1073741823 | Platný objekt. Tato vlastnost je zastaralá. |
| HasPopup | 1073741824 | Objekt při vyvolání zobrazí místní nabídku nebo okno. |
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. Protože legenda grafu není skutečný ovládací prvek založený na Control, ale je vykreslen ovládacím prvku 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 výňatek kódu ukazuje použití výčtu AccessibleStatesState 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
Přístupný objekt může být přidružený k jednomu nebo více z těchto stavů.
