Control.ControlAccessibleObject Clase

Definición

Ofrece información sobre un control que una aplicación de accesibilidad puede usar.

public: ref class Control::ControlAccessibleObject : System::Windows::Forms::AccessibleObject
[System.Runtime.InteropServices.ComVisible(true)]
public class Control.ControlAccessibleObject : System.Windows.Forms.AccessibleObject
public class Control.ControlAccessibleObject : System.Windows.Forms.AccessibleObject
[<System.Runtime.InteropServices.ComVisible(true)>]
type Control.ControlAccessibleObject = class
    inherit AccessibleObject
type Control.ControlAccessibleObject = class
    inherit AccessibleObject
Public Class Control.ControlAccessibleObject
Inherits AccessibleObject
Herencia
Control.ControlAccessibleObject
Herencia
Derivado
Atributos

Ejemplos

En el ejemplo de código siguiente se crea un control de casilla que deriva de la CheckBox clase y se crea un personalizado Control.ControlAccessibleObject para que se use la clase derivada. La clase derivada, MyCheckBox, tiene un Appearance de Button forma predeterminada para que aparezca como un botón de alternancia. La clase derivada Control.ControlAccessibleObject , MyCheckBoxControlAccessibleObject, invalida tres propiedades para tener en cuenta la diferencia de apariencia.

#using <Accessibility.dll>
#using <System.Drawing.dll>
#using <System.dll>
#using <System.Windows.Forms.dll>

using namespace System;
using namespace System::Windows::Forms;
using namespace System::Drawing;

namespace MyCustomControls
{
   public ref class MyCheckBox: public CheckBox
   {
   public:
      MyCheckBox()
      {
         // Make the check box appear like a toggle button.
         this->Appearance = ::Appearance::Button;

         // Center the text on the button.
         this->TextAlign = ContentAlignment::MiddleCenter;

         // Set the AccessibleDescription text.
         this->AccessibleDescription = "A toggle style button.";
      }

   protected:

      // Create an instance of the AccessibleObject
      // defined for the 'MyCheckBox' control
      virtual AccessibleObject^ CreateAccessibilityInstance() override;
   };

   // Accessible Object* for use with the 'MyCheckBox' control.
   private ref class MyCheckBoxAccessibleObject: public Control::ControlAccessibleObject
   {
   public:
      MyCheckBoxAccessibleObject( MyCheckBox^ owner )
         : ControlAccessibleObject( owner )
      {}

      property String^ DefaultAction 
      {
         virtual String^ get() override
         {
            // Return the DefaultAction based upon
            // the state of the control.
            if ( (dynamic_cast<MyCheckBox^>(Owner))->Checked )
            {
               return "Toggle button up";
            }
            else
            {
               return "Toggle button down";
            }
         }
      }

      property String^ Name 
      {
         virtual String^ get() override
         {
            // Return the Text property of the control
            // if the AccessibleName is 0.
            String^ name = Owner->AccessibleName;
            if ( name != nullptr )
            {
               return name;
            }

            return (dynamic_cast<MyCheckBox^>(Owner))->Text;
         }

         virtual void set( String^ value ) override
         {
            ControlAccessibleObject::Name = value;
         }
      }

      property AccessibleRole Role 
      {
         virtual AccessibleRole get() override
         {
            // Since the check box appears like a button,
            // make the Role the same as a button.
            return AccessibleRole::PushButton;
         }
      }
   };

   AccessibleObject^ MyCheckBox::CreateAccessibilityInstance()
   {
      return gcnew MyCheckBoxAccessibleObject( this );
   }
}
using System;
using System.Windows.Forms;
using Accessibility;
using System.Drawing;

namespace MyCustomControls
{
   public class MyCheckBox : CheckBox
   {
      public MyCheckBox()
      {
         // Make the check box appear like a toggle button.
         this.Appearance = Appearance.Button;
         // Center the text on the button.
         this.TextAlign = ContentAlignment.MiddleCenter;
         // Set the AccessibleDescription text.
         this.AccessibleDescription = "A toggle style button.";
      }
      
      // Create an instance of the AccessibleObject 
      // defined for the 'MyCheckBox' control
      protected override AccessibleObject CreateAccessibilityInstance() 
      {
         return new MyCheckBoxAccessibleObject(this);
      }
   }

   // Accessible object for use with the 'MyCheckBox' control.
   internal class MyCheckBoxAccessibleObject : Control.ControlAccessibleObject 
   {
      public MyCheckBoxAccessibleObject(MyCheckBox owner) : base(owner) 
      {
      }
               
