Control.ControlAccessibleObject Třída

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Poskytuje informace o ovládacím prvku, který může používat aplikace pro usnadnění přístupu.

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

Dědičnost: Object

MarshalByRefObject

AccessibleObject
Control.ControlAccessibleObject

Dědičnost: Object

MarshalByRefObject

StandardOleMarshalObject

AccessibleObject
Control.ControlAccessibleObject

Odvozené: 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

Více…

Atributy: ComVisibleAttribute

Příklady

Následující příklad kódu vytvoří ovládací prvek zaškrtávacího políčka, který je odvozen z CheckBox třídy a vytvoří vlastní Control.ControlAccessibleObject pro odvozenou třídu, která se má použít. Odvozená třída má MyCheckBoxve výchozím nastavení hodnotu Button Appearance, takže se zobrazí jako přepínač. Odvozená Control.ControlAccessibleObject třída , MyCheckBoxControlAccessibleObjectpřepíše tři vlastnosti, aby zohlednily rozdíl ve vzhledu.

#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

Poznámky

model Windows Forms má integrovanou podporu přístupnosti a poskytuje informace o vaší aplikaci, která umožňuje pracovat s klientskými aplikacemi pro usnadnění přístupu. Příklady klientských aplikací pro usnadnění přístupu jsou: nástroje pro zvětšení obrazovky a revidujícím, nástroje pro hlasové zadávání, klávesnice na obrazovce, alternativní vstupní zařízení a nástroje pro vylepšení klávesnice. Někdy budete chtít klientským aplikacím přístupnosti poskytnout další informace. Existují dva způsoby, jak tyto další informace poskytnout. Chcete-li poskytnout omezené informace o přístupnosti pro existující ovládací prvky, nastavte hodnoty ovládacího prvku AccessibleName, AccessibleDescription AccessibleDefaultActionDescriptiona AccessibleRole vlastnosti, které budou hlášeny klientským aplikacím pro usnadnění přístupu. Případně pokud potřebujete, aby ovládací prvek obsahoval více informací o přístupnosti, můžete napsat vlastní třídu odvozenou z tříd AccessibleObject nebo Control.ControlAccessibleObject tříd. Pokud například píšete vlastní ovládací prvek, který není odvozený z běžných ovládacích prvků, nebo vyžadujete takové operace, jako je testování v rámci ovládacího prvku, měli byste vytvořit Control.ControlAccessibleObject pro svůj ovládací prvek voláním CreateAccessibilityInstance metody.

Poznámka

Pokud tuto metodu AccessibleObject.GetChild přepíšete, musíte tuto metodu AccessibleObject.GetChildCount také přepsat. Chcete-li získat nebo nastavit AccessibilityObject vlastnost, musíte přidat odkaz na Accessibility sestavení nainstalované s rozhraním .NET Framework.

Další informace o přístupných objektech najdete v tématu Microsoft Active Accessibility.

Konstruktory

Control.ControlAccessibleObject(Control)

Inicializuje novou instanci Control.ControlAccessibleObject třídy.

Vlastnosti

Bounds	Získá umístění a velikost přístupného objektu. (Zděděno od AccessibleObject)
DefaultAction	Získá řetězec, který popisuje výchozí akci objektu. Ne všechny objekty mají výchozí akci.
Description	Získá popis Control.ControlAccessibleObject.
Handle	Získá nebo nastaví popisovač přístupného objektu.
Help	Získá popis toho, co objekt dělá nebo jak se objekt používá.
KeyboardShortcut	Získá klávesovou zkratku objektu nebo přístupový klíč pro přístupný objekt.
Name	Získá nebo nastaví přístupný název objektu.
Owner	Získá vlastníka přístupného objektu.
Parent	Získá nadřazený objekt s podporou přístupnosti.
Role	Získá roli tohoto přístupného objektu.
State	Získá stav tohoto přístupného objektu. (Zděděno od AccessibleObject)
Value	Získá nebo nastaví hodnotu přístupného objektu. (Zděděno od AccessibleObject)

