Control.ControlAccessibleObject Osztály

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

Control.ControlAccessibleObject.cs

Információt nyújt az akadálymentességi alkalmazások által használható vezérlőkről.

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

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

type Control.ControlAccessibleObject = class
    inherit AccessibleObject

Public Class Control.ControlAccessibleObject
Inherits AccessibleObject

Öröklődés

Object

MarshalByRefObject

StandardOleMarshalObject

AccessibleObject

Control.ControlAccessibleObject

Származtatott

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

Példák

Az alábbi példakód létrehoz egy jelölőnégyzetvezérlőt, amely az CheckBox osztályból származik, és létrehoz egy egyénit Control.ControlAccessibleObject a származtatott osztályhoz. A származtatott osztály MyCheckBoxAppearanceButton alapértelmezés szerint váltógombként jelenik meg. A származtatott Control.ControlAccessibleObject osztály MyCheckBoxControlAccessibleObjecthárom tulajdonságot felülbírál, hogy figyelembe vegyék a különbséget a megjelenésben.

#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

Megjegyzések

Windows Forms beépített akadálymentességi támogatással rendelkezik, és információt nyújt az alkalmazásról, amely lehetővé teszi az akadálymentességi ügyfélalkalmazások használatát. Az akadálymentességi ügyfélalkalmazások például a következők: képernyőnagyító és véleményező segédprogramok, hangbemeneti segédprogramok, képernyő-billentyűzetek, alternatív beviteli eszközök és billentyűzetjavító segédprogramok. Előfordulhat, hogy további információkat szeretne nyújtani az akadálymentességi ügyfélalkalmazásokról. Ezt a további információt kétféleképpen lehet megadni. Ha korlátozott akadálymentességi információkat szeretne biztosítani a meglévő vezérlőkhöz, állítsa be a vezérlő AccessibleName, AccessibleDescription, AccessibleDefaultActionDescription, és AccessibleRole tulajdonságértékeket, amelyeket az akadálymentességi ügyfélalkalmazások fognak jelenteni. Másik lehetőségként, ha további akadálymentességi információkra van szüksége a vezérlőhöz, saját osztályt írhat az osztályból vagy AccessibleObject osztályokbólControl.ControlAccessibleObject. Ha például olyan saját vezérlőt ír, amely nem a közös vezérlőkből származik, vagy olyan műveleteket igényel, mint a vezérlőn belüli tesztelés, a metódus meghívásával Control.ControlAccessibleObject létre kell hoznia egy CreateAccessibilityInstance vezérlőt.

Note

Ha felülbírálja a metódust AccessibleObject.GetChild , a metódust AccessibleObject.GetChildCount is felül kell bírálnia. A AccessibilityObject tulajdonság lekéréséhez vagy beállításához hozzá kell adnia egy hivatkozást a .NET-keretrendszerrel telepített Accessibility szerelvényhez.

Az akadálymentes objektumokkal kapcsolatos további információkért lásd: Microsoft Active Accessibility.

Konstruktorok

Name	Description
Control.ControlAccessibleObject(Control)	Inicializálja a Control.ControlAccessibleObject osztály új példányát.

Tulajdonságok

Name	Description
Bounds	Lekéri az akadálymentes objektum helyét és méretét. (Öröklődés forrása AccessibleObject)
DefaultAction	Lekéri az objektum alapértelmezett műveletét leíró sztringet. Nem minden objektum rendelkezik alapértelmezett műveletekkel.
Description	Lekéri a leírást a Control.ControlAccessibleObject.
Handle	Lekéri vagy beállítja az akadálymentes objektum fogópontját.
Help	Lekéri az objektum működésének vagy az objektum felhasználási módjának leírását.
KeyboardShortcut	Lekéri az objektum billentyűparancsát vagy hozzáférési kulcsát egy akadálymentes objektumhoz.
Name	Lekéri vagy beállítja az akadálymentes objektum nevét.
Owner	Lekéri az akadálymentes objektum tulajdonosát.
Parent	Lekéri egy akadálymentes objektum szülőját.
Role	Lekéri ennek az akadálymentes objektumnak a szerepét.
State	Lekéri ennek az akadálymentes objektumnak az állapotát. (Öröklődés forrása AccessibleObject)
Value	Lekéri vagy beállítja egy akadálymentes objektum értékét. (Öröklődés forrása AccessibleObject)

