Control.ControlAccessibleObject Classe

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Fornisce le informazioni su un controllo che possono essere usate da un'applicazione di accessibilità.

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

Ereditarietà: Object

MarshalByRefObject

AccessibleObject
Control.ControlAccessibleObject

Ereditarietà: Object

MarshalByRefObject

StandardOleMarshalObject

AccessibleObject
Control.ControlAccessibleObject

Derivato: 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

Altro…

Attributi: ComVisibleAttribute

Esempio

Nell'esempio CheckBox di codice seguente viene creato un controllo casella di controllo che deriva dalla classe e viene creato un oggetto personalizzato Control.ControlAccessibleObject per la classe derivata da usare. La classe derivata, MyCheckBox, ha un Appearance valore di Button per impostazione predefinita in modo che venga visualizzata come pulsante di attivazione. La classe derivata Control.ControlAccessibleObject , MyCheckBoxControlAccessibleObject, esegue l'override di tre proprietà per tenere conto della differenza nell'aspetto.

#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

Commenti

Windows Forms supporta l'accessibilità integrata e fornisce informazioni sull'applicazione che consente di usare applicazioni client di accessibilità. Esempi di applicazioni client di accessibilità sono: utilità di ingrandimento dello schermo e revisore, utilità di input vocale, tastiere su schermo, dispositivi di input alternativi e utilità di miglioramento della tastiera. A volte si vogliono fornire informazioni aggiuntive alle applicazioni client di accessibilità. Esistono due modi per fornire queste informazioni aggiuntive. Per fornire informazioni di accessibilità limitate per i controlli esistenti, impostare i valori della AccessibleNameproprietà , AccessibleDescription, AccessibleDefaultActionDescriptione AccessibleRole del controllo, che verranno segnalati alle applicazioni client di accessibilità. In alternativa, se sono necessarie ulteriori informazioni di accessibilità da includere nel controllo, è possibile scrivere la propria classe derivata dalle AccessibleObject classi o Control.ControlAccessibleObject . Ad esempio, se si scrive il proprio controllo che non è derivato dai controlli comuni o si richiedono operazioni come il hit testing all'interno del controllo, è necessario creare un Control.ControlAccessibleObject oggetto per il controllo chiamando il CreateAccessibilityInstance metodo .

Nota

Se si esegue l'override del metodo, è anche necessario eseguire l'override AccessibleObject.GetChild del AccessibleObject.GetChildCount metodo. Per ottenere o impostare la AccessibilityObject proprietà, è necessario aggiungere un riferimento all'assembly Accessibility installato con .NET Framework.

Per altre informazioni sugli oggetti accessibili, vedere Accessibilità attiva Microsoft.

Costruttori

Control.ControlAccessibleObject(Control)

Inizializza una nuova istanza della classe Control.ControlAccessibleObject.

Proprietà

Bounds	Ottiene la posizione e le dimensioni dell'oggetto accessibile. (Ereditato da AccessibleObject)
DefaultAction	Ottiene una stringa che descrive l'azione predefinita dell'oggetto. Non a tutti gli oggetti è associata un'azione predefinita.
Description	Ottiene la descrizione dell'oggetto Control.ControlAccessibleObject.
Handle	Ottiene o imposta l'handle dell'oggetto accessibile.
Help	Ottiene la descrizione della funzione dell'oggetto o delle relative modalità di utilizzo.
KeyboardShortcut	Ottiene il tasto di scelta rapida o il tasto di scelta di un oggetto accessibile.
Name	Ottiene o imposta il nome dell'oggetto accessibile.
Owner	Ottiene il proprietario dell'oggetto accessibile.
Parent	Ottiene l'oggetto padre di un oggetto accessibile.
Role	Ottiene il ruolo di questo oggetto accessibile.
State	Ottiene lo stato di questo oggetto accessibile. (Ereditato da AccessibleObject)
Value	Ottiene o imposta il valore di un oggetto accessibile. (Ereditato da AccessibleObject)

Metodi

