Control.ControlAccessibleObject Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origem:

Control.ControlAccessibleObject.cs

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 MyCheckBoxderivada tem um Appearance de Button por padrão para que ela apareça como um botão de alternância. A classe MyCheckBoxControlAccessibleObjectderivada Control.ControlAccessibleObject substitui três propriedades para considerar a diferença de 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

O Windows Forms tem suporte de acessibilidade interno e fornece informações sobre seu aplicativo que permite que ele trabalhe com aplicativos cliente de acessibilidade. Exemplos de aplicativos cliente de acessibilidade são: utilitários de ampliação 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 AccessibleNameAccessibleDescriptionAccessibleDefaultActionDescriptionpropriedade, AccessibleRole e do controle, que serão relatados aos aplicativos cliente de acessibilidade. Como alternativa, se você precisar de mais informações de acessibilidade para ser incluído com seu controle, poderá escrever sua própria classe derivada das classes ou Control.ControlAccessibleObject das AccessibleObject classes. Por exemplo, se você estiver escrevendo seu próprio controle que não é derivado dos controles comuns ou precisar de operações como teste de clique dentro de seu controle, você deverá criar um Control.ControlAccessibleObject 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 Active Accessibility.

Construtores

Nome	Description
Control.ControlAccessibleObject(Control)	Inicializa uma nova instância da classe Control.ControlAccessibleObject.

Propriedades

Nome	Description
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 do 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 chave de atalho de objeto ou a chave de acesso 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 desse objeto acessível.
State	Obtém o estado desse objeto acessível. (Herdado de AccessibleObject)
Value	Obtém ou define o valor de um objeto acessível. (Herdado de AccessibleObject)

Métodos

Nome	Description
DoDefaultAction()	Executa a ação padrão associada a esse objeto acessível. (Herdado de AccessibleObject)
GetChild(Int32)	Recupera o filho acessível correspondente ao índice especificado. (Herdado de AccessibleObject)
GetChildCount()	Recupera o número de filhos pertencentes a um objeto acessível. (Herdado de AccessibleObject)
GetFocused()	Recupera o objeto que tem o foco do teclado. (Herdado de AccessibleObject)
GetHelpTopic(String)	Obtém um identificador para um tópico da Ajuda e o caminho para o arquivo de Ajuda associado a esse objeto acessível.
GetSelected()	Recupera o filho selecionado no momento. (Herdado de AccessibleObject)
HitTest(Int32, Int32)	Recupera o objeto filho nas coordenadas de tela especificadas. (Herdado de AccessibleObject)
Navigate(AccessibleNavigation)	Navega para outro objeto acessível. (Herdado de AccessibleObject)
NotifyClients(AccessibleEvents, Int32, Int32)	Notifica os aplicativos cliente de acessibilidade dos especificados AccessibleEvents para o controle filho especificado, dando a identificação do AccessibleObject.
NotifyClients(AccessibleEvents, Int32)	Notifica os aplicativos cliente de acessibilidade do controle filho especificado AccessibleEvents .
NotifyClients(AccessibleEvents)	Notifica os aplicativos cliente de acessibilidade do especificado AccessibleEvents.
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, Int32)	Associa um objeto a uma instância de um AccessibleObject baseado no identificador e na ID do objeto. (Herdado de AccessibleObject)
UseStdAccessibleObjects(IntPtr)	Associa um objeto a uma instância de um AccessibleObject baseado no identificador do objeto. (Herdado de AccessibleObject)

Implantações explícitas de interface

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

Confira também

• AccessibleObject
• AccessibleName
• AccessibleDescription
• AccessibleDefaultActionDescription
• AccessibleRole