Esta documentación está archivada y no tiene mantenimiento.

AccessibleStates (Enumeración)

Especifica valores que representan posibles estados de un objeto accesible.

La enumeración tiene un atributo FlagsAttribute que permite una combinación bit a bit de los valores de miembro.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

[FlagsAttribute] 
public enum AccessibleStates
/** @attribute FlagsAttribute() */ 
public enum AccessibleStates
FlagsAttribute 
public enum AccessibleStates

 Nombre de miembroDescripción
AlertHighInformación importante que se debe transmitir al usuario de forma inmediata. Por ejemplo, un indicador de nivel de batería que alcanza un nivel bajo crítico cambia a este estado, en cuyo caso, una utilidad de acceso oculto presenta esta información inmediatamente al usuario y un programa de ampliación de pantalla desplaza la pantalla para que el indicador de batería quede a la vista. Este estado también es adecuado para cualquier solicitud u operación que se deba llevar a cabo antes de que el usuario pueda continuar. 
AlertLowInformación de prioridad baja que puede no ser importante para el usuario. 
AlertMediumInformación importante que no es necesario transmitir al usuario de forma inmediata. Por ejemplo, cuando un indicador de nivel de batería empieza a alcanzar un nivel bajo, puede generar una alerta de nivel medio. A continuación, las utilidades de acceso oculto generan un sonido para hacer saber al usuario que hay información importante disponible sin interrumpir realmente su trabajo. Así, los usuarios pueden consultar la información de alerta cuando lo deseen. 
AnimatedObjeto que cambia rápida y constantemente de apariencia. Los gráficos que en ocasiones son animados, pero no siempre, se definen como GraphicORAnimated. Este estado no se debe utilizar para indicar el cambio de ubicación de un objeto. 
BusyControl que no puede aceptar ninguna entrada con su condición actual. 
CheckedObjeto con una casilla de verificación seleccionada. 
CollapsedSecundarios ocultos del objeto que son elementos de una estructura de árbol o esquema. 
DefaultBotón o elemento de menú predeterminado. 
ExpandedSecundarios mostrados del objeto que son elementos de una estructura de árbol o esquema. 
ExtSelectableSelección modificada, de tal forma que todos los objetos entre el delimitador de selección, que es el objeto con el foco de teclado, y este objeto adopten el estado de selección del objeto delimitador. Si el objeto delimitador no está seleccionado, los objetos se quitan de la selección. Si el objeto delimitador está seleccionado, la selección se extiende para incluir este objeto y todos los que se encuentren entre ellos. Se puede establecer el estado de selección mediante su combinación con AccessibleSelection.AddSelection o AccessibleSelection.RemoveSelection. Este estado no cambia el foco ni el delimitador de selección, a menos que se combine con AccessibleSelection.TakeFocus
FloatingObjeto que no está fijado al límite de su objeto primario y que no se mueve automáticamente junto con él. 
FocusableObjeto de la ventana activa que puede recibir el foco de teclado. 
FocusedObjeto con el foco de teclado. 
HasPopup 
HotTrackedObjeto con un seguimiento completo por parte del mouse, lo que significa que su apariencia se resalta para indicar que el puntero del mouse se encuentra sobre él. 
IndeterminateCasilla de verificación de tres estados o botón de la barra de herramientas cuyo estado es indeterminado. La casilla de verificación no está ni activada ni desactivada, sino que se encuentra en el tercer estado o estado combinado. 
InvisibleObjeto sin una interfaz de usuario visible. 
LinkedObjeto vinculado que no se ha seleccionado anteriormente. 
MarqueedObjeto con texto o gráficos que se desplazan o se mueven. 
MixedCasilla de verificación de tres estados o botón de la barra de herramientas cuyo estado es indeterminado. La casilla de verificación no está ni activada ni desactivada, sino que se encuentra en el tercer estado o estado combinado. 
MoveableObjeto que se puede mover. 
MultiSelectableObjeto que acepta la selección de varios elementos. 
NoneSin estado. 
OffscreenSin representación en pantalla. Un objeto de alerta o sonido, o una ventana oculta que nunca se hace visible, tienen este estado. 
PressedObjeto presionado. 
ProtectedControl de edición protegido por contraseña. 
ReadOnlyObjeto de sólo lectura. 
SelectableObjeto que puede aceptar una selección. 
SelectedObjeto seleccionado. 
SelfVoicingEl objeto o secundario pueden utilizar texto a voz (TTS) para describirse a sí mismos. Una ayuda de accesibilidad basada en la voz no debe ofrecer información cuando un objeto con este estado tiene el foco, puesto que el objeto ofrece automáticamente información sobre sí mismo. 
SizeableObjeto cuyo tamaño se puede cambiar. 
TraversedObjeto vinculado que se ha seleccionado anteriormente. 
UnavailableObjeto no disponible. 
ValidObjeto válido. Esta propiedad está obsoleta en .NET Framework 2.0.  

