Control.ControlAccessibleObject Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Fornece informações sobre um controle que pode ser usado por um aplicativo de acessibilidade.

public: ref class Control::ControlAccessibleObject : System::Windows::Forms::AccessibleObject

public class Control.ControlAccessibleObject : System.Windows.Forms.AccessibleObject

type Control.ControlAccessibleObject = class
    inherit AccessibleObject

Public Class Control.ControlAccessibleObject
Inherits AccessibleObject

Herança

Object

MarshalByRefObject

StandardOleMarshalObject

AccessibleObject

Control.ControlAccessibleObject

Derivado

System.Windows.Forms.ButtonBase.ButtonBaseAccessibleObject

System.Windows.Forms.DataGridView.DataGridViewAccessibleObject

System.Windows.Forms.DateTimePicker.DateTimePickerAccessibleObject

System.Windows.Forms.DomainUpDown.DomainUpDownAccessibleObject

System.Windows.Forms.RadioButton.RadioButtonAccessibleObject

System.Windows.Forms.ToolStrip.ToolStripAccessibleObject

System.Windows.Forms.ToolStripControlHost.ToolStripHostedControlAccessibleObject

System.Workflow.ComponentModel.Design.WorkflowViewAccessibleObject

Exemplos

O exemplo de código a seguir cria um controle de caixa de seleção que deriva da CheckBox classe e cria um personalizado Control.ControlAccessibleObject para a classe derivada usar. A classe derivada, MyCheckBox, tem um Appearance de Button por padrão, portanto, ele aparece como um botão de alternância. A classe derivada Control.ControlAccessibleObject , MyCheckBoxControlAccessibleObject, substitui três propriedades para considerar a diferença na aparência.

#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

Comentários

Windows Forms tem suporte de acessibilidade interno e fornece informações sobre seu aplicativo que permite que ele funcione com aplicativos cliente de acessibilidade. Exemplos de aplicativos cliente de acessibilidade são: utilitários de ampliador de tela e revisor, utilitários de entrada de voz, teclados na tela, dispositivos de entrada alternativos e utilitários de aprimoramento de teclado. Às vezes, você desejará fornecer informações adicionais para aplicativos cliente de acessibilidade. Há duas maneiras de fornecer essas informações adicionais. Para fornecer informações de acessibilidade limitadas para controles existentes, defina os valores de propriedade , AccessibleDescriptionAccessibleDefaultActionDescription, e AccessibleRole do AccessibleNamecontrole, que serão relatados aos aplicativos cliente de acessibilidade. Como alternativa, se você precisar que mais informações de acessibilidade sejam incluídas no controle, poderá escrever sua própria classe derivada das AccessibleObject classes ou Control.ControlAccessibleObject . Por exemplo, se você estiver escrevendo seu próprio controle que não é derivado dos controles comuns ou precisar dessas operações como teste de clique em seu controle, crie um Control.ControlAccessibleObject para o controle chamando o CreateAccessibilityInstance método .

Observação

Se você substituir o AccessibleObject.GetChild método , também deverá substituir o AccessibleObject.GetChildCount método . Para obter ou definir a AccessibilityObject propriedade , você deve adicionar uma referência ao Accessibility assembly instalado com o .NET Framework.

Para obter mais informações sobre objetos acessíveis, consulte Microsoft Acessibilidade Ativa.

Construtores

Control.ControlAccessibleObject(Control)

Inicializa uma nova instância da classe Control.ControlAccessibleObject.

Propriedades

