IRawElementProviderFragment::Metode GetRuntimeId (uiautomationcore.h)

Mengambil pengidentifikasi runtime suatu elemen.

Sintaks

HRESULT GetRuntimeId(
  [out, retval] SAFEARRAY **pRetVal
);

Parameter

[out, retval] pRetVal

Jenis: SAFEARRAY**

Menerima penunjuk ke pengidentifikasi runtime. Parameter ini diteruskan tanpa diinisialisasi.

Menampilkan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Implementasi harus mengembalikan NULL untuk elemen tingkat atas yang dihosting di jendela. Elemen lain harus mengembalikan array yang berisi UiaAppendRuntimeId (didefinisikan dalam Uiautomationcoreapi.h), diikuti dengan nilai yang unik dalam instans fragmen.

Contoh

Implementasi berikut untuk item daftar mengembalikan pengidentifikasi runtime yang terdiri dari konstanta UiaAppendRuntimeId dan indeks item dalam daftar.

HRESULT STDMETHODCALLTYPE ListItemProvider::GetRuntimeId(SAFEARRAY ** pRetVal)
{
    if (pRetVal == NULL) 
    {
        return E_INVALIDARG;
    }
    
    int rId[] = { UiaAppendRuntimeId, m_itemIndex };
    SAFEARRAY *psa = SafeArrayCreateVector(VT_I4, 0, 2);
    if (psa == NULL)
    {
        return E_OUTOFMEMORY;
    }
    
    for (LONG i = 0; i < 2; i++)
    {
        SafeArrayPutElement(psa, &i, (void*)&(rId[i]));
    }
    
    *pRetVal = psa;
    return S_OK;
}   

Persyaratan

Klien minimum yang didukung	Windows XP [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	uiautomationcore.h (termasuk UIAutomation.h)

Lihat juga

Praktik Terbaik untuk Menggunakan Array Aman

Konseptual

IRawElementProviderFragment

Referensi