Control.AccessibilityNotifyClients メソッド

定義

ユーザー補助クライアント アプリケーションに AccessibleEvents を通知します。Notifies the accessibility client applications of AccessibleEvents.

オーバーロード

AccessibilityNotifyClients(AccessibleEvents, Int32)

指定した子コントロールの指定した AccessibleEvents をユーザー補助クライアント アプリケーションに通知します。Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control.

AccessibilityNotifyClients(AccessibleEvents, Int32, Int32)

指定した子コントロールの指定した AccessibleEvents をユーザー補助クライアント アプリケーションに通知します。Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control .

AccessibilityNotifyClients(AccessibleEvents, Int32)

指定した子コントロールの指定した AccessibleEvents をユーザー補助クライアント アプリケーションに通知します。Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control.

protected public:
 void AccessibilityNotifyClients(System::Windows::Forms::AccessibleEvents accEvent, int childID);
protected:
 void AccessibilityNotifyClients(System::Windows::Forms::AccessibleEvents accEvent, int childID);
protected internal void AccessibilityNotifyClients (System.Windows.Forms.AccessibleEvents accEvent, int childID);
protected void AccessibilityNotifyClients (System.Windows.Forms.AccessibleEvents accEvent, int childID);
member this.AccessibilityNotifyClients : System.Windows.Forms.AccessibleEvents * int -> unit
Protected Friend Sub AccessibilityNotifyClients (accEvent As AccessibleEvents, childID As Integer)
Protected Sub AccessibilityNotifyClients (accEvent As AccessibleEvents, childID As Integer)

パラメーター

accEvent
AccessibleEvents

ユーザー補助クライアント アプリケーションに通知する AccessibleEventsThe AccessibleEvents to notify the accessibility client applications of.

childID
Int32

ユーザー補助対象のイベントを通知する子 ControlThe child Control to notify of the accessible event.

次のコード例は、クラスとクラスを使用してアクセス可能な情報を公開する、アクセシビリティ対応のグラフコントロールを作成する方法を示して 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. コントロールは、凡例と共に2つの曲線をプロットします。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 メソッドをオーバーライドして GetChildCurveLegendAccessibleObject 凡例の各部分のアクセス可能な情報を表すを返します。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.

このコード抜粋は、メソッドの呼び出しを示して AccessibilityNotifyClients います。This code excerpt demonstrates calling the AccessibilityNotifyClients method. 完全なコード例については、クラスの概要を参照してください AccessibleObjectSee the AccessibleObject class overview for the complete code example.

   // Gets or sets the location for the curve legend.
   Point get()
   {
      return location;
   }

   void set( Point value )
   {
      location = value;
      chart->Invalidate();
      
      // Notifies the chart of the location change. This is used for
      // the accessibility information. AccessibleEvents::LocationChange
      // tells the chart the reason for the notification.
      chart->AccessibilityNotifyClients( AccessibleEvents::LocationChange, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID );
   }

}

property String^ Name 
{

   // Gets or sets the Name for the curve legend.
   String^ get()
   {
      return name;
   }

   void set( String^ value )
   {
      if ( name != value )
      {
         name = value;
         chart->Invalidate();
         
         // Notifies the chart of the name change. This is used for
         // the accessibility information. AccessibleEvents::NameChange
         // tells the chart the reason for the notification.
         chart->AccessibilityNotifyClients( AccessibleEvents::NameChange, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID );
      }
   }

}

