Control.CreateAccessibilityInstance Метод

Определение

Создает для элемента управления новый объект с поддержкой специальных возможностей.Creates a new accessibility object for the control.

protected:
 virtual System::Windows::Forms::AccessibleObject ^ CreateAccessibilityInstance();
protected virtual System.Windows.Forms.AccessibleObject CreateAccessibilityInstance ();
abstract member CreateAccessibilityInstance : unit -> System.Windows.Forms.AccessibleObject
override this.CreateAccessibilityInstance : unit -> System.Windows.Forms.AccessibleObject
Protected Overridable Function CreateAccessibilityInstance () As AccessibleObject

Возвраты

Новый объект AccessibleObject для элемента управления.A new AccessibleObject for the control.

Примеры

В следующем примере кода показано создание элемента управления диаграммы с поддержкой специальных возможностей с помощью классов AccessibleObject и Control.ControlAccessibleObject для предоставления доступной информации.The following code example demonstrates the creation of an accessibility-aware chart control, using the AccessibleObject and Control.ControlAccessibleObject classes to expose accessible information. Элемент управления отображает две кривые вместе с условными обозначениями.The control plots two curves along with a legend. Класс ChartControlAccessibleObject, который является производным от ControlAccessibleObject, используется в методе CreateAccessibilityInstance для предоставления настраиваемой информации, доступной для элемента управления диаграммы.The ChartControlAccessibleObject class, which derives from ControlAccessibleObject, is used in the CreateAccessibilityInstance method to provide custom accessible information for the chart control. Поскольку условные обозначения диаграммы не являются фактическим элементом управления на основе Control, а нарисованы элементом управления диаграммы, он не содержит встроенных доступных сведений.Since the chart legend is not an actual Control -based control, but instead is drawn by the chart control, it does not any built-in accessible information. В связи с этим класс ChartControlAccessibleObject переопределяет метод GetChild для возврата CurveLegendAccessibleObject, который представляет доступную информацию для каждой части условных обозначений.Because of this, the ChartControlAccessibleObject class overrides the GetChild method to return the CurveLegendAccessibleObject that represents accessible information for each part of the legend. Если приложение, поддерживающее доступ, использует этот элемент управления, элемент управления может предоставить необходимые сведения о специальных возможностях.When an accessible-aware application uses this control, the control can provide the necessary accessible information.

Этот фрагмент кода демонстрирует переопределение метода CreateAccessibilityInstance.This code excerpt demonstrates overriding the CreateAccessibilityInstance method. Полный пример кода см. в обзоре класса AccessibleObject.See the AccessibleObject class overview for the complete code example.

protected:
   // Overridden to return the custom AccessibleObject
   // for the entire chart.
   virtual AccessibleObject^ CreateAccessibilityInstance() override
   {
      return gcnew ChartControlAccessibleObject( this );
   }
// Overridden to return the custom AccessibleObject 
// for the entire chart.
protected override AccessibleObject CreateAccessibilityInstance() 
{            
    return new ChartControlAccessibleObject(this);
}
' Overridden to return the custom AccessibleObject 
' for the entire chart.
Protected Overrides Function CreateAccessibilityInstance() As AccessibleObject
    Return New ChartControlAccessibleObject(Me)
End Function 

Комментарии

Если метод CreateAccessibilityInstance не вызывается явно, он будет вызван при обращении к свойству AccessibilityObject.If you do not explicitly call the CreateAccessibilityInstance method, it will be called when the AccessibilityObject property is referenced.

Примечание

Чтобы получить или задать свойство AccessibilityObject, необходимо добавить ссылку на сборку Accessibility, установленную с .NET Framework.NET Framework.To get or set the AccessibilityObject property, you must add a reference to the Accessibility assembly installed with the .NET Framework.NET Framework.

Примечания для тех, кто наследует этот метод

При переопределении CreateAccessibilityInstance() в производном классе не вызывайте метод CreateAccessibilityInstance() базового класса.When overriding CreateAccessibilityInstance() in a derived class, do not call the base class's CreateAccessibilityInstance() method.

Применяется к

Дополнительно