Un objeto accesible se puede asociar a uno o varios de estos estados.

Para obtener más información sobre la aplicación de accesibilidad, vea "Microsoft Active Accessibility" en la biblioteca de Microsoft Developer Network (MSDN), en la dirección http://msdn.microsoft.com/library/spa.

En el siguiente ejemplo de código se muestra la creación de un control de gráfico con reconocimiento de accesibilidad mediante las clases AccessibleObject y Control.ControlAccessibleObject con el fin de exponer información accesible. El control dibuja dos curvas acompañadas de una leyenda. La clase ChartControlAccessibleObject, que se deriva de ControlAccessibleObject, se utiliza en el método CreateAccessibilityInstance a fin de proporcionar información personalizada accesible para el control de gráfico. Dado que la leyenda del gráfico no es en realidad un control basado en Control, sino que la dibuja el control de gráfico, no contiene ninguna información accesible integrada. Debido a esto, la clase ChartControlAccessibleObject reemplaza el método GetChild para devolver CurveLegendAccessibleObject que representa la información accesible de cada parte de la leyenda. Cuando este control se utiliza en una aplicación con reconocimiento de accesibilidad, el control puede proporcionar la información accesible que sea necesaria.

En este fragmento de código se muestra la utilización de la enumeración AccessibleStates con la propiedad State. Para obtener el ejemplo completo del código, vea la información general de la clase AccessibleObject.

// 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 static class ChartControlAccessibleObject 
    extends ControlAccessibleObject
{
    private ChartControl chartControl;

    public ChartControlAccessibleObject(ChartControl ctrl)
    {
        super(ctrl);
        chartControl = ctrl;
    } //ChartControlAccessibleObject

    // Gets the role for the Chart. This is used by accessibility programs.
    /** @property 
     */
    public AccessibleRole get_Role()
    {
        return AccessibleRole.Chart;
    } //get_Role

    // Gets the state for the Chart. This is used by accessibility programs.
    /** @property 
     */
    public AccessibleStates get_State()
    {
        return AccessibleStates.ReadOnly;
    } //get_State

    // The CurveLegend objects are "child" controls in terms of  
    // accessibility so return the number of ChartLengend objects.
    public int GetChildCount()
    {
        return chartControl.get_Legends().get_Length();
    } //GetChildCount

    // Gets the Accessibility object of the child CurveLegend 
    // idetified by index.
    public AccessibleObject GetChild(int index)
    {
        if (index >= 0 && index < chartControl.get_Legends().get_Length()) {
            return chartControl.get_Legends()[index].
                get_AccessibilityObject();
        }
        return null;
    } //GetChild

    // 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)
    {
        if (navDir.Equals(AccessibleNavigation.Down) 
            || navDir.Equals(AccessibleNavigation.Next)) {
            return GetChild(child.get_ID() + 1);
        }
        else {
            if (navDir.Equals(AccessibleNavigation.Up) 
                || navDir.Equals(AccessibleNavigation.Previous)) {
                return GetChild(child.get_ID() - 1);
            }
        }
        return null;
    } //NavigateFromChild

    // 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.
    public void SelectChild(CurveLegend.CurveLegendAccessibleObject child, 
        AccessibleSelection selection)
    {
        int childID = child.get_ID();

        // Determine which selection action should occur, based on the
        // AccessibleSelection value.
        if (Convert.ToInt32(selection & AccessibleSelection.TakeSelection)
            != 0) {
            for (int i = 0; i < chartControl.get_Legends().get_Length(); 
                i++) {
                if (i == childID) {
                    ((CurveLegend)chartControl.get_Legends().get_Item(i)).
                        set_Selected(true);
                }
                else {
                    ((CurveLegend)chartControl.get_Legends().get_Item(i)).
                        set_Selected(false);
                }
            }

            // AccessibleSelection.AddSelection means that the CurveLegend 
            // will be selected.
            if (Convert.ToInt32(selection & AccessibleSelection.AddSelection)
                != 0) {
                ((CurveLegend)chartControl.get_Legends().get_Item(childID)).
                    set_Selected(true);
            }

            // AccessibleSelection.AddSelection means that the CurveLegend 
            // will be unselected.
            if (Convert.ToInt32(selection & 
                AccessibleSelection.RemoveSelection) != 0) {
                ((CurveLegend)chartControl.get_Legends().get_Item(childID)).
                    set_Selected(false);
            }
        }
    } //SelectChild
} //ChartControlAccessibleObject

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0
Mostrar: