Control.AccessibilityNotifyClients メソッド

[アーティクル]
03/28/2008

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

Protected Sub AccessibilityNotifyClients( _
   ByVal accEvent As AccessibleEvents, _   ByVal childID As Integer _)
[C#]
protected void AccessibilityNotifyClients(AccessibleEventsaccEvent,intchildID);
[C++]
protected: void AccessibilityNotifyClients(AccessibleEventsaccEvent,intchildID);
[JScript]
protected function AccessibilityNotifyClients(
   accEvent : AccessibleEvents,childID : int);

パラメータ

accEvent
ユーザー補助クライアントアプリケーションに通知する AccessibleEvents オブジェクト。
childID
アクセスできるイベントを通知する子 Control 。

解説

ControlAccessibleObject.NotifyClients メソッドは、ユーザー補助クライアントアプリケーションに通知される AccessibleEvents オブジェクトごとに呼び出す必要があります。通常、 NotifyClients メソッドは、プロパティが設定されたとき、またはイベントハンドラの中から呼び出されます。たとえば、 Control.VisibleChanged イベントのイベントハンドラの中から、 NotifyClients メソッドを呼び出し、 AccessibleEvents.Hide を渡す場合があります。

使用例

[Visual Basic, C#, C++] ユーザー補助情報を公開する AccessibleObject クラスおよび Control.ControlAccessibleObject クラスを使用して、ユーザー補助対応のチャートコントロールを作成する方法の例を次に示します。コントロールは、凡例に沿って 2 つの曲線をプロットします。 ControlAccessibleObject から派生された ChartControlAccessibleObject クラスは、チャートコントロールの独自のユーザー補助情報を提供することを目的として、 CreateAccessibilityInstance メソッドで使用します。チャートの凡例は実際の Control ベースのコントロールではなく、チャートコントロールによって描画されるため、組み込みのユーザー補助情報は含まれていません。このため、 ChartControlAccessibleObject クラスは、 GetChild メソッドをオーバーライドして、凡例の各部分のユーザー補助情報を表す CurveLegendAccessibleObject を返します。ユーザー補助対応のアプリケーションでこのコントロールが使用された場合、このコントロールは必要なユーザー補助情報を提供できます。

[Visual Basic, C#, C++] AccessibilityNotifyClients メソッドを呼び出す方法を次のコード例に示します。コード例全体については、 AccessibleObject クラスの概要を参照してください。

 
' 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

[C#] 
// 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);
        }
    }
}

[C++] 
// Gets or sets the location for the curve legend.
__property Point get_Location() {
   return location;
}
__property void set_Location(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);
}

// Gets or sets the Name for the curve legend.
__property String* get_Name() {
   return name;
}
__property void set_Name(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);
   }
}

// Gets or sets the Selected state for the curve legend.
__property bool get_Selected() {
   return selected;
}
__property void set_Selected(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);
   }
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

Control クラス | Control メンバ | System.Windows.Forms 名前空間 | AccessibleEvents | Controls

Control.AccessibilityNotifyClients メソッド

パラメータ

解説

使用例

必要条件

参照

その他のリソース