Control.AccessibilityNotifyClients メソッド

リファレンス

定義

名前空間:: System.Windows.Forms

アセンブリ:: System.Windows.Forms.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

ユーザー補助クライアントアプリケーションに 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。

適用対象

次の方法で共有

Control.AccessibilityNotifyClients メソッド

定義

オーバーロード

AccessibilityNotifyClients(AccessibleEvents, Int32)

パラメーター

例

注釈

こちらもご覧ください

適用対象

AccessibilityNotifyClients(AccessibleEvents, Int32, Int32)

パラメーター

適用対象

その他のリソース