CreateObjRef(Type)	Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto. (Ereditato da MarshalByRefObject)
DoDefaultAction()	Esegue l'azione predefinita associata a questo oggetto accessibile. (Ereditato da AccessibleObject)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetChild(Int32)	Recupera l'oggetto figlio accessibile corrispondente all'indice specificato. (Ereditato da AccessibleObject)
GetChildCount()	Recupera il numero di oggetti figlio che appartengono a un oggetto accessibile. (Ereditato da AccessibleObject)
GetFocused()	Recupera l'oggetto con lo stato attivo. (Ereditato da AccessibleObject)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetHelpTopic(String)	Ottiene un identificatore per un argomento della Guida e il percorso del file della Guida associato a questo oggetto accessibile.
GetLifetimeService()	Obsoleta. Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetSelected()	Recupera l'oggetto figlio attualmente selezionato. (Ereditato da AccessibleObject)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
HitTest(Int32, Int32)	Restituisce l'oggetto figlio in corrispondenza delle coordinate dello schermo specificate. (Ereditato da AccessibleObject)
InitializeLifetimeService()	Obsoleta. Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
Navigate(AccessibleNavigation)	Passa a un altro oggetto accessibile. (Ereditato da AccessibleObject)
NotifyClients(AccessibleEvents)	Notifica gli oggetti AccessibleEvents specificati alle applicazioni client con accessibilità.
NotifyClients(AccessibleEvents, Int32)	Notifica alle applicazioni client di accessibilità l'oggetto AccessibleEvents specificato per il controllo figlio specifico.
NotifyClients(AccessibleEvents, Int32, Int32)	Notifica alle applicazioni client con accessibilità l'oggetto AccessibleEvents specificato per il controllo figlio specificato, fornendo l'identificazione di AccessibleObject.
RaiseAutomationNotification(AutomationNotificationKind, AutomationNotificationProcessing, String)	Genera l'evento di notifica di automazione dell'interfaccia utente. (Ereditato da AccessibleObject)
RaiseLiveRegionChanged()	Genera l'evento di automazione interfaccia utente LiveRegionChanged.
RaiseLiveRegionChanged()	Genera l'evento di automazione interfaccia utente LiveRegionChanged. (Ereditato da AccessibleObject)
Select(AccessibleSelection)	Modifica la selezione o sposta lo stato attivo dell'oggetto accessibile. (Ereditato da AccessibleObject)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente.
UseStdAccessibleObjects(IntPtr)	Associa un oggetto a un'istanza di AccessibleObject in base all'handle dell'oggetto. (Ereditato da AccessibleObject)
UseStdAccessibleObjects(IntPtr, Int32)	Associa un oggetto a un'istanza di AccessibleObject in base all'handle e all'ID dell'oggetto. (Ereditato da AccessibleObject)

Implementazioni dell'interfaccia esplicita