      public override string DefaultAction 
      {
         get
         {
            // Return the DefaultAction based upon 
            // the state of the control.
            if( ((MyCheckBox)Owner).Checked )
            {
               return "Toggle button up";
            }
            else
            {
               return "Toggle button down";
            }
         }
      }

      public override string Name 
      {
         get 
         {
            // Return the Text property of the control 
            // if the AccessibleName is null.
            string name = Owner.AccessibleName;
            if (name != null) 
            {
               return name;
            }
            return ((MyCheckBox)Owner).Text;
         }
         
         set
         {
            base.Name = value;
         }
      }            
               
      public override AccessibleRole Role 
      {
         get 
         {
            // Since the check box appears like a button,
            // make the Role the same as a button.
            return AccessibleRole.PushButton;
         }
      }
   }
}
Imports System.Windows.Forms
Imports Accessibility
Imports System.Drawing

Namespace MyCustomControls
   Public Class MyCheckBox
      Inherits CheckBox
      
      Public Sub New()
         ' Make the check box appear like a toggle button.
         Me.Appearance = Appearance.Button
         ' Center the text on the button.
         Me.TextAlign = ContentAlignment.MiddleCenter
      End Sub
      
      ' Create an instance of the AccessibleObject 
      ' defined for the 'MyCheckBox' control 
      Protected Overrides Function CreateAccessibilityInstance() _
        As AccessibleObject
         Return New MyCheckBoxAccessibleObject(Me)
      End Function
   End Class
    
   ' Accessible object for use with the 'MyCheckBox' control.
   Friend Class MyCheckBoxAccessibleObject
      Inherits Control.ControlAccessibleObject
      
      Public Sub New(owner As MyCheckBox)
         MyBase.New(owner)
      End Sub
      
      Public Overrides ReadOnly Property DefaultAction() As String
         Get
            ' Return the DefaultAction based upon 
            ' the state of the control. 
            If CType(Owner, MyCheckBox).Checked Then
               Return "Toggle button up"
            Else
               Return "Toggle button down"
            End If
         End Get
      End Property
      
      Public Overrides Property Name() As String
         Get
            ' Return the Text property of the control 
            ' if the AccessibleName is null. 
            Dim accessibleName As String = Owner.AccessibleName
            If (accessibleName IsNot Nothing) Then
               Return accessibleName
            End If
            Return CType(Owner, MyCheckBox).Text
         End Get

         Set
            MyBase.Name = value
         End Set
      End Property
      
      Public Overrides ReadOnly Property Role() As AccessibleRole
         Get
            ' Since the check box appears like a button,
            ' make the Role the same as a button. 
            Return AccessibleRole.PushButton
         End Get
      End Property
   End Class
End Namespace

Comentarios

Windows Forms tiene compatibilidad con accesibilidad integrada y proporciona información sobre la aplicación que le permite trabajar con aplicaciones cliente de accesibilidad. Algunos ejemplos de aplicaciones cliente de accesibilidad son: utilidades de ampliación de pantalla y revisor, utilidades de entrada de voz, teclados en pantalla, dispositivos de entrada alternativos y utilidades de mejora del teclado. A veces, querrá proporcionar información adicional a las aplicaciones cliente de accesibilidad. Hay dos maneras de proporcionar esta información adicional. Para proporcionar información de accesibilidad limitada para los controles existentes, establezca los valores de propiedad , AccessibleDefaultActionDescriptionAccessibleDescription, y AccessibleRole del controlAccessibleName, que se notificarán a las aplicaciones cliente de accesibilidad. Como alternativa, si necesita que se incluya más información de accesibilidad con el control, puede escribir su propia clase derivada de las AccessibleObject clases o Control.ControlAccessibleObject . Por ejemplo, si está escribiendo su propio control que no se deriva de los controles comunes o necesita tales operaciones como pruebas de posicionamiento dentro del control, debe crear un Control.ControlAccessibleObject para el control llamando al CreateAccessibilityInstance método .

Nota

Si invalida el AccessibleObject.GetChild método , también debe invalidar el AccessibleObject.GetChildCount método . Para obtener o establecer la AccessibilityObject propiedad , debe agregar una referencia al Accessibility ensamblado instalado con .NET Framework.

Para obtener más información sobre los objetos accesibles, vea Microsoft Accesibilidad activa.

Constructores

Control.ControlAccessibleObject(Control)

Inicializa una nueva instancia de la clase Control.ControlAccessibleObject.

Propiedades

Bounds

