IRawElementProviderAdviseEvents.AdviseEventAdded(Int32, Int32[]) Méthode

Définition

Espace de noms:

System.Windows.Automation.Provider

Assembly:

UIAutomationProvider.dll

Notifie le fournisseur UI Automation quand un client UI Automation commence à écouter un événement spécifique, notamment un événement de modification de propriété.

public:
 void AdviseEventAdded(int eventId, cli::array <int> ^ properties);

public void AdviseEventAdded (int eventId, int[] properties);

abstract member AdviseEventAdded : int * int[] -> unit

Public Sub AdviseEventAdded (eventId As Integer, properties As Integer())

Paramètres

eventId

Int32

Identificateur de l’événement ajouté.

properties

Int32[]

Identificateurs des propriétés ajoutées, ou null si le détecteur d’événements ajouté n’écoute pas les événements de propriété.

Exemples

L’exemple suivant ajoute à une liste de modifications de propriété auxquelles vous êtes abonné.

void IRawElementProviderAdviseEvents.AdviseEventAdded(int eventId, 
                                                      int[] properties)
{
    if (eventId == AutomationElement.AutomationPropertyChangedEvent.Id)
    {
        foreach (int i in properties)
        {
            AutomationProperty property = AutomationProperty.LookupById(i);
            // Add to an ArrayList.
            subscribedProperties.Add(property);
        }
    }
}

Sub AdviseEventAdded(ByVal eventId As Integer, ByVal properties() As Integer) _
    Implements IRawElementProviderAdviseEvents.AdviseEventAdded

    If eventId = AutomationElement.AutomationPropertyChangedEvent.Id Then
        For Each i As Integer In properties
            Dim autoProperty As AutomationProperty = AutomationProperty.LookupById(i)
            ' Add to an ArrayList.
            subscribedProperties.Add(autoProperty)
        Next
    End If

End Sub

Remarques

Cette méthode permet au fournisseur de réduire la surcharge en soulevant uniquement les événements qui sont écoutés.

Le eventId peut être comparé au Id d’un AutomationEvent tel que WindowClosedEvent. Vous pouvez également obtenir le à l’aide de AutomationEventLookupById.