Como criar controles acessíveis usando o Visual Basic .NET ou Visual Basic 2005

IMPORTANTE: Este artigo foi traduzido por um sistema de tradução automática (também designado por Machine Translation ou MT), não tendo sido portanto traduzido ou revisto por pessoas. A Microsoft possui artigos traduzidos por aplicações (MT) e artigos traduzidos por tradutores profissionais, com o objetivo de oferecer em português a totalidade dos artigos existentes na base de dados de suporte. No entanto, a tradução automática não é sempre perfeita, podendo conter erros de vocabulário, sintaxe ou gramática. A Microsoft não é responsável por incoerências, erros ou prejuízos ocorridos em decorrência da utilização dos artigos MT por parte dos nossos clientes. A Microsoft realiza atualizações freqüentes ao software de tradução automática (MT). Obrigado.

Clique aqui para ver a versão em Inglês deste artigo: 819351
Sumário
Este artigo passo a passo descreve como criar um controle acessível, que é derivado da classe Control.ControlAccessibleObject no Microsoft Visual Basic .NET ou no Microsoft Visual Basic 2005.

back to the top

Requisitos

Este artigo pressupõe que você esteja familiarizado com os seguintes tópicos:
  • Microsoft Visual Basic .NET ou Microsoft Visual Basic 2005
  • Microsoft Active Accessibility
A lista a seguir descreve o hardware recomendado, software, infra-estrutura de rede e service packs que você precisa:
  • Microsoft Windows 2000, Microsoft Windows XP ou Microsoft Windows Server 2003
  • Microsoft Visual Basic .NET ou Microsoft Visual Basic 2005
back to the top

Informações de plano de fundo

Acessibilidade ativa Microsoft é uma tecnologia de desenvolvedor que pode ajudar a melhorar a maneira como programas e sistemas operacionais funcionam com produtos de tecnologia assistencial. Essa tecnologia primeiro foi integrada no sistema operacional Microsoft Windows no Microsoft Windows 98. A Microsoft continua a atualizar essa tecnologia com cada nova versão do Windows.

Microsoft Windows Forms tem acessibilidade ativa interno oferece suporte. Windows Forms fornece informações sobre seu aplicativo que permite que seu aplicativo para trabalhar com produtos de tecnologia assistencial. Você pode usar os seguintes valores de propriedade de um controle para fornecer informações adicionais para produtos de tecnologia assistencial:
  • AccessibleName
  • AccessibleDescription
  • AccessibleDefaultActionDescription
  • AccessibleRole
Como alternativa, se você precisar acessibilidade ativa obter mais informações a serem incluídas com o controle, você pode escrever sua própria classe é derivada da classe AccessibleObject ou da classe Control.ControlAccessibleObject .

A classe Control.ControlAccessibleObject herda da classe AccessibleObject . AccessibleObject permite que você forneça informações sobre um controle para um produto de tecnologia assistencial. Control.ControlAccessibleObject permite que você forneça informações sobre um controle para um produto de tecnologia assistencial, expondo um conjunto de propriedades padrão. Por exemplo, Control.ControlAccessibleObject pode expor a propriedade de função , a propriedade Location e outros. Acessibilidade ativa usa essas propriedades para expor informações para produtos de tecnologia assistencial.

Acessibilidade ativa usa eventos do Windows (WinEvents) para notificar os produtos de tecnologia assistencial das alterações de interface de usuário em um controle, como uma alteração no nome, no estado ou no valor de um elemento de interface do usuário.

Para obter mais informações sobre a arquitetura Microsoft Active Accessibility, visite os seguintes sites:
Microsoft Active Accessibility: arquitetura
http://msdn2.microsoft.com/en-us/library/ms971310.aspx
Arquitetura do Microsoft Active Accessibility: Parte 2
http://msdn2.microsoft.com/en-us/library/ms971352.aspx
back to the top

Criar um controle de exemplo

