AccessibleStates Výčet

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

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: Object

ValueType

Enum
AccessibleStates

Atributy: FlagsAttribute

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 Graphic`ORAnimated`. 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