IAccessible.accChildCount	Ottiene il numero di interfacce figlio che appartengono all'oggetto corrente. Per una descrizione di questo membro, vedere accChildCount. (Ereditato da AccessibleObject)
IAccessible.accDoDefaultAction(Object)	Esegue l'azione predefinita dell'oggetto specificato. Non a tutti gli oggetti è associata un'azione predefinita. Per una descrizione di questo membro, vedere accDoDefaultAction(Object). (Ereditato da AccessibleObject)
IAccessible.accFocus	Ottiene l'oggetto con lo stato attivo. Per una descrizione di questo membro, vedere accFocus. (Ereditato da AccessibleObject)
IAccessible.accHitTest(Int32, Int32)	Ottiene l'oggetto figlio in corrispondenza delle coordinate dello schermo specificate. Per una descrizione di questo membro, vedere accHitTest(Int32, Int32). (Ereditato da AccessibleObject)
IAccessible.accLocation(Int32, Int32, Int32, Int32, Object)	Ottiene la posizione corrente dell'oggetto. Per una descrizione di questo membro, vedere accLocation(Int32, Int32, Int32, Int32, Object). (Ereditato da AccessibleObject)
IAccessible.accNavigate(Int32, Object)	Si sposta in un oggetto accessibile a partire dall'oggetto corrente. Per una descrizione di questo membro, vedere accNavigate(Int32, Object). (Ereditato da AccessibleObject)
IAccessible.accParent	Ottiene l'oggetto accessibile padre dell'oggetto corrente. Per una descrizione di questo membro, vedere accParent. (Ereditato da AccessibleObject)
IAccessible.accSelect(Int32, Object)	Modifica la selezione o sposta lo stato attivo dell'oggetto accessibile. Per una descrizione di questo membro, vedere accSelect(Int32, Object). (Ereditato da AccessibleObject)
IAccessible.accSelection	Ottiene gli oggetti figlio selezionati di un oggetto accessibile. Per una descrizione di questo membro, vedere accSelection. (Ereditato da AccessibleObject)
IReflect.GetField(String, BindingFlags)	Ottiene l'oggetto FieldInfo corrispondente al campo e al flag di associazione specificati. Per una descrizione di questo membro, vedere GetField(String, BindingFlags). (Ereditato da AccessibleObject)
IReflect.GetFields(BindingFlags)	Ottiene una matrice di oggetti FieldInfo corrispondenti a tutti i campi della classe corrente. Per una descrizione di questo membro, vedere GetFields(BindingFlags). (Ereditato da AccessibleObject)
IReflect.GetMember(String, BindingFlags)	Ottiene una matrice di oggetti MemberInfo corrispondenti a tutti i membri pubblici o a tutti i membri che corrispondono a un nome specificato. Per una descrizione di questo membro, vedere GetMember(String, BindingFlags). (Ereditato da AccessibleObject)
IReflect.GetMembers(BindingFlags)	Ottiene una matrice di oggetti MemberInfo corrispondenti a tutti i membri pubblici o a tutti i membri della classe corrente. Per una descrizione di questo membro, vedere GetMembers(BindingFlags). (Ereditato da AccessibleObject)
IReflect.GetMethod(String, BindingFlags)	Ottiene un oggetto MethodInfo corrispondente a un metodo specificato in base ai vincoli di ricerca specificati. Per una descrizione di questo membro, vedere GetMethod(String, BindingFlags). (Ereditato da AccessibleObject)
IReflect.GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])	Ottiene un oggetto MethodInfo corrispondente a un metodo specificato, utilizzando una matrice Type per scegliere uno dei metodi di overload. Per una descrizione di questo membro, vedere GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[]). (Ereditato da AccessibleObject)
IReflect.GetMethods(BindingFlags)	Ottiene una matrice di oggetti MethodInfo con tutti i metodi pubblici o tutti i metodi della classe corrente. Per una descrizione di questo membro, vedere GetMethods(BindingFlags). (Ereditato da AccessibleObject)
IReflect.GetProperties(BindingFlags)	Ottiene una matrice di oggetti PropertyInfo corrispondenti a tutte le proprietà pubbliche o a tutte le proprietà della classe corrente. Per una descrizione di questo membro, vedere GetProperties(BindingFlags). (Ereditato da AccessibleObject)
IReflect.GetProperty(String, BindingFlags)	Ottiene un oggetto PropertyInfo corrispondente a una determinata proprietà in base ai vincoli di ricerca specificati. Per una descrizione di questo membro, vedere GetProperty(String, BindingFlags). (Ereditato da AccessibleObject)
IReflect.GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])	Ottiene un oggetto PropertyInfo corrispondente a una determinata proprietà in base ai vincoli di ricerca specificati. Per una descrizione di questo membro, vedere GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[]). (Ereditato da AccessibleObject)
IReflect.InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[])	Richiama un membro specificato. Per una descrizione di questo membro, vedere InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]). (Ereditato da AccessibleObject)
IReflect.UnderlyingSystemType	Ottiene il tipo sottostante che rappresenta l'oggetto IReflect. Per una descrizione di questo membro, vedere UnderlyingSystemType. (Ereditato da AccessibleObject)

Si applica a

Prodotto	Versioni
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop	3.0, 3.1, 5, 6, 7

Condividi tramite