Metódusok

Name	Description
DoDefaultAction()	Végrehajtja az akadálymentes objektumhoz társított alapértelmezett műveletet. (Öröklődés forrása AccessibleObject)
GetChild(Int32)	A megadott indexnek megfelelő akadálymentes gyermek lekérése. (Öröklődés forrása AccessibleObject)
GetChildCount()	Lekéri az akadálymentes objektumhoz tartozó gyermekek számát. (Öröklődés forrása AccessibleObject)
GetFocused()	Lekéri a billentyűzetfókuszú objektumot. (Öröklődés forrása AccessibleObject)
GetHelpTopic(String)	Lekéri egy súgótémakör azonosítóját és az akadálymentes objektumhoz társított súgófájl elérési útját.
GetSelected()	Lekéri a jelenleg kijelölt gyermeket. (Öröklődés forrása AccessibleObject)
HitTest(Int32, Int32)	Lekéri a gyermekobjektumot a megadott képernyőkoordinátákon. (Öröklődés forrása AccessibleObject)
Navigate(AccessibleNavigation)	Egy másik akadálymentes objektumra navigál. (Öröklődés forrása AccessibleObject)
NotifyClients(AccessibleEvents, Int32, Int32)	Értesíti a megadott gyermekvezérléshez megadott AccessibleEvents akadálymentességi ügyfélalkalmazásokat, és megadja a AccessibleObject.
NotifyClients(AccessibleEvents, Int32)	Értesíti a megadott gyermekvezérlőhöz megadott AccessibleEvents akadálymentességi ügyfélalkalmazásokat.
NotifyClients(AccessibleEvents)	Értesíti a megadott AccessibleEventskisegítő ügyfélalkalmazásokat.
RaiseAutomationNotification(AutomationNotificationKind, AutomationNotificationProcessing, String)	A felhasználói felület automatizálási értesítési eseményének növelése. (Öröklődés forrása AccessibleObject)
RaiseLiveRegionChanged()	A LiveRegionChanged felhasználói felület automatizálási eseményének létrehozása.
Select(AccessibleSelection)	Módosítja a kijelölést, vagy áthelyezi az akadálymentes objektum billentyűzetfókuszát. (Öröklődés forrása AccessibleObject)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza.
UseStdAccessibleObjects(IntPtr, Int32)	Társít egy objektumot egy AccessibleObject példányhoz az objektum leírója és objektumazonosítója alapján. (Öröklődés forrása AccessibleObject)
UseStdAccessibleObjects(IntPtr)	Objektumot társít egy AccessibleObject példányhoz az objektum leírója alapján. (Öröklődés forrása AccessibleObject)

Explicit interfész-implementációk

