Control.ControlAccessibleObject Klasa

Definicja

public: ref class Control::ControlAccessibleObject : System::Windows::Forms::AccessibleObject

public class Control.ControlAccessibleObject : System.Windows.Forms.AccessibleObject

[System.Runtime.InteropServices.ComVisible(true)]
public class Control.ControlAccessibleObject : System.Windows.Forms.AccessibleObject

type Control.ControlAccessibleObject = class
    inherit AccessibleObject

[<System.Runtime.InteropServices.ComVisible(true)>]
type Control.ControlAccessibleObject = class
    inherit AccessibleObject

Public Class Control.ControlAccessibleObject
Inherits AccessibleObject

Dziedziczenie

Object

MarshalByRefObject

StandardOleMarshalObject

AccessibleObject

Control.ControlAccessibleObject

Dziedziczenie

Object

MarshalByRefObject

AccessibleObject

Control.ControlAccessibleObject

Pochodne

System.Windows.Forms.ButtonBase.ButtonBaseAccessibleObject

System.Windows.Forms.DataGridView.DataGridViewAccessibleObject

System.Windows.Forms.DateTimePicker.DateTimePickerAccessibleObject

System.Windows.Forms.DomainUpDown.DomainUpDownAccessibleObject

System.Windows.Forms.RadioButton.RadioButtonAccessibleObject

System.Windows.Forms.ToolStrip.ToolStripAccessibleObject

System.Windows.Forms.ToolStripControlHost.ToolStripHostedControlAccessibleObject

System.Workflow.ComponentModel.Design.WorkflowViewAccessibleObject

Atrybuty

ComVisibleAttribute

Przykłady

Poniższy przykład kodu tworzy formant pola wyboru, który pochodzi z CheckBox klasy i tworzy niestandardowe Control.ControlAccessibleObject dla klasy pochodnej.The following code example creates a check box control that derives from the CheckBox class and creates a custom Control.ControlAccessibleObject for the derived class to use. Klasa pochodna, MyCheckBox , ma domyślnie, jest Appearance Button wyświetlana jako przycisk przełączania.The derived class, MyCheckBox, has an Appearance of Button by default so it appears as a toggle button. Klasa pochodna, Control.ControlAccessibleObject MyCheckBoxControlAccessibleObject , przesłania trzy właściwości do konta w celu uzyskania różnicy w wyglądzie.The derived Control.ControlAccessibleObject class, MyCheckBoxControlAccessibleObject, overrides three properties to account for the difference in appearance.

#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

Uwagi

Windows Forms ma wbudowaną obsługę ułatwień dostępu i zawiera informacje na temat aplikacji, która umożliwia korzystanie z aplikacji klienckich do ułatwienia dostępu.Windows Forms has accessibility support built in, and provides information about your application that enables it to work with accessibility client applications. Przykładami aplikacji klienckich dostępności są: rozszerzanie ekranu i narzędzia do przeglądania, narzędzia do wprowadzania głosu, klawiatury ekranowe, alternatywne urządzenia wejściowe i narzędzia do ulepszania klawiaturowego.Examples of accessibility client applications are: screen enlarger and reviewer utilities, voice input utilities, on-screen keyboards, alternative input devices, and keyboard enhancement utilities. Czasami konieczne będzie podanie dodatkowych informacji na temat aplikacji klienckich do ułatwienia dostępu.Sometimes you will want to provide additional information to accessibility client applications. Istnieją dwa sposoby udostępniania tych dodatkowych informacji.There are two ways of providing this additional information. Aby zapewnić ograniczone informacje o ułatwieniach dostępu dla istniejących formantów, ustaw AccessibleName wartości właściwości kontrolki,, AccessibleDescription AccessibleDefaultActionDescription i AccessibleRole , które będą zgłaszane do aplikacji klienckich dostępności.To provide limited accessibility information for existing controls, set the control's AccessibleName, AccessibleDescription, AccessibleDefaultActionDescription, and AccessibleRole property values, which will be reported to accessibility client applications. Alternatywnie, jeśli potrzebujesz więcej informacji o ułatwieniach dostępu do dołączenia do kontrolki, możesz napisać własną klasę pochodną klasy AccessibleObject lub Control.ControlAccessibleObject .Alternatively, if you require more accessibility information to be included with your control, you can write your own class deriving from the AccessibleObject or Control.ControlAccessibleObject classes. Na przykład, jeśli piszesz własny formant, który nie pochodzi od wspólnych kontrolek lub potrzebujesz takich operacji jak testy trafień w kontrolce, należy utworzyć Control.ControlAccessibleObject dla kontrolki, wywołując CreateAccessibilityInstance metodę.For example, if you are writing your own control that is not derived from the common controls or you require such operations as hit testing within your control, you should create a Control.ControlAccessibleObject for your control by calling the CreateAccessibilityInstance method.

Aby uzyskać więcej informacji na temat dostępnych obiektów, zobacz Microsoft Active Accessibility.For more information about accessible objects, see Microsoft Active Accessibility.

Konstruktory

Właściwości

Metody

Jawne implementacje interfejsu

Dotyczy

Zobacz też

• AccessibleObject
• AccessibleName
• AccessibleDescription
• AccessibleDefaultActionDescription
• AccessibleRole