Obtiene la ubicación y el tamaño del objeto accesible.

(Heredado de AccessibleObject)
DefaultAction

Obtiene una cadena que describe la acción predeterminada del objeto. No todos los objetos tienen una acción predeterminada.

Description

Obtiene la descripción de Control.ControlAccessibleObject.

Handle

Obtiene o establece el controlador del objeto accesible.

Help

Obtiene la descripción de la funcionalidad del objeto o de su uso.

KeyboardShortcut

Obtiene la tecla de método abreviado o la tecla de acceso para un objeto accesible.

Name

Obtiene o establece el nombre del objeto accesible.

Owner

Obtiene el propietario del objeto accesible.

Parent

Obtiene el primario de un objeto accesible.

Role

Obtiene la función de este objeto accesible.

State

Obtiene el estado de este objeto accesible.

(Heredado de AccessibleObject)
Value

Obtiene o establece el valor de un objeto accesible.

(Heredado de AccessibleObject)

Métodos

CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.

(Heredado de MarshalByRefObject)
DoDefaultAction()

Realiza la acción predeterminada asociada a este objeto accesible.

(Heredado de AccessibleObject)
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetChild(Int32)

Recupera el elemento secundario accesible correspondiente al índice especificado.

(Heredado de AccessibleObject)
GetChildCount()

Recupera el número de elementos secundarios que pertenecen a un objeto accesible.

(Heredado de AccessibleObject)
GetFocused()

Recupera el objeto que tiene el foco de teclado.

(Heredado de AccessibleObject)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetHelpTopic(String)

Obtiene un identificador de un tema de Ayuda y la ruta de acceso al archivo de Ayuda asociado a este objeto accesible.

GetLifetimeService()
Obsoletos.

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
GetSelected()

Recupera el secundario seleccionado actualmente.

(Heredado de AccessibleObject)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
HitTest(Int32, Int32)

Recupera el objeto secundario que se encuentra en las coordenadas de pantalla especificadas.

(Heredado de AccessibleObject)
InitializeLifetimeService()
Obsoletos.

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.

(Heredado de MarshalByRefObject)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.

(Heredado de MarshalByRefObject)
Navigate(AccessibleNavigation)

Navega hasta otro objeto accesible.

(Heredado de AccessibleObject)
NotifyClients(AccessibleEvents)

Notifica los objetos AccessibleEvents especificados a las aplicaciones cliente de accesibilidad.

NotifyClients(AccessibleEvents, Int32)

Notifica a las aplicaciones cliente de accesibilidad los objetos AccessibleEvents especificados del control secundario especificado.

NotifyClients(AccessibleEvents, Int32, Int32)

Notifica a las aplicaciones cliente de accesibilidad los objetos AccessibleEvents especificados del control secundario especificado, facilitando la identificación de AccessibleObject.

RaiseAutomationNotification(AutomationNotificationKind, AutomationNotificationProcessing, String)

Genera el evento de notificación de automatización de interfaz de usuario.

(Heredado de AccessibleObject)
RaiseLiveRegionChanged()

Genera el evento de automatización de la interfaz de usuario LiveRegionChanged.

RaiseLiveRegionChanged()

Genera el evento de automatización de la interfaz de usuario LiveRegionChanged.

(Heredado de AccessibleObject)
Select(AccessibleSelection)

Modifica la selección o desplaza el foco de teclado del objeto accesible.

(Heredado de AccessibleObject)
ToString()

Devuelve una cadena que representa el objeto actual.

UseStdAccessibleObjects(IntPtr)

Asocia un objeto a una instancia de un objeto AccessibleObject basándose en el controlador del objeto.

(Heredado de AccessibleObject)
UseStdAccessibleObjects(IntPtr, Int32)

Asocia un objeto a una instancia de un objeto AccessibleObject basándose en el controlador y el identificador del objeto.

(Heredado de AccessibleObject)

Implementaciones de interfaz explícitas

IAccessible.accChildCount

Obtiene el número de interfaces secundarias que pertenecen a este objeto. Para obtener una descripción de este miembro, vea accChildCount.

(Heredado de AccessibleObject)
IAccessible.accDoDefaultAction(Object)

Realiza la acción predeterminada del objeto especificado. No todos los objetos tienen una acción predeterminada. Para obtener una descripción de este miembro, vea accDoDefaultAction(Object).

(Heredado de AccessibleObject)
IAccessible.accFocus

Obtiene el objeto que tiene el foco de teclado. Para obtener una descripción de este miembro, vea accFocus.

