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 을 만듭니다. 파생 클래스 MyCheckBoxAppearance Button 는 기본적으로 토글 단추로 표시되도록 합니다. 파생 클래스 Control.ControlAccessibleObject MyCheckBoxControlAccessibleObject는 모양 차이를 고려하여 세 가지 속성을 재정의합니다.
#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 Forms는 기본 제공 하는 내게 필요한 옵션 지원 및 접근성 클라이언트 애플리케이션을 사용 하 여 사용할 수 있도록 하는 애플리케이션에 대 한 정보를 제공 합니다. 접근성 클라이언트 애플리케이션의 예로: 키보드, 대체 입력된 디바이스 및 키보드 향상 유틸리티 확대기 및 검토자 유틸리티, 음성 입력된 유틸리티를 화면에 나타나는 화면입니다. 접근성 클라이언트 애플리케이션에 대 한 추가 정보를 제공할 수도 있습니다. 이 추가 정보를 제공 하는 방법은 두 가지가 있습니다. 기존 컨트롤에 대 한 제한 된 내게 필요한 옵션 정보를 제공 하려면 컨트롤의 설정 AccessibleName, AccessibleDescription를 AccessibleDefaultActionDescription, 및 AccessibleRole 접근성 클라이언트 애플리케이션에 보고 되는 속성 값입니다. 또는 컨트롤에 더 많은 접근성 정보를 포함해야 하는 경우 또는 Control.ControlAccessibleObject 클래스에서 AccessibleObject 파생되는 고유한 클래스를 작성할 수 있습니다. 예를 들어 공통 컨트롤에서 파생되지 않은 고유한 컨트롤을 작성하거나 컨트롤 내에서 적중 테스트와 같은 작업이 필요한 경우 메서드를 Control.ControlAccessibleObject 호출 CreateAccessibilityInstance 하여 컨트롤에 대한 컨트롤을 만들어야 합니다.
참고
메서드를 재정의하는 AccessibleObject.GetChild 경우 메서드도 재정의 AccessibleObject.GetChildCount 해야 합니다. 가져오거나 설정 합니다 AccessibilityObject 속성에 대 한 참조를 추가 해야 합니다는 Accessibility .NET Framework를 사용 하 여 설치 된 어셈블리입니다.
액세스 가능한 개체에 대한 자세한 내용은 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의 ID를 제공하여 지정된 자식 컨트롤에 대해 지정된 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) |