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
Referensi