(Heredado de AccessibleObject)
IAccessible.accHitTest(Int32, Int32)

Obtiene el objeto secundario que se encuentra en las coordenadas de pantalla especificadas. Para obtener una descripción de este miembro, vea accHitTest(Int32, Int32).

(Heredado de AccessibleObject)
IAccessible.accLocation(Int32, Int32, Int32, Int32, Object)

Obtiene la ubicación de pantalla actual del objeto. Para obtener una descripción de este miembro, vea accLocation(Int32, Int32, Int32, Int32, Object).

(Heredado de AccessibleObject)
IAccessible.accNavigate(Int32, Object)

Navega a un objeto accesible relativo al objeto actual. Para obtener una descripción de este miembro, vea accNavigate(Int32, Object).

(Heredado de AccessibleObject)
IAccessible.accParent

Obtiene el objeto accesible primario de este objeto. Para obtener una descripción de este miembro, vea accParent.

(Heredado de AccessibleObject)
IAccessible.accSelect(Int32, Object)

Modifica la selección o desplaza el foco de teclado del objeto accesible. Para obtener una descripción de este miembro, vea accSelect(Int32, Object).

(Heredado de AccessibleObject)
IAccessible.accSelection

Obtiene los objetos secundarios seleccionados de un objeto accesible. Para obtener una descripción de este miembro, vea accSelection.

(Heredado de AccessibleObject)
IReflect.GetField(String, BindingFlags)

Obtiene el objeto FieldInfo correspondiente al campo y al marcador de enlace especificados. Para obtener una descripción de este miembro, vea GetField(String, BindingFlags).

(Heredado de AccessibleObject)
IReflect.GetFields(BindingFlags)

Obtiene una matriz de objetos FieldInfo correspondientes a todos los campos de la clase actual. Para obtener una descripción de este miembro, vea GetFields(BindingFlags).

(Heredado de AccessibleObject)
IReflect.GetMember(String, BindingFlags)

Obtiene una matriz de objetos MemberInfo correspondientes a todos los miembros públicos o a todos los miembros que coincidan con un nombre especificado. Para obtener una descripción de este miembro, vea GetMember(String, BindingFlags).

(Heredado de AccessibleObject)
IReflect.GetMembers(BindingFlags)

Obtiene una matriz de objetos MemberInfo correspondientes a todos los miembros públicos o a todos los miembros de la clase actual. Para obtener una descripción de este miembro, vea GetMembers(BindingFlags).

(Heredado de AccessibleObject)
IReflect.GetMethod(String, BindingFlags)

Obtiene un objeto MethodInfo correspondiente a un método especificado con unas restricciones de búsqueda especificadas. Para obtener una descripción de este miembro, vea GetMethod(String, BindingFlags).

(Heredado de AccessibleObject)
IReflect.GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])

Obtiene un objeto MethodInfo correspondiente a un método especificado, utilizando una matriz Type para elegir entre varios métodos sobrecargados. Para obtener una descripción de este miembro, vea GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[]).

(Heredado de AccessibleObject)
IReflect.GetMethods(BindingFlags)

Obtiene una matriz de objetos MethodInfo con todos los métodos públicos o todos los métodos de la clase actual. Para obtener una descripción de este miembro, vea GetMethods(BindingFlags).

(Heredado de AccessibleObject)
IReflect.GetProperties(BindingFlags)

Obtiene una matriz de objetos PropertyInfo correspondientes a todas las propiedades públicas o a todas las propiedades de la clase actual. Para obtener una descripción de este miembro, vea GetProperties(BindingFlags).

(Heredado de AccessibleObject)
IReflect.GetProperty(String, BindingFlags)

Obtiene un objeto PropertyInfo correspondiente a una propiedad especificada con unas restricciones de búsqueda especificadas. Para obtener una descripción de este miembro, vea GetProperty(String, BindingFlags).

(Heredado de AccessibleObject)
IReflect.GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])

Obtiene un objeto PropertyInfo correspondiente a una propiedad especificada con unas determinadas restricciones de búsqueda. Para obtener una descripción de este miembro, vea GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[]).

(Heredado de AccessibleObject)
IReflect.InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[])

Invoca el miembro especificado. Para obtener una descripción de este miembro, vea InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]).

(Heredado de AccessibleObject)
IReflect.UnderlyingSystemType

Obtiene el tipo subyacente que representa el objeto IReflect. Para obtener una descripción de este miembro, vea UnderlyingSystemType.

(Heredado de AccessibleObject)

Se aplica a

Consulte también