Metody

CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru používaného ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
DoDefaultAction()	Provede výchozí akci přidruženou k tomuto přístupnému objektu. (Zděděno od AccessibleObject)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetChild(Int32)	Načte přístupné podřízené objekt odpovídající zadanému indexu. (Zděděno od AccessibleObject)
GetChildCount()	Načte počet podřízených položek patřících do přístupného objektu. (Zděděno od AccessibleObject)
GetFocused()	Načte objekt, který má fokus klávesnice. (Zděděno od AccessibleObject)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetHelpTopic(String)	Získá identifikátor tématu nápovědy a cestu k souboru nápovědy přidruženého k tomuto přístupnému objektu.
GetLifetimeService()	Zastaralé. Načte aktuální objekt služby životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetSelected()	Načte aktuálně vybrané podřízené. (Zděděno od AccessibleObject)
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
HitTest(Int32, Int32)	Načte podřízený objekt na zadaných souřadnicích obrazovky. (Zděděno od AccessibleObject)
InitializeLifetimeService()	Zastaralé. Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří kopii aktuálního objektu bez MarshalByRefObject podmět. (Zděděno od MarshalByRefObject)
Navigate(AccessibleNavigation)	Přejde na jiný přístupný objekt. (Zděděno od AccessibleObject)
NotifyClients(AccessibleEvents)	Upozorní klientské aplikace přístupnosti na zadané AccessibleEvents.
NotifyClients(AccessibleEvents, Int32)	Upozorní klientské aplikace přístupnosti zadané pro zadaný AccessibleEvents podřízený ovládací prvek.
NotifyClients(AccessibleEvents, Int32, Int32)	Upozorní klientské aplikace přístupnosti zadané pro zadaný AccessibleEvents podřízený ovládací prvek a poskytne identifikaci AccessibleObject.
RaiseAutomationNotification(AutomationNotificationKind, AutomationNotificationProcessing, String)	Vyvolá událost oznámení automatizace uživatelského rozhraní. (Zděděno od AccessibleObject)
RaiseLiveRegionChanged()	Vyvolá událost automatizace uživatelského rozhraní LiveRegionChanged.
RaiseLiveRegionChanged()	Vyvolá událost automatizace uživatelského rozhraní LiveRegionChanged. (Zděděno od AccessibleObject)
Select(AccessibleSelection)	Upraví výběr nebo přesune fokus klávesnice přístupného objektu. (Zděděno od AccessibleObject)
ToString()	Vrátí řetězec, který představuje aktuální objekt.
UseStdAccessibleObjects(IntPtr)	Přidruží objekt k instanci objektu AccessibleObject na základě popisovače objektu. (Zděděno od AccessibleObject)
UseStdAccessibleObjects(IntPtr, Int32)	Přidruží objekt k instanci AccessibleObject objektu na základě popisovače a ID objektu objektu. (Zděděno od AccessibleObject)

Explicitní implementace rozhraní