Para criar um controle CheckBox personalizado ( MyCheckBox ) e para criar uma classe Control.ControlAccessibleObject personalizada ( MyCheckBoxAccessibleObject ) que usa o controle CheckBox personalizado para fornecer informações sobre acessibilidade para aplicativos de acessibilidade ativa, execute essas etapas:
  1. Abra o Microsoft Visual Studio .NET ou Microsoft Visual Studio 2005.
  2. No menu arquivo , clique em novo e, em seguida, clique em Project para exibir a caixa de diálogo New Project .
  3. Na janela Project Type, clique em projetos do Visual Basic .

    Observação No Visual Studio 2005, clique em Visual Basic em Project Types .
  4. Na janela Templates, clique em Windows Control Library .
  5. Na caixa nome , digite MyCheckBox e, em seguida, clique em OK para criar o projeto.
  6. Adicione uma referência para o assembly acessibilidade ativa que é instalado com o Microsoft .NET Framework. Para fazer isso, execute as seguintes etapas:
    1. No menu Project , clique em Adicionar referência .
    2. Na guia .NET , clique duas vezes em Accessibility.dll .
    3. Clique em OK para fechar o Adicionar referência caixa de diálogo.
    Observação A classe AccessibleObject implementa a interface IAccessible . A interface IAccessible é definida pelo assembly acessibilidade ativa. Portanto, você deve adicionar uma referência para o assembly acessibilidade ativa que é instalado com o .NET Framework.
  7. Substituir o conteúdo do UserControl1.vb com o seguinte código:
    Imports SystemImports System.Windows.FormsImports AccessibilityImports System.DrawingNamespace MyCustomControls    Public Class MyCheckBox        Inherits CheckBox        Public Sub New()            ' Make the check box look similar to 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 that is         ' 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(ByVal owner As MyCheckBox)            MyBase.New(owner)        End Sub        Public Overrides ReadOnly Property DefaultAction() As String            Get                ' Return the DefaultAction based on                 ' 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 Not (accessibleName Is Nothing) Then                    Return accessibleName                End If                Return CType(Owner, MyCheckBox).Text            End Get            Set(ByVal Value As String)                MyBase.Name = value            End Set        End Property        Public Overrides ReadOnly Property Role() As AccessibleRole            Get                ' Because the check box looks similar to a button and functions like a button,                ' make the Role the same as a button.                 Return AccessibleRole.PushButton            End Get        End Property    End ClassEnd Namespace
  8. No menu Build , clique em Build Solution para criar o controle.
back to the top

Testar o controle de exemplo

  1. Crie um novo projeto Visual Basic.NET ou Visual Basic 2005 Windows Application no Visual Studio .NET ou no Visual Basic 2005.
  2. No menu Exibir , clique em caixa de ferramentas .
  3. Clique com o botão direito do mouse na caixa de ferramentas.
  4. Se você estiver usando o Microsoft Visual Studio .NET 2002, clique em Customize Toolbox .

    Se você estiver usando o Microsoft Visual Studio .NET 2003, clique em Adicionar/remover itens .

    Se você estiver usando o Microsoft Visual Studio 2005, clique em Choose Items .
  5. Na caixa de diálogo Personalizar caixa de ferramentas , clique na guia .NET Framework Components e, em seguida, clique no botão Procurar para localizar o assembly de controle que você criou na seção "Criar um controle de exemplo" deste artigo.

    Observação O assembly de controle é MyCheckBox.dll no exemplo de código.
  6. Clique em OK para fechar o Customize Toolbox caixa de diálogo.
  7. Adicione o controle MyCheckBox ao formulário.
  8. Adicione um controle Button ao formulário.

    Por padrão, button1 é adicionado ao formulário.

    Adicione o seguinte código no manipulador de evento Click do botão:
    MsgBox("Role: " + MyCheckBox1.AccessibilityObject.Role.ToString() + vbCrLf _       + "Name: " + MyCheckBox1.AccessibilityObject.Name.ToString() + vbCrLf _       + "DefaultAction:" + MyCheckBox1.AccessibilityObject.DefaultAction.ToString())
  9. Pressione a tecla F5 para criar o aplicativo e executar o aplicativo.
  10. Quando o aplicativo for iniciado, pressione button1 no formulário.

    Você receber a seguinte mensagem:
    Função: PushButton
    Nome: MyCheckBox1
    DefaultAction: Botão de alternância dow
back to the top
Referências
O Microsoft Active Accessibility SDK fornece vários utilitários que você pode usar para testar seu aplicativo ou controles acessíveis. Para baixar esses utilitários, visite o seguinte site da Microsoft:back to the top
aacc auxílio usercontrol

Aviso: este artigo foi traduzido automaticamente

Propriedades

ID do Artigo: 819351 - Última Revisão: 12/03/2007 18:50:52 - Revisão: 2.6

Microsoft Visual Basic 2005, Microsoft Visual Basic .NET 2003 Standard Edition, Microsoft Visual Basic .NET 2002 Standard Edition, Microsoft .NET Framework 2.0, Microsoft .NET Framework 1.1, Microsoft .NET Framework 1.0

  • kbmt kbvs2005swept kbvs2005applies kbwindowsforms kbaacc kbhowtomaster kbhowto kbcode KB819351 KbMtpt
Comentários