Bounds	Obtém o local e o tamanho do objeto acessível. (Herdado de AccessibleObject)
DefaultAction	Obtém uma cadeia de caracteres que descreve a ação padrão do objeto. Nem todos os objetos têm uma ação padrão.
Description	Obtém a descrição da Control.ControlAccessibleObject.
Handle	Obtém ou define o identificador do objeto acessível.
Help	Obtém a descrição do que o objeto faz ou como o objeto é usado.
KeyboardShortcut	Obtém a tecla de atalho ou a chave de acesso do objeto para um objeto acessível.
Name	Obtém ou define o nome do objeto acessível.
Owner	Obtém o proprietário do objeto acessível.
Parent	Obtém o pai de um objeto acessível.
Role	Obtém a função deste objeto acessível.
State	Obtém o estado deste objeto acessível. (Herdado de AccessibleObject)
Value	Obtém ou define o valor de um objeto acessível. (Herdado de AccessibleObject)

Métodos

CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
DoDefaultAction()	Executa a ação padrão associada a este objeto acessível. (Herdado de AccessibleObject)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetChild(Int32)	Recupera o filho acessível correspondente ao índice especificado. (Herdado de AccessibleObject)
GetChildCount()	Recupera o número de filhos que pertencem a um objeto acessível. (Herdado de AccessibleObject)
GetFocused()	Recupera o objeto que tem o foco do teclado. (Herdado de AccessibleObject)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetHelpTopic(String)	Obtém um identificador para um tópico da Ajuda e o caminho para o arquivo de Ajuda associado a este objeto acessível.
GetLifetimeService()	Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetSelected()	Recupera o filho selecionado no momento. (Herdado de AccessibleObject)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
HitTest(Int32, Int32)	Recupera o objeto filho nas coordenadas da tela especificadas. (Herdado de AccessibleObject)
InitializeLifetimeService()	Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
Navigate(AccessibleNavigation)	Navega para outro objeto acessível. (Herdado de AccessibleObject)
NotifyClients(AccessibleEvents)	Notifica os aplicativos cliente de acessibilidade do AccessibleEvents especificado.
NotifyClients(AccessibleEvents, Int32)	Notifica os aplicativos cliente de acessibilidade do AccessibleEvents especificado para o controle filho especificado.
NotifyClients(AccessibleEvents, Int32, Int32)	Notifica os aplicativos cliente de acessibilidade do AccessibleEvents especificado para o controle filho especificado, fornecendo a identificação do AccessibleObject.
RaiseAutomationNotification(AutomationNotificationKind, AutomationNotificationProcessing, String)	Gera o evento de notificação de automação da interface do usuário. (Herdado de AccessibleObject)
RaiseLiveRegionChanged()	Gera o evento de automação da interface do usuário LiveRegionChanged.
Select(AccessibleSelection)	Modifica a seleção ou move o foco do teclado do objeto acessível. (Herdado de AccessibleObject)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual.
UseStdAccessibleObjects(IntPtr)	Associa um objeto a uma instância de um AccessibleObject com base no identificador do objeto. (Herdado de AccessibleObject)
UseStdAccessibleObjects(IntPtr, Int32)	Associa um objeto a uma instância de um AccessibleObject com base no identificador e na ID do objeto. (Herdado de AccessibleObject)

Implantações explícitas de interface

