次の方法で共有


Control.ControlAccessibleObject クラス

定義

アクセシビリティ アプリケーションで使用できるコントロールに関する情報を提供します。

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
継承
Control.ControlAccessibleObject
継承
派生
属性

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

#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

注釈

Windows フォームにはアクセシビリティ サポートが組み込まれており、アクセシビリティ クライアント アプリケーションと連携できるようにするアプリケーションに関する情報が提供されます。 アクセシビリティ クライアント アプリケーションの例としては、画面拡大ユーティリティと校閲者ユーティリティ、音声入力ユーティリティ、スクリーン キーボード、代替入力デバイス、キーボード拡張ユーティリティがあります。 アクセシビリティ クライアント アプリケーションに追加情報を提供したい場合があります。 この追加情報を提供する方法は 2 つあります。 既存のコントロールのアクセシビリティ情報を制限するには、アクセシビリティ クライアント アプリケーションに報告されるコントロールのAccessibleNameAccessibleDescriptionAccessibleDefaultActionDescription、プロパティ値、およびAccessibleRoleプロパティ値を設定します。 または、より多くのアクセシビリティ情報をコントロールに含める必要がある場合は、クラスから派生する独自のクラスをAccessibleObjectControl.ControlAccessibleObject記述できます。 たとえば、共通のコントロールから派生していない独自のコントロールを作成する場合や、コントロール内でヒット テストなどの操作が必要な場合は、メソッドを呼び出してコントロール用のコントロールを作成 Control.ControlAccessibleObject する CreateAccessibilityInstance 必要があります。

注意

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

アクセシビリティの高いオブジェクトの詳細については、「 Microsoft Active Accessibility」を参照してください。

コンストラクター

Control.ControlAccessibleObject(Control)

Control.ControlAccessibleObject クラスの新しいインスタンスを初期化します。

プロパティ

Bounds

ユーザー補助オブジェクトの位置とサイズを取得します。

(継承元 AccessibleObject)
DefaultAction

オブジェクトの既定のアクションを説明する文字列を取得します。 既定のアクションがないオブジェクトもあります。

Description

Control.ControlAccessibleObject の説明を取得します。

Handle

ユーザー補助対象のオブジェクトのハンドルを取得または設定します。

Help

オブジェクトの機能または使用方法の説明を取得します。

KeyboardShortcut

ユーザー補助オブジェクトのオブジェクト ショートカット キーまたはアクセス キーを取得します。

Name

ユーザー補助オブジェクトの名前を取得または設定します。

Owner

ユーザー補助対象のオブジェクトの所有者を取得します。

Parent

ユーザー補助オブジェクトの親を取得します。

Role

ユーザー補助オブジェクトのロールを取得します。

State

ユーザー補助オブジェクトの状態を取得します。

(継承元 AccessibleObject)
Value

ユーザー補助オブジェクトの値を取得または設定します。

(継承元 AccessibleObject)

メソッド

CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。

(継承元 MarshalByRefObject)
DoDefaultAction()

ユーザー補助オブジェクトに関連付けられた既定のアクションを実行します。

(継承元 AccessibleObject)
Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetChild(Int32)

指定されたインデックスに対応するアクセス可能な子を取得します。

(継承元 AccessibleObject)
GetChildCount()

ユーザー補助オブジェクトに属する子の数を取得します。

(継承元 AccessibleObject)
GetFocused()

キーボード フォーカスを持つオブジェクトを取得します。

(継承元 AccessibleObject)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetHelpTopic(String)

このユーザー補助オブジェクトに関連付けられたヘルプ トピックの識別子と、ヘルプ ファイルへのパスを取得します。

GetLifetimeService()
互換性のために残されています。

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。

(継承元 MarshalByRefObject)
GetSelected()

現在選択されている子を取得します。

(継承元 AccessibleObject)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
HitTest(Int32, Int32)

指定した画面座標にある子オブジェクトを取得します。

(継承元 AccessibleObject)
InitializeLifetimeService()
互換性のために残されています。

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。

(継承元 MarshalByRefObject)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。

(継承元 MarshalByRefObject)
Navigate(AccessibleNavigation)

他のユーザー補助オブジェクトに移動します。

(継承元 AccessibleObject)
NotifyClients(AccessibleEvents)

ユーザー補助クライアント アプリケーションに、指定した AccessibleEvents を通知します。

NotifyClients(AccessibleEvents, Int32)

指定した子コントロールの指定した AccessibleEvents をユーザー補助クライアント アプリケーションに通知します。

NotifyClients(AccessibleEvents, Int32, Int32)

AccessibleEvents の識別子を指定して、指定した子コントロールの指定した AccessibleObject をユーザー補助クライアント アプリケーションに通知します。

RaiseAutomationNotification(AutomationNotificationKind, AutomationNotificationProcessing, String)

UI オートメーション通知イベントを発生させます。

(継承元 AccessibleObject)
RaiseLiveRegionChanged()

LiveRegionChanged UI オートメーション イベントを発生させます。

RaiseLiveRegionChanged()

LiveRegionChanged UI オートメーション イベントを発生させます。

(継承元 AccessibleObject)
Select(AccessibleSelection)

ユーザー補助オブジェクトの選択項目の修正またはキーボード フォーカスの移動を行います。

(継承元 AccessibleObject)
ToString()

現在のオブジェクトを表す文字列を返します。

UseStdAccessibleObjects(IntPtr)

オブジェクトのハンドルに基づき、オブジェクトを AccessibleObject のインスタンスに関連付けます。

