IRawElementProviderFragment.GetRuntimeId 方法

定义

命名空间:

System.Windows.Automation.Provider

程序集:

UIAutomationProvider.dll

检索元素的运行时标识符。

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

public int[] GetRuntimeId ();

abstract member GetRuntimeId : unit -> int[]

Public Function GetRuntimeId () As Integer()

返回

Int32[]

元素的唯一运行时标识符。

示例

以下示例代码通过片段中的元素（如列表框中的项）演示此方法的实现。 项在此片段实例中具有其自己的唯一标识符， AppendRuntimeId 值可确保 方法返回的标识符在 UI 自动化树中是唯一的。

/// <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

注解

实现应 null 返回对应于窗口句柄的元素。 其他元素应返回包含 AppendRuntimeId的数组，后跟片段中唯一的值。

提供商负责确保片段中的唯一性;例如，列表中的每一项都必须单独编号。 UI 自动化引擎通过转换 值来确保标识符在所有实例中都是唯一的 AppendRuntimeId 。

另请参阅

• 服务器端 UI 自动化提供程序实现