Control.AccessibilityNotifyClients Método
Definición
Notifica los objetos AccessibleEvents a las aplicaciones cliente de accesibilidad.Notifies the accessibility client applications of AccessibleEvents.
Sobrecargas
AccessibilityNotifyClients(AccessibleEvents, Int32) |
Notifica a las aplicaciones cliente de accesibilidad los objetos AccessibleEvents especificados del control secundario especificado.Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control. |
AccessibilityNotifyClients(AccessibleEvents, Int32, Int32) |
Notifica a las aplicaciones cliente de accesibilidad los objetos AccessibleEvents especificados del control secundario especificado.Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control . |
AccessibilityNotifyClients(AccessibleEvents, Int32)
Notifica a las aplicaciones cliente de accesibilidad los objetos AccessibleEvents especificados del control secundario especificado.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)
Parámetros
- accEvent
- AccessibleEvents
AccessibleEvents del que se va a notificar a las aplicaciones cliente de accesibilidad.The AccessibleEvents to notify the accessibility client applications of.
- childID
- Int32
Control secundario al que se notificará el evento accesible.The child Control to notify of the accessible event.
Ejemplos
En el ejemplo de código siguiente se muestra la creación de un control de gráfico con reconocimiento de accesibilidad mediante las AccessibleObject Control.ControlAccessibleObject clases y para exponer información accesible.The following code example demonstrates the creation of an accessibility-aware chart control, using the AccessibleObject and Control.ControlAccessibleObject classes to expose accessible information. El control traza dos curvas junto con una leyenda.The control plots two curves along with a legend. La ChartControlAccessibleObject
clase, que se deriva de ControlAccessibleObject
, se utiliza en el CreateAccessibilityInstance método para proporcionar información de acceso personalizado para el control Chart.The ChartControlAccessibleObject
class, which derives from ControlAccessibleObject
, is used in the CreateAccessibilityInstance method to provide custom accessible information for the chart control. Dado que la leyenda del gráfico no es un Control control basado en real, sino que se dibuja mediante el control Chart, no es ninguna información accesible integrada.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. Por este motivo, la ChartControlAccessibleObject
clase invalida el GetChild método para devolver el CurveLegendAccessibleObject
que representa información accesible para cada parte de la leyenda.Because of this, the ChartControlAccessibleObject
class overrides the GetChild method to return the CurveLegendAccessibleObject
that represents accessible information for each part of the legend. Cuando una aplicación compatible con acceso utiliza este control, el control puede proporcionar la información accesible necesaria.When an accessible-aware application uses this control, the control can provide the necessary accessible information.
En este fragmento de código se muestra cómo llamar al AccessibilityNotifyClients método.This code excerpt demonstrates calling the AccessibilityNotifyClients method. Vea la AccessibleObject información general de la clase para obtener el ejemplo de código completo.See 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
Comentarios
Debe llamar al Control.ControlAccessibleObject.NotifyClients método para cada AccessibleEvents una de las aplicaciones cliente de accesibilidad a las que se va a notificar.You must call the Control.ControlAccessibleObject.NotifyClients method for each AccessibleEvents the accessibility client applications are to be notified of. NotifyClientsNormalmente, se llama al método cuando se establece una propiedad o desde un controlador de eventos.The NotifyClients method is typically called when a property is set or from within an event handler. Por ejemplo, puede llamar al NotifyClients método y pasar un AccessibleEvents valor de Hide
desde dentro del controlador de eventos para el Control.VisibleChanged evento.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.
Consulte también
Se aplica a
AccessibilityNotifyClients(AccessibleEvents, Int32, Int32)
Notifica a las aplicaciones cliente de accesibilidad los objetos AccessibleEvents especificados del control secundario especificado.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)
Parámetros
- accEvent
- AccessibleEvents
AccessibleEvents del que se va a notificar a las aplicaciones cliente de accesibilidad.The AccessibleEvents to notify the accessibility client applications of.
- objectID
- Int32
Identificador del objeto AccessibleObject.The identifier of the AccessibleObject.
- childID
- Int32
Control secundario al que se notificará el evento accesible.The child Control to notify of the accessible event.