Name	Description
IAccessible.accChildCount	Lekéri az objektumhoz tartozó gyermekillesztők számát. Ennek a tagnak a leírását lásd accChildCount: . (Öröklődés forrása AccessibleObject)
IAccessible.accDoDefaultAction(Object)	Végrehajtja a megadott objektum alapértelmezett műveletét. Nem minden objektum rendelkezik alapértelmezett műveletekkel. Ennek a tagnak a leírását lásd accDoDefaultAction(Object): . (Öröklődés forrása AccessibleObject)
IAccessible.accFocus	Lekéri a billentyűzetfókuszt tartalmazó objektumot. Ennek a tagnak a leírását lásd accFocus: . (Öröklődés forrása AccessibleObject)
IAccessible.accHitTest(Int32, Int32)	Lekéri a gyermekobjektumot a megadott képernyőkoordinátákon. Ennek a tagnak a leírását lásd accHitTest(Int32, Int32): . (Öröklődés forrása AccessibleObject)
IAccessible.accLocation(Int32, Int32, Int32, Int32, Object)	Lekéri az objektum aktuális képernyőhelyét. Ennek a tagnak a leírását lásd accLocation(Int32, Int32, Int32, Int32, Object): . (Öröklődés forrása AccessibleObject)
IAccessible.accNavigate(Int32, Object)	Az aktuális objektumhoz képest egy akadálymentes objektumra navigál. Ennek a tagnak a leírását lásd accNavigate(Int32, Object): . (Öröklődés forrása AccessibleObject)
IAccessible.accParent	Lekéri az objektum szülő számára elérhető objektumát. Ennek a tagnak a leírását lásd accParent: . (Öröklődés forrása AccessibleObject)
IAccessible.accSelect(Int32, Object)	Módosítja a kijelölést, vagy áthelyezi az akadálymentes objektum billentyűzetfókuszát. Ennek a tagnak a leírását lásd accSelect(Int32, Object): . (Öröklődés forrása AccessibleObject)
IAccessible.accSelection	Lekéri egy akadálymentes objektum kijelölt gyermekobjektumait. Ennek a tagnak a leírását lásd accSelection: . (Öröklődés forrása AccessibleObject)
IReflect.GetField(String, BindingFlags)	Lekéri a FieldInfo megadott mezőnek és kötésjelzőnek megfelelő objektumot. Ennek a tagnak a leírását lásd GetField(String, BindingFlags): . (Öröklődés forrása AccessibleObject)
IReflect.GetFields(BindingFlags)	Az aktuális osztály összes mezőjének megfelelő objektumtömböt FieldInfo kap. Ennek a tagnak a leírását lásd GetFields(BindingFlags): . (Öröklődés forrása AccessibleObject)
IReflect.GetMember(String, BindingFlags)	Lekéri az MemberInfo összes nyilvános tagnak vagy a megadott névnek megfelelő összes tagnak megfelelő objektumtömböt. Ennek a tagnak a leírását lásd GetMember(String, BindingFlags): . (Öröklődés forrása AccessibleObject)
IReflect.GetMembers(BindingFlags)	Lekéri az MemberInfo összes nyilvános vagy az aktuális osztály összes tagjának megfelelő objektumtömböt. Ennek a tagnak a leírását lásd GetMembers(BindingFlags): . (Öröklődés forrása AccessibleObject)
IReflect.GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])	Lekéri a MethodInfo megadott metódusnak megfelelő objektumot egy Type tömb használatával a túlterhelt metódusok közül való választáshoz. Ennek a tagnak a leírását lásd GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[]): . (Öröklődés forrása AccessibleObject)
IReflect.GetMethod(String, BindingFlags)	Lekéri a MethodInfo megadott metódusnak megfelelő objektumot a megadott keresési korlátozások alatt. Ennek a tagnak a leírását lásd GetMethod(String, BindingFlags): . (Öröklődés forrása AccessibleObject)
IReflect.GetMethods(BindingFlags)	Lekéri az MethodInfo összes nyilvános metódust vagy az aktuális osztály összes metódusát tartalmazó objektumtömböt. Ennek a tagnak a leírását lásd GetMethods(BindingFlags): . (Öröklődés forrása AccessibleObject)
IReflect.GetProperties(BindingFlags)	Lekéri az PropertyInfo összes nyilvános tulajdonságnak vagy az aktuális osztály összes tulajdonságának megfelelő objektumtömböt. Ennek a tagnak a leírását lásd GetProperties(BindingFlags): . (Öröklődés forrása AccessibleObject)
IReflect.GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])	Lekéri a PropertyInfo megadott tulajdonságnak megfelelő objektumot a megadott keresési korlátozásokkal. Ennek a tagnak a leírását lásd GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[]): . (Öröklődés forrása AccessibleObject)
IReflect.GetProperty(String, BindingFlags)	Lekéri a PropertyInfo megadott tulajdonságnak megfelelő objektumot a megadott keresési korlátozások alapján. Ennek a tagnak a leírását lásd GetProperty(String, BindingFlags): . (Öröklődés forrása AccessibleObject)
IReflect.InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[])	Meghív egy megadott tagot. Ennek a tagnak a leírását lásd InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]): . (Öröklődés forrása AccessibleObject)
IReflect.UnderlyingSystemType	Lekéri az objektumot jelképező mögöttes típust IReflect . Ennek a tagnak a leírását lásd UnderlyingSystemType: . (Öröklődés forrása AccessibleObject)

Lásd még

• AccessibleObject
• AccessibleName
• AccessibleDescription
• AccessibleDefaultActionDescription
• AccessibleRole