IAccessible.accChildCount	Získá počet podřízených rozhraní, která patří k tomuto objektu. Popis tohoto člena naleznete v tématu accChildCount. (Zděděno od AccessibleObject)
IAccessible.accDoDefaultAction(Object)	Provede výchozí akci zadaného objektu. Ne všechny objekty mají výchozí akci. Popis tohoto člena naleznete v tématu accDoDefaultAction(Object). (Zděděno od AccessibleObject)
IAccessible.accFocus	Získá objekt, který má fokus klávesnice. Popis tohoto člena naleznete v tématu accFocus. (Zděděno od AccessibleObject)
IAccessible.accHitTest(Int32, Int32)	Získá podřízený objekt na zadaných souřadnicích obrazovky. Popis tohoto člena naleznete v tématu accHitTest(Int32, Int32). (Zděděno od AccessibleObject)
IAccessible.accLocation(Int32, Int32, Int32, Int32, Object)	Získá aktuální umístění obrazovky objektu. Popis tohoto člena naleznete v tématu accLocation(Int32, Int32, Int32, Int32, Object). (Zděděno od AccessibleObject)
IAccessible.accNavigate(Int32, Object)	Přejde na přístupný objekt vzhledem k aktuálnímu objektu. Popis tohoto člena naleznete v tématu accNavigate(Int32, Object). (Zděděno od AccessibleObject)
IAccessible.accParent	Získá nadřazený přístupný objekt tohoto objektu. Popis tohoto člena naleznete v tématu accParent. (Zděděno od AccessibleObject)
IAccessible.accSelect(Int32, Object)	Upraví výběr nebo přesune fokus klávesnice přístupného objektu. Popis tohoto člena naleznete v tématu accSelect(Int32, Object). (Zděděno od AccessibleObject)
IAccessible.accSelection	Získá vybrané podřízené objekty přístupného objektu. Popis tohoto člena naleznete v tématu accSelection. (Zděděno od AccessibleObject)
IReflect.GetField(String, BindingFlags)	FieldInfo Získá objekt odpovídající zadanému poli a příznaku vazby. Popis tohoto člena naleznete v tématu GetField(String, BindingFlags). (Zděděno od AccessibleObject)
IReflect.GetFields(BindingFlags)	Získá pole FieldInfo objektů odpovídajících všem polím aktuální třídy. Popis tohoto člena naleznete v tématu GetFields(BindingFlags). (Zděděno od AccessibleObject)
IReflect.GetMember(String, BindingFlags)	Získá pole MemberInfo objektů odpovídajících všem veřejným členům nebo všem členům, které odpovídají zadanému názvu. Popis tohoto člena naleznete v tématu GetMember(String, BindingFlags). (Zděděno od AccessibleObject)
IReflect.GetMembers(BindingFlags)	Získá pole MemberInfo objektů odpovídajících všem veřejným členům nebo všem členům aktuální třídy. Popis tohoto člena naleznete v tématu GetMembers(BindingFlags). (Zděděno od AccessibleObject)
IReflect.GetMethod(String, BindingFlags)	MethodInfo Získá objekt odpovídající zadané metodě v rámci zadaných omezení hledání. Popis tohoto člena naleznete v tématu GetMethod(String, BindingFlags). (Zděděno od AccessibleObject)
IReflect.GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])	MethodInfo Získá objekt odpovídající zadané metodě pomocí pole Typ vybrat z přetížených metod. Popis tohoto člena naleznete v tématu GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[]). (Zděděno od AccessibleObject)
IReflect.GetMethods(BindingFlags)	Získá pole MethodInfo objektů se všemi veřejnými metodami nebo všemi metodami aktuální třídy. Popis tohoto člena naleznete v tématu GetMethods(BindingFlags). (Zděděno od AccessibleObject)
IReflect.GetProperties(BindingFlags)	Získá pole PropertyInfo objektů odpovídajících všem veřejným vlastnostem nebo ke všem vlastnostem aktuální třídy. Popis tohoto člena naleznete v tématu GetProperties(BindingFlags). (Zděděno od AccessibleObject)
IReflect.GetProperty(String, BindingFlags)	PropertyInfo Získá objekt odpovídající zadané vlastnosti v rámci zadaných omezení hledání. Popis tohoto člena naleznete v tématu GetProperty(String, BindingFlags). (Zděděno od AccessibleObject)
IReflect.GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])	PropertyInfo Získá objekt odpovídající zadané vlastnosti se zadanými omezeními hledání. Popis tohoto člena naleznete v tématu GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[]). (Zděděno od AccessibleObject)
IReflect.InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[])	Vyvolá zadaný člen. Popis tohoto člena naleznete v tématu InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]). (Zděděno od AccessibleObject)
IReflect.UnderlyingSystemType	Získá základní typ, který představuje IReflect objekt. Popis tohoto člena naleznete v tématu UnderlyingSystemType. (Zděděno od AccessibleObject)

Platí pro