Control.AccessibilityNotifyClients メソッド

定義

ユーザー補助クライアント アプリケーションに AccessibleEvents を通知します。

オーバーロード

AccessibilityNotifyClients(AccessibleEvents, Int32)

指定した子コントロールの指定した AccessibleEvents をユーザー補助クライアント アプリケーションに通知します。

AccessibilityNotifyClients(AccessibleEvents, Int32, Int32)

指定した子コントロールの指定した AccessibleEvents をユーザー補助クライアント アプリケーションに通知します。

AccessibilityNotifyClients(AccessibleEvents, Int32)

指定した子コントロールの指定した AccessibleEvents をユーザー補助クライアント アプリケーションに通知します。

protected:
 void AccessibilityNotifyClients(System::Windows::Forms::AccessibleEvents accEvent, int childID);
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);
member this.AccessibilityNotifyClients : System.Windows.Forms.AccessibleEvents * int -> unit
Protected Sub AccessibilityNotifyClients (accEvent As AccessibleEvents, childID As Integer)
Protected Friend Sub AccessibilityNotifyClients (accEvent As AccessibleEvents, childID As Integer)

パラメーター

accEvent
AccessibleEvents

ユーザー補助クライアント アプリケーションに通知する AccessibleEvents

childID
Int32

ユーザー補助対象のイベントを通知する子 Control

次のコード例では、 クラスと Control.ControlAccessibleObject クラスを使用してアクセシビリティ対応のグラフ コントロールを作成しAccessibleObject、アクセシビリティ対応の情報を公開する方法を示します。 コントロールは、凡例と共に 2 つの曲線をプロットします。 からControlAccessibleObject派生した クラスはChartControlAccessibleObject、 メソッドでCreateAccessibilityInstance使用され、グラフ コントロールのユーザー設定のアクセス可能な情報を提供します。 グラフの凡例は実際 Control のベースのコントロールではなく、グラフ コントロールによって描画されるため、組み込みのアクセス可能な情報はありません。 このため、 クラスは ChartControlAccessibleObject メソッドを GetChild オーバーライドして、凡例の各部分のアクセス可能な情報を表す を返 CurveLegendAccessibleObject します。 アクセシビリティ対応アプリケーションがこのコントロールを使用する場合、コントロールは必要なアクセス可能な情報を提供できます。

このコードの抜粋は、 メソッドの呼び出しを AccessibilityNotifyClients 示しています。 完全な AccessibleObject コード例については、クラスの概要を参照してください。

   // 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 、 メソッドを呼び出す必要があります。 メソッドは NotifyClients 通常、プロパティが設定されている場合、またはイベント ハンドラー内から呼び出されます。 たとえば、 メソッドを NotifyClients 呼び出し、イベントの AccessibleEvents イベント ハンドラー内から の Hide 値を Control.VisibleChanged 渡すことができます。

こちらもご覧ください

適用対象

AccessibilityNotifyClients(AccessibleEvents, Int32, Int32)

指定した子コントロールの指定した AccessibleEvents をユーザー補助クライアント アプリケーションに通知します。

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

ユーザー補助クライアント アプリケーションに通知する AccessibleEvents

objectID
Int32

AccessibleObject の識別子です。

childID
Int32

ユーザー補助対象のイベントを通知する子 Control

適用対象