Control.ControlAccessibleObject クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Control.ControlAccessibleObject クラス

ユーザー補助アプリケーションによって使用できるコントロールについての情報を提供します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
Public Class ControlAccessibleObject
    Inherits AccessibleObject

Visual Basic (使用法)

Dim instance As ControlAccessibleObject

[ComVisibleAttribute(true)] 
public class ControlAccessibleObject : AccessibleObject

C++

[ComVisibleAttribute(true)] 
public ref class ControlAccessibleObject :
 public AccessibleObject

/** @attribute ComVisibleAttribute(true) */ 
public class ControlAccessibleObject extends
 AccessibleObject

JScript

ComVisibleAttribute(true) 
public class ControlAccessibleObject extends
 AccessibleObject

解説

Windows フォームにはユーザー補助サポートが組み込まれており、アプリケーションをユーザー補助クライアントアプリケーションと協調して動作させるための、アプリケーションに関する情報が提供されます。ユーザー補助クライアントアプリケーションの例には、画面拡大ユーティリティおよびレビューアユーティリティ、音声入力ユーティリティ、オンスクリーンキーボード、代替入力デバイス、およびキーボード拡張ユーティリティがあります。こうしたユーザー補助クライアントアプリケーションに対して、追加情報を提供する必要が生じる場合があります。この追加情報を提供するには 2 つの方法があります。既存のコントロールの制限付きユーザー補助情報を提供するには、コントロールの AccessibleName、AccessibleDescription、AccessibleDefaultActionDescription、AccessibleRole の各プロパティ値を設定します。これらの値はユーザー補助クライアントアプリケーションに報告されます。また、コントロールにさらに多くのユーザー補助情報を含める必要がある場合は、AccessibleObject クラスまたは Control.ControlAccessibleObject クラスから派生させてユーザー独自のクラスを書き込むことができます。たとえば、共通のコントロールから派生していない独自のコントロールを書き込んでいる場合、または自分のコントロールの中でヒットテストなどの操作が必要な場合は、CreateAccessibilityInstance メソッドを呼び出して、コントロールの Control.ControlAccessibleObject を作成する必要があります。

メモ
AccessibleObject.GetChild メソッドをオーバーライドする場合は、AccessibleObject.GetChildCount メソッドもオーバーライドする必要があります。AccessibilityObject プロパティを取得または設定するには、.NET Framework と一緒にインストールされている Accessibility アセンブリへの参照を追加する必要があります。

アクセス可能なオブジェクトの詳細については、MSDN ライブラリの「Active Accessibility」を参照してください。

使用例

CheckBox クラスから派生したチェックボックスコントロールを作成し、この派生したクラスで使用するカスタムの Control.ControlAccessibleObject を作成するコード例を次に示します。派生クラス MyCheckBox は Button の Appearance を既定で持っているため、これはトグルボタンとして表示されます。派生 Control.ControlAccessibleObject クラス MyCheckBoxControlAccessibleObject は、3 つのプロパティをオーバーライドして、表示の違いを考慮します。

Visual Basic

Imports System
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 Not (accessibleName Is
 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

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;
         }
      }
   }
}

C++

#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
 );
   }
}

package MyCustomControls;
import System.*;
import System.Windows.Forms.*;
import Accessibility.*;
import System.Drawing.*;

public class MyCheckBox extends CheckBox
{
    public MyCheckBox()
    {
        // Make the check box appear like a toggle button.
        this.set_Appearance(get_Appearance().Button);
        // Center the text on the button.
        this.set_TextAlign(ContentAlignment.MiddleCenter);
        // Set the AccessibleDescription text.
        this.set_AccessibleDescription("A toggle style button.");
    } //MyCheckBox

    // Create an instance of the AccessibleObject 
    // defined for the 'MyCheckBox' control
    protected AccessibleObject CreateAccessibilityInstance()
    {
        return new MyCheckBoxAccessibleObject(this);
    } //CreateAccessibilityInstance
} //MyCheckBox

// Accessible object for use with the 'MyCheckBox' control.
class MyCheckBoxAccessibleObject extends Control.ControlAccessibleObject
{
    public MyCheckBoxAccessibleObject(MyCheckBox owner)
    {
         super(owner);
    } //MyCheckBoxAccessibleObject

    /** @property 
     */
    public String get_DefaultAction()
    {
        // Return the DefaultAction based upon 
        // the state of the control.
        if (((MyCheckBox)get_Owner()).get_Checked()) {
            return "Toggle button up";
        }
        else {
            return "Toggle button down";
        }
    } //get_DefaultAction

    /** @property 
     */
    public String get_Name()
    {
        // Return the Text property of the control 
        // if the AccessibleName is null.
        String name = get_Owner().get_AccessibleName();
        if (name != null) {
            return name;
        }
        return ((MyCheckBox)get_Owner()).get_Text();
    } //get_Name

    /** @property 
     */
    public void set_Name(String value)
    {
        super.set_Name(value);
    } //set_Name

    /** @property 
     */
    public AccessibleRole get_Role()
    {
        // Since the check box appears like a button,
        // make the Role the same as a button.
        return AccessibleRole.PushButton;
    } //get_Role
} //MyCheckBoxAccessibleObject

継承階層

System.Object
   System.MarshalByRefObject
     System.Runtime.InteropServices.StandardOleMarshalObject
       System.Windows.Forms.AccessibleObject
        System.Windows.Forms.Control.ControlAccessibleObject
           System.Windows.Forms.ButtonBase.ButtonBaseAccessibleObject
           System.Windows.Forms.DataGridView.DataGridViewAccessibleObject
           System.Windows.Forms.DateTimePicker.DateTimePickerAccessibleObject
           System.Windows.Forms.DomainUpDown.DomainUpDownAccessibleObject
           System.Windows.Forms.ToolStrip.ToolStripAccessibleObject

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Control.ControlAccessibleObject メンバ
System.Windows.Forms 名前空間
AccessibleObject クラス
Control.AccessibleName プロパティ
Control.AccessibleDescription プロパティ
Control.AccessibleDefaultActionDescription プロパティ
Control.AccessibleRole プロパティ

>> 「Control.ControlAccessibleObject クラス」を含む用語の索引
Control.ControlAccessibleObject クラスのページへのリンク

Control.ControlAccessibleObject クラスとは？わかりやすく解説