다음을 통해 공유


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 을 만듭니다. 파생 클래스 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, AccessibleDescriptionAccessibleDefaultActionDescription, 및 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)

명시적 인터페이스 구현

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)

모든 public 멤버나 지정된 이름과 일치하는 이름을 가진 모든 멤버에 해당하는 MemberInfo 개체의 배열을 가져옵니다. 이 멤버에 대한 설명은 GetMember(String, BindingFlags)를 참조하세요.

(다음에서 상속됨 AccessibleObject)
IReflect.GetMembers(BindingFlags)

모든 public 멤버나 현재 클래스의 모든 멤버에 해당하는 MemberInfo 개체의 배열을 가져옵니다. 이 멤버에 대한 설명은 GetMembers(BindingFlags)를 참조하세요.

(다음에서 상속됨 AccessibleObject)
IReflect.GetMethod(String, BindingFlags)

지정된 검색 제약 조건에 지정된 메서드에 해당하는 MethodInfo 개체를 가져옵니다. 이 멤버에 대한 설명은 GetMethod(String, BindingFlags)를 참조하세요.

(다음에서 상속됨 AccessibleObject)
IReflect.GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])

오버로드된 메서드 중에서 선택할 형식 배열을 사용하여 지정된 메서드에 해당하는 MethodInfo 개체를 가져옵니다. 이 멤버에 대한 설명은 GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])를 참조하세요.

(다음에서 상속됨 AccessibleObject)
IReflect.GetMethods(BindingFlags)

모든 public 메서드나 현재 클래스의 모든 메서드가 포함된 MethodInfo 개체의 배열을 가져옵니다. 이 멤버에 대한 설명은 GetMethods(BindingFlags)를 참조하세요.

(다음에서 상속됨 AccessibleObject)
IReflect.GetProperties(BindingFlags)

모든 public 속성이나 현재 클래스의 모든 속성에 해당하는 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)

적용 대상

추가 정보