(継承元 AccessibleObject)
UseStdAccessibleObjects(IntPtr, Int32)

オブジェクトのハンドルと ID に基づき、オブジェクトを AccessibleObject のインスタンスに関連付けます。

(継承元 AccessibleObject)

明示的なインターフェイスの実装

IAccessible.accChildCount

このオブジェクトに属する子インターフェイスの数を取得します。 このメンバーの詳細については、「accChildCount」をご覧ください。

(継承元 AccessibleObject)
IAccessible.accDoDefaultAction(Object)

指定したオブジェクトの既定のアクションを実行します。 既定のアクションがないオブジェクトもあります。 このメンバーの詳細については、「accDoDefaultAction(Object)」をご覧ください。

(継承元 AccessibleObject)
IAccessible.accFocus

キーボード フォーカスを持つオブジェクトを取得します。 このメンバーの詳細については、「accFocus」をご覧ください。

(継承元 AccessibleObject)
IAccessible.accHitTest(Int32, Int32)

指定した画面座標にある子オブジェクトを取得します。 このメンバーの詳細については、「accHitTest(Int32, Int32)」をご覧ください。

(継承元 AccessibleObject)
IAccessible.accLocation(Int32, Int32, Int32, Int32, Object)

オブジェクトの現在の画面位置を取得します。 このメンバーの詳細については、「accLocation(Int32, Int32, Int32, Int32, Object)」をご覧ください。

(継承元 AccessibleObject)
IAccessible.accNavigate(Int32, Object)

現在のオブジェクトを基準としてユーザー補助オブジェクトに移動します。 このメンバーの詳細については、「accNavigate(Int32, Object)」をご覧ください。

(継承元 AccessibleObject)
IAccessible.accParent

このオブジェクトの親ユーザー補助オブジェクトを取得します。 このメンバーの詳細については、「accParent」をご覧ください。

(継承元 AccessibleObject)
IAccessible.accSelect(Int32, Object)

ユーザー補助オブジェクトの選択項目の修正またはキーボード フォーカスの移動を行います。 このメンバーの詳細については、「accSelect(Int32, Object)」をご覧ください。

(継承元 AccessibleObject)
IAccessible.accSelection

ユーザー補助オブジェクトの選択された子オブジェクトを取得します。 このメンバーの詳細については、「accSelection」をご覧ください。

(継承元 AccessibleObject)
IReflect.GetField(String, BindingFlags)

指定したフィールドとバインディング フラグに対応する FieldInfo オブジェクトを取得します。 このメンバーの詳細については、「GetField(String, BindingFlags)」をご覧ください。

(継承元 AccessibleObject)
IReflect.GetFields(BindingFlags)

現在のクラスのすべてのフィールドに対応する FieldInfo オブジェクトの配列を取得します。 このメンバーの詳細については、「GetFields(BindingFlags)」をご覧ください。

(継承元 AccessibleObject)
IReflect.GetMember(String, BindingFlags)

すべてのパブリック メンバーまたは指定した名前と一致するすべてのメンバーに対応する MemberInfo オブジェクトの配列を取得します。 このメンバーの詳細については、「GetMember(String, BindingFlags)」をご覧ください。

(継承元 AccessibleObject)
IReflect.GetMembers(BindingFlags)

すべてのパブリック メンバーまたは現在のクラスのすべてのメンバーに対応する MemberInfo オブジェクトの配列を取得します。 このメンバーの詳細については、「GetMembers(BindingFlags)」をご覧ください。

(継承元 AccessibleObject)
IReflect.GetMethod(String, BindingFlags)

指定した検索制約の下で、指定したメソッドに対応する MethodInfo オブジェクトを取得します。 このメンバーの詳細については、「GetMethod(String, BindingFlags)」をご覧ください。

(継承元 AccessibleObject)
IReflect.GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])

オーバーロードされたメソッドの中から選択する Type 配列を使用して、指定したメソッドに対応する MethodInfo オブジェクトを取得します。 このメンバーの詳細については、「GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])」をご覧ください。

(継承元 AccessibleObject)
IReflect.GetMethods(BindingFlags)

すべてのパブリック メソッドまたは現在のクラスのすべてのメソッドの MethodInfo オブジェクトの配列を取得します。 このメンバーの詳細については、「GetMethods(BindingFlags)」をご覧ください。

(継承元 AccessibleObject)
IReflect.GetProperties(BindingFlags)

すべてのパブリック プロパティまたは現在のクラスのすべてのプロパティに対応する PropertyInfo オブジェクトの配列を取得します。 このメンバーの詳細については、「GetProperties(BindingFlags)」をご覧ください。

(継承元 AccessibleObject)
IReflect.GetProperty(String, BindingFlags)

指定した検索制約の下で、指定したプロパティに対応する PropertyInfo オブジェクトを取得します。 このメンバーの詳細については、「GetProperty(String, BindingFlags)」をご覧ください。

(継承元 AccessibleObject)
IReflect.GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])

指定した検索制約で、指定したプロパティに対応する PropertyInfo オブジェクトを取得します。 このメンバーの詳細については、「GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])」をご覧ください。

(継承元 AccessibleObject)
IReflect.InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[])

指定されたメンバーを呼び出します。 このメンバーの詳細については、「InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[])」をご覧ください。

(継承元 AccessibleObject)
IReflect.UnderlyingSystemType

IReflect オブジェクトを表す基になる型を取得します。 このメンバーの詳細については、「UnderlyingSystemType」をご覧ください。

(継承元 AccessibleObject)

適用対象

こちらもご覧ください