IRawElementProviderFragment.GetRuntimeId Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recupera o identificador de tempo de execução de um elemento.
public:
cli::array <int> ^ GetRuntimeId();public int[] GetRuntimeId();abstract member GetRuntimeId : unit -> int[]Public Function GetRuntimeId () As Integer()Devoluções
O identificador único em tempo de execução do elemento.
Exemplos
O seguinte exemplo de código mostra uma implementação deste método por um elemento dentro de um fragmento, como um item dentro de uma caixa de lista. O item tem o seu próprio identificador único nesta instância do fragmento, e o valor AppendRuntimeId assegura que o identificador devolvido pelo método é único na árvore Automatização da Interface de Utilizador.
/// <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
Observações
As implementações devem devolver null um elemento que corresponda a um handle de janela. Outros elementos devem devolver um array que contenha AppendRuntimeId, seguido de um valor que seja único dentro do fragmento.
É responsabilidade do fornecedor garantir a unicidade dentro do fragmento; por exemplo, cada item numa lista deve ser numerado individualmente. O motor de Automatização da Interface de Utilizador garante que o identificador é único entre todas as instâncias, traduzindo o valor AppendRuntimeId.