IAccessible.accChildCount	Obtém o número de interfaces filho que pertencem a este objeto. Para obter uma descrição desse membro, confira accChildCount. (Herdado de AccessibleObject)
IAccessible.accDoDefaultAction(Object)	Executa a ação padrão do objeto especificado. Nem todos os objetos têm uma ação padrão. Para obter uma descrição desse membro, confira accDoDefaultAction(Object). (Herdado de AccessibleObject)
IAccessible.accFocus	Obtém o objeto que tem o foco do teclado. Para obter uma descrição desse membro, confira accFocus. (Herdado de AccessibleObject)
IAccessible.accHitTest(Int32, Int32)	Obtém o objeto filho nas coordenadas da tela especificadas. Para obter uma descrição desse membro, confira accHitTest(Int32, Int32). (Herdado de AccessibleObject)
IAccessible.accLocation(Int32, Int32, Int32, Int32, Object)	Obtém o local da tela atual do objeto. Para obter uma descrição desse membro, confira accLocation(Int32, Int32, Int32, Int32, Object). (Herdado de AccessibleObject)
IAccessible.accNavigate(Int32, Object)	Navega para um objeto acessível em relação ao objeto atual. Para obter uma descrição desse membro, confira accNavigate(Int32, Object). (Herdado de AccessibleObject)
IAccessible.accParent	Obtém o objeto acessível pai deste objeto. Para obter uma descrição desse membro, confira accParent. (Herdado de AccessibleObject)
IAccessible.accSelect(Int32, Object)	Modifica a seleção ou move o foco do teclado do objeto acessível. Para obter uma descrição desse membro, confira accSelect(Int32, Object). (Herdado de AccessibleObject)
IAccessible.accSelection	Obtém os objetos filho selecionados de um objeto acessível. Para obter uma descrição desse membro, confira accSelection. (Herdado de AccessibleObject)
IReflect.GetField(String, BindingFlags)	Obtém o objeto FieldInfo correspondente ao campo e ao sinalizador de associação especificados. Para obter uma descrição desse membro, confira GetField(String, BindingFlags). (Herdado de AccessibleObject)
IReflect.GetFields(BindingFlags)	Obtém uma matriz de objetos FieldInfo correspondentes a todos os campos da classe atual. Para obter uma descrição desse membro, confira GetFields(BindingFlags). (Herdado de AccessibleObject)
IReflect.GetMember(String, BindingFlags)	Obtém uma matriz de objetos MemberInfo correspondentes a todos os membros públicos ou a todos os membros que correspondem a um nome especificado. Para obter uma descrição desse membro, confira GetMember(String, BindingFlags). (Herdado de AccessibleObject)
IReflect.GetMembers(BindingFlags)	Obtém uma matriz de objetos MemberInfo correspondentes a todos os membros públicos ou a todos os membros da classe atual. Para obter uma descrição desse membro, confira GetMembers(BindingFlags). (Herdado de AccessibleObject)
IReflect.GetMethod(String, BindingFlags)	Obtém um objeto MethodInfo que corresponde a um método especificado nas restrições de pesquisa especificadas. Para obter uma descrição desse membro, confira GetMethod(String, BindingFlags). (Herdado de AccessibleObject)
IReflect.GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])	Obtém um objeto MethodInfo correspondente a um método especificado, usando uma matriz de Tipo para escolher entre métodos sobrecarregados. Para obter uma descrição desse membro, confira GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[]). (Herdado de AccessibleObject)
IReflect.GetMethods(BindingFlags)	Obtém uma matriz de objetos MethodInfo com todos os métodos públicos ou todos os métodos da classe atual. Para obter uma descrição desse membro, confira GetMethods(BindingFlags). (Herdado de AccessibleObject)
IReflect.GetProperties(BindingFlags)	Obtém uma matriz de objetos PropertyInfo que correspondem a todas as propriedades públicas ou a todas as propriedades da classe atual. Para obter uma descrição desse membro, confira GetProperties(BindingFlags). (Herdado de AccessibleObject)
IReflect.GetProperty(String, BindingFlags)	Obtém um objeto PropertyInfo que corresponde a uma propriedade especificada nas restrições de pesquisa especificadas. Para obter uma descrição desse membro, confira GetProperty(String, BindingFlags). (Herdado de AccessibleObject)
IReflect.GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])	Obtém um objeto PropertyInfo que corresponde a uma propriedade especificada com as restrições de pesquisa especificadas. Para obter uma descrição desse membro, confira GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[]). (Herdado de AccessibleObject)
IReflect.InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[])	Invoca um membro especificado. Para obter uma descrição desse membro, confira InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]). (Herdado de AccessibleObject)
IReflect.UnderlyingSystemType	Obtém o tipo subjacente que representa o objeto IReflect. Para obter uma descrição desse membro, confira UnderlyingSystemType. (Herdado de AccessibleObject)

Confira também

• AccessibleObject
• AccessibleName
• AccessibleDescription
• AccessibleDefaultActionDescription
• AccessibleRole