property bool Selected 
{

   // Gets or sets the Selected state for the curve legend.
   bool get()
   {
      return selected;
   }

   void set( bool value )
   {
      if ( selected != value )
      {
         selected = value;
         chart->Invalidate();
         
         // Notifies the chart of the selection value change. This is used for
         // the accessibility information. The AccessibleEvents value depends upon
         // if the selection is true (AccessibleEvents::SelectionAdd) or
         // false (AccessibleEvents::SelectionRemove).
         chart->AccessibilityNotifyClients( selected ? AccessibleEvents::SelectionAdd : AccessibleEvents::SelectionRemove, (dynamic_cast<CurveLegendAccessibleObject^>(AccessibilityObject))->ID );
      }
   }
    // Gets or sets the location for the curve legend.
    public Point Location
    {   
        get {
            return location;
        }
        set {
            location = value;
            chart.Invalidate();

            // Notifies the chart of the location change. This is used for
            // the accessibility information. AccessibleEvents.LocationChange
            // tells the chart the reason for the notification.

            chart.AccessibilityNotifyClients(AccessibleEvents.LocationChange, 
                ((CurveLegendAccessibleObject)AccessibilityObject).ID);
        }
    }            

    // Gets or sets the Name for the curve legend.
    public string Name
    {   
        get {
            return name;
        }
        set {
            if (name != value) 
            {
                name = value;
                chart.Invalidate();

                // Notifies the chart of the name change. This is used for
                // the accessibility information. AccessibleEvents.NameChange
                // tells the chart the reason for the notification.

                chart.AccessibilityNotifyClients(AccessibleEvents.NameChange, 
                    ((CurveLegendAccessibleObject)AccessibilityObject).ID);
            }
        }
    }

    // Gets or sets the Selected state for the curve legend.
    public bool Selected
    {   
        get {
            return selected;
        }
        set {
            if (selected != value) 
            {
                selected = value;
                chart.Invalidate();

                // Notifies the chart of the selection value change. This is used for
                // the accessibility information. The AccessibleEvents value depends upon
                // if the selection is true (AccessibleEvents.SelectionAdd) or 
                // false (AccessibleEvents.SelectionRemove).
                chart.AccessibilityNotifyClients(
                    selected ? AccessibleEvents.SelectionAdd : AccessibleEvents.SelectionRemove, 
                    ((CurveLegendAccessibleObject)AccessibilityObject).ID);
            }
        }
    }
' Gets or sets the location for the curve legend.            
Public Property Location() As Point
    Get
        Return m_location
    End Get
    Set
        m_location = value
        chart.Invalidate()

        ' Notifies the chart of the location change. This is used for
        ' the accessibility information. AccessibleEvents.LocationChange
        ' tells the chart the reason for the notification.
        chart.ExposeAccessibilityNotifyClients(AccessibleEvents.LocationChange, _
                CType(AccessibilityObject, CurveLegendAccessibleObject).ID)
    End Set
End Property

' Gets or sets the Name for the curve legend.            
Public Property Name() As String
    Get
        Return m_name
    End Get
    Set
        If m_name <> value Then
            m_name = value
            chart.Invalidate()

            ' Notifies the chart of the name change. This is used for
            ' the accessibility information. AccessibleEvents.NameChange
            ' tells the chart the reason for the notification. 
            chart.ExposeAccessibilityNotifyClients(AccessibleEvents.NameChange, _
                    CType(AccessibilityObject, CurveLegendAccessibleObject).ID)
        End If
    End Set
End Property

' Gets or sets the Selected state for the curve legend.            
Public Property Selected() As Boolean
    Get
        Return m_selected
    End Get
    Set
        If m_selected <> value Then
            m_selected = value
            chart.Invalidate()

            ' Notifies the chart of the selection value change. This is used for
            ' the accessibility information. The AccessibleEvents value varies
            ' on whether the selection is true (AccessibleEvents.SelectionAdd) or 
            ' false (AccessibleEvents.SelectionRemove). 
            If m_selected Then
                chart.ExposeAccessibilityNotifyClients(AccessibleEvents.SelectionAdd, _
                        CType(AccessibilityObject, CurveLegendAccessibleObject).ID) 
            Else
                chart.ExposeAccessibilityNotifyClients(AccessibleEvents.SelectionRemove, _
                        CType(AccessibilityObject, CurveLegendAccessibleObject).ID) 
            End If
        End If
    End Set
End Property

注釈

Control.ControlAccessibleObject.NotifyClients AccessibleEvents ユーザー補助クライアントアプリケーションに通知するには、それぞれに対してメソッドを呼び出す必要があります。You must call the Control.ControlAccessibleObject.NotifyClients method for each AccessibleEvents the accessibility client applications are to be notified of. メソッドは、 NotifyClients 通常、プロパティが設定されているとき、またはイベントハンドラー内から呼び出されたときに呼び出されます。The NotifyClients method is typically called when a property is set or from within an event handler. たとえば、メソッドを呼び出して、 NotifyClients AccessibleEvents イベントのイベントハンドラー内からの値を渡すことができ Hide Control.VisibleChanged ます。For example, you might call the NotifyClients method and pass in an AccessibleEvents value of Hide from within the event handler for the Control.VisibleChanged event.

こちらもご覧ください

適用対象

製品 Introduced

AccessibilityNotifyClients(AccessibleEvents, Int32, Int32)

指定した子コントロールの指定した AccessibleEvents をユーザー補助クライアント アプリケーションに通知します。Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control .

protected:
 void AccessibilityNotifyClients(System::Windows::Forms::AccessibleEvents accEvent, int objectID, int childID);
protected void AccessibilityNotifyClients (System.Windows.Forms.AccessibleEvents accEvent, int objectID, int childID);
member this.AccessibilityNotifyClients : System.Windows.Forms.AccessibleEvents * int * int -> unit
Protected Sub AccessibilityNotifyClients (accEvent As AccessibleEvents, objectID As Integer, childID As Integer)

パラメーター

accEvent
AccessibleEvents

ユーザー補助クライアント アプリケーションに通知する AccessibleEventsThe AccessibleEvents to notify the accessibility client applications of.

objectID
Int32

AccessibleObject の識別子です。The identifier of the AccessibleObject.

childID
Int32

ユーザー補助対象のイベントを通知する子 ControlThe child Control to notify of the accessible event.

適用対象

製品 Introduced