Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Protected Friend Sub AccessibilityNotifyClients ( _ accEvent As AccessibleEvents, _ childID As Integer _ )
protected internal void AccessibilityNotifyClients( AccessibleEvents accEvent, int childID )
protected public: void AccessibilityNotifyClients( AccessibleEvents accEvent, int childID )
member AccessibilityNotifyClients : accEvent:AccessibleEvents * childID:int -> unit
Parameters
- accEvent
- Type: System.Windows.Forms.AccessibleEvents
The AccessibleEvents to notify the accessibility client applications of.
- childID
- Type: System.Int32
The child Control to notify of the accessible event.
You must call the Control.ControlAccessibleObject.NotifyClients method for each AccessibleEvents the accessibility client applications are to be notified of. The NotifyClients method is typically called when a property is set or from within an event handler. 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.
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. The ChartControlAccessibleObject class, which derives from ControlAccessibleObject, is used in the CreateAccessibilityInstance method to provide custom accessible information for the chart 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. 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.
This code excerpt demonstrates calling the AccessibilityNotifyClients method. See the AccessibleObject class overview for the complete code example.
' 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
// 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. 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 ); } }
.NET Framework
Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0.NET Framework Client Profile
Supported in: 4, 3.5 SP1Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.