Sdílet prostřednictvím


AccessibleStates Výčet

Definice

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
AccessibleStates
Atributy

Pole

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 na tento stav, 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 posune na obrazovku, 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, než může uživatel pokračovat.

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 úrovně 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í vědět, že jsou k dispozici důležité informace, aniž by ve skutečnosti přerušil práci uživatele. Uživatelé se pak můžou kdykoli dotazovat na informace o upozorněních.

Animated 16384

Objekt, který rychle nebo neustále mění vzhled. Grafika, která jsou občas animované, ale ne vždy, by měla být definována jako GraphicORAnimated. Tento stav by neměl být použit k označení, že se umístění objektu mění.

Busy 2048

Ovládací prvek, který nemůže přijmout vstup v aktuální podmínce.

Checked 16

Objekt s vybraným zaškrtávacím políčku.

Collapsed 1024

Skryté podřízené objektu, které jsou položkami ve struktuře osnovy nebo stromu.

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.

ExtSelectable 33554432

Změněný 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 vybraný objekt ukotvení, výběr se rozšíří tak, aby zahrnoval tento objekt a všechny objekty mezi nimi. 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í kombinován s TakeFocus.

Floating 4096

Objekt, který není pevný na hranici nadřazeného objektu a který se automaticky nepřesune spolu s nadřazeným objektem.

Focusable 1048576

Objekt v aktivním okně, který může přijímat fokus klávesnice.

Focused 4

Objekt s fokusem klávesnice

HasPopup 1073741824

Objekt při vyvolání zobrazí místní nabídku nebo okno.

HotTracked 128

Objekt sledovaný myší, což znamená, že se jeho vzhled zvýrazní, což znamená, že ukazatel myši se nachází nad ním.

Indeterminate 32

Zaškrtávací políčko se třemi stavy nebo tlačítko panelu nástrojů, jehož stav je nedeterminovaný. Zaškrtávací políčko není zaškrtnuté ani nezaškrtnuté a je ve třetím nebo smíšeném stavu.

Invisible 32768

Objekt bez viditelného uživatelského rozhraní.

Linked 4194304

Propojený objekt, který nebyl dříve vybrán.

Marqueed 8192

Objekt s posouváním nebo přesunutím textu nebo grafiky

Mixed 32

Zaškrtávací políčko se třemi stavy nebo tlačítko panelu nástrojů, jehož stav je nedeterminovaný. Zaškrtávací políčko není zaškrtnuté ani nezaškrtnuté a je ve třetím nebo smíšeném stavu.

Moveable 262144

Pohyblivý objekt.

MultiSelectable 16777216

Objekt, který přijímá více vybraných položek.

None 0

Žádný stav.

Offscreen 65536

Žádná reprezentace na obrazovce Zvukový objekt nebo objekt upozornění by měl tento stav nebo skryté okno, které se nikdy nezviditelnilo.

Pressed 8

Stisknutý objekt

Protected 536870912

Ovládací prvek pro úpravy chráněný heslem

ReadOnly 64

Objekt jen pro čtení.

Selectable 2097152

Objekt, který může přijmout výběr.

Selected 2

Vybraný objekt.

SelfVoicing 524288

Objekt nebo podřízený objekt může k popisu použít převod textu na řeč (TTS). Podpora přístupnosti na základě řeči by neměla oznamovat informace, když má objekt s tímto stavem fokus, protože objekt automaticky oznámí informace o sobě.

Sizeable 131072

Sizable objekt.

Traversed 8388608

Byl vybrán propojený objekt.

Unavailable 1

Objekt není k dispozici.

Valid 1073741823

Platný objekt. Tato vlastnost je v .NET Framework 2.0 zastaralá.

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 od ControlAccessibleObject, se používá 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 kreslený ovládacím prvek grafu, neobsahuje žádné předdefinované přístupné informace. Z tohoto důvodu třída přepíše metodu GetChild tak, ChartControlAccessibleObject aby vrátila CurveLegendAccessibleObject přístupné informace pro každou část legendy. Pokud aplikace s podporou přístupnosti používá tento ovládací prvek, může ovládací prvek poskytnout potřebné přístupné informace.

Tento výňatek kódu ukazuje použití výčtu AccessibleStates State 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ů.

Platí pro

Viz také