Control.ControlAccessibleObject クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
アクセシビリティ アプリケーションで使用できるコントロールに関する情報を提供します。
public: ref class Control::ControlAccessibleObject : System::Windows::Forms::AccessibleObject[System.Runtime.InteropServices.ComVisible(true)]
public class Control.ControlAccessibleObject : System.Windows.Forms.AccessibleObjectpublic class Control.ControlAccessibleObject : System.Windows.Forms.AccessibleObject[<System.Runtime.InteropServices.ComVisible(true)>]
type Control.ControlAccessibleObject = class
inherit AccessibleObjecttype Control.ControlAccessibleObject = class
inherit AccessibleObjectPublic Class Control.ControlAccessibleObject
Inherits AccessibleObject- 継承
- 継承
- 派生
- 属性
例
次のコード例では、クラスから 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 つあります。 既存のコントロールのアクセシビリティ情報を制限するには、アクセシビリティ クライアント アプリケーションに報告されるコントロールのAccessibleName値AccessibleDescriptionAccessibleDefaultActionDescription、プロパティ値、および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) |