IRawElementProviderFragment.GetRuntimeId Método

Definição

Namespace:

System.Windows.Automation.Provider

Assembly:

UIAutomationProvider.dll

Recupera o identificador de runtime de um elemento.

public:
 cli::array <int> ^ GetRuntimeId();

public int[] GetRuntimeId ();

abstract member GetRuntimeId : unit -> int[]

Public Function GetRuntimeId () As Integer()

Retornos

Int32[]

O identificador de tempo de execução exclusivo do elemento.

Exemplos

O código de exemplo a seguir mostra uma implementação desse método por um elemento dentro de um fragmento, como um item dentro de uma caixa de listagem. O item tem seu próprio identificador exclusivo dentro dessa instância do fragmento e o AppendRuntimeId valor garante que o identificador retornado pelo método seja exclusivo na árvore de Automação da Interface do Usuário.

/// <summary>
/// Gets the runtime identifier of the UI Automation element.
/// </summary>
/// <remarks>
/// myID is a unique identifier for the item within this instance of the list.
/// </remarks>
public int[] GetRuntimeId()
{
    return new int[] { AutomationInteropProvider.AppendRuntimeId, myID };
}

''' <summary>
''' Gets the runtime identifier of the UI Automation element.
''' </summary>
''' <remarks>
''' myID is a unique identifier for the item within this instance of the list.
''' </remarks>
Public Function GetRuntimeId() As Integer() _
    Implements IRawElementProviderFragment.GetRuntimeId

    Return New Integer() {AutomationInteropProvider.AppendRuntimeId, myID}

End Function 'GetRuntimeId

Comentários

As implementações devem retornar null para um elemento que corresponda a um identificador de janela. Outros elementos devem retornar uma matriz que contenha AppendRuntimeId, seguida por um valor exclusivo dentro do fragmento.

É responsabilidade do provedor garantir a exclusividade dentro do fragmento; por exemplo, cada item em uma lista deve ser numerado individualmente. O mecanismo de Automação da Interface do Usuário garante que o identificador seja exclusivo entre todas as instâncias, traduzindo o AppendRuntimeId valor.

Confira também

• Implementação do provedor de automação da